Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Le app forniscono visibilità su tre livelli:
| Livello | Descrizione |
|---|---|
| Telemetria dell'app | Metriche di runtime dell'app in esecuzione, che inoltri ad Application Insights o a qualsiasi strumento di monitoraggio scelto. |
| Monitoraggio della piattaforma | Crea e distribuisci l'integrità dall'interfaccia della riga di comando, oltre all'analisi dell'utilizzo a livello di tenant e all'integrità operativa nell'interfaccia di amministrazione di Microsoft 365. |
| Telemetria CLI | Dati di utilizzo e diagnostica anonimi dalla ms CLI stessa, che è possibile disattivare. |
Telemetria dell'app
L'SDK di Microsoft Copilot Managed Runtime segnala le metriche di runtime, come le prestazioni di caricamento della sessione e i riepiloghi delle richieste di rete, a un logger fornito. Sei tu a decidere dove vanno queste metriche. Monitoraggio di Azure Application Insights è una scelta comune, ma lo stesso modello funziona per qualsiasi strumento di monitoraggio. La piattaforma fornisce i carichi utili delle metriche; L'implementazione del logger decide come gestirli.
Nota
L'app acquisisce i dati di telemetria solo dopo il caricamento. Gli errori di avvio, ad esempio il blocco del caricamento di un'app, non vengono visualizzati qui. Emergono nel monitoraggio della piattaforma.
Configurare Application Insights
Creare una risorsa Application Insights nel portale di Azure e copiarne la stringa di connessione.
Installare Application Insights Web SDK nel progetto.
npm install @microsoft/applicationinsights-webInizializzare Application Insights nell'app.
import { ApplicationInsights } from '@microsoft/applicationinsights-web'; const appInsights = new ApplicationInsights({ config: { connectionString: 'InstrumentationKey=<YOUR_KEY>;IngestionEndpoint=<YOUR_ENDPOINT>', }, }); appInsights.loadAppInsights();Registrare un logger con Copilot Managed Runtime SDK in modo che la piattaforma inoltri le metriche ad Application Insights. Registralo una volta.
import { setConfig } from '@microsoft/cmr-apps'; import type { Metric } from '@microsoft/cmr-apps'; setConfig({ logger: { logMetric: (value: Metric) => { appInsights.trackEvent({ name: value.type }, value.data); }, }, });Se i criteri di sicurezza contenuto (CSP) vengono applicati nell'ambiente in uso, i criteri predefiniti impediscono la telemetria affinché raggiunga Application Insights, perché
connect-srcconsente solo l'origine dell'app. Chiedere a un amministratore di aggiungere le origini di inserimento di Application Insights aconnect-src. Vedere Configurare i criteri di sicurezza del contenuto per identificare le origini bloccate e aggiornare la direttiva.
Visualizzare i dati
Nella risorsa Application Insights aprire ilogdi monitoraggio> ed eseguire una query sulla customEvents tabella per visualizzare le metriche inviate dall'app. L'SDK segnala le metriche predefinite per il carico della sessione e le richieste di rete ed è possibile registrare gli eventi chiamando le API di Application Insights direttamente nei punti importanti.
Importante
Evitare di registrare dati sensibili o non necessari e seguire sempre le linee guida di conformità dell'organizzazione.
Monitoraggio della piattaforma
Oltre alla telemetria per app, gli amministratori possono vedere tutte le app nel tenant nell'interfaccia di amministrazione di Microsoft 365. Ottengono metriche di integrità operativa con avvisi per rilevare e risolvere i problemi prima che influiscano sugli utenti.
Queste esperienze non richiedono alcuna configurazione da parte dello sviluppatore. Le app vengono visualizzate automaticamente nell'inventario e nel monitoraggio centralizzati.
Informazioni su come aggiungere avvisi per le app
Telemetria CLI
Per impostazione predefinita, l'interfaccia ms della riga di comando invia dati di telemetria anonimi per migliorare il prodotto. Acquisisce i segnali di utilizzo e diagnostica, ad esempio i comandi eseguiti, se hanno esito positivo e i dati sulle prestazioni e sugli errori. Non raccoglie il codice sorgente o i dati dell'app.
Usare i comandi per controllare la ms telemetry raccolta.
Controllare l'impostazione corrente con ms telemetry status:
ms telemetry status
Disattivare la telemetria con ms telemetry disable:
ms telemetry disable
Riattivalo con ms telemetry enable:
ms telemetry enable
Entrambi enable e disable accettano due flag che selezionano a cosa applicarli:
-
--remote: controlla l'invio di dati di telemetria al servizio. Questo flag è quello predefinito quando non viene assegnato alcun flag. -
--console: controlla la stampa degli eventi di telemetria nella console locale, utile per vedere esattamente cosa genererebbe l'interfaccia della riga di comando.
Passa entrambe le bandiere per attivare o disattivare entrambi i bersagli contemporaneamente.
Creare e distribuire dati di telemetria
Ogni build eseguita dalla piattaforma produce un record che è possibile ispezionare dalla CLI. Usa ms app build-status per controllare lo stato e il risultato di una compilazione:
ms app build-status --app <name> --commit <sha>
Se una compilazione non è riuscita, l'output include il motivo, in modo da poter correggere il codice ed eseguire nuovamente il push. Lo stato della build descrive tale build, non quella attualmente attiva, e non esegue un rollback. Una compilazione riuscita non è la prova che il suo commit sia stato distribuito.
Consente di ms app info analizzare lo stato corrente dell'app lato server, incluso il commit distribuito abbreviato in sette caratteri.
Per ripristinare una versione valida nota, usare il comando di distribuzione per la modalità repository dell'app:
-
App con supporto Git: Ridistribuire un commit push noto e valido con
ms app deploy --commit <sha>. Vedere Ripristinare una versione precedente. -
App elemento esterno: Ridistribuire un artefatto di compilazione noto mantenuto con
ms app deploy --artifact <path>. Queste app non supportano--commit. La distribuzione di artefatti esterni richiede l'impostazione dell'ambiente pertinente.