Monitorare le app

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

  1. Creare una risorsa Application Insights nel portale di Azure e copiarne la stringa di connessione.

  2. Installare Application Insights Web SDK nel progetto.

    npm install @microsoft/applicationinsights-web
    
  3. Inizializzare Application Insights nell'app.

    import { ApplicationInsights } from '@microsoft/applicationinsights-web';
    
    const appInsights = new ApplicationInsights({
      config: {
        connectionString: 'InstrumentationKey=<YOUR_KEY>;IngestionEndpoint=<YOUR_ENDPOINT>',
      },
    });
    appInsights.loadAppInsights();
    
  4. 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);
        },
      },
    });
    
  5. 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-src consente solo l'origine dell'app. Chiedere a un amministratore di aggiungere le origini di inserimento di Application Insights a connect-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.