Overvåg apps

Apps giver synlighed på tre niveauer:

Niveau Beskrivelse
Apptelemetri Kørselsmålepunkter fra den kørende app, som du videresender til Application Insights eller et overvågningsværktøj, du vælger.
Overvågning af platforme Opbyg og udrul tilstand fra CLI samt brugsanalyser og driftstilstand for hele lejeren i Microsoft 365 Administration.
CLI-telemetri Anonymiserede brugs- og diagnosticeringsdata fra ms selve CLI, som du kan slå fra.

Apptelemetri

Microsoft Copilot Managed Runtime SDK rapporterer kørselsmålepunkter, f.eks. sessionsbelastningsydeevne og oversigter over netværksanmodninger, til en logger, du angiver. Du bestemmer, hvor disse målepunkter skal placeres. Azure Monitor Application Insights er et almindeligt valg, men det samme mønster fungerer for alle overvågningsværktøjer. Platformen leverer de metriske nyttelaster; Din loggerimplementering bestemmer, hvordan de skal håndteres.

Bemærk!

Appen registrerer kun telemetri, når den er indlæst. Startfejl, f.eks. en app, der er blokeret fra indlæsning, vises ikke her. De vises i platformsovervågning.

Konfigurer Application Insights

  1. Opret en Application Insights-ressource på Azure Portal, og kopiér dens forbindelsesstreng.

  2. Installér Application Insights-web-SDK i dit projekt.

    npm install @microsoft/applicationinsights-web
    
  3. Initialiser Application Insights i din app.

    import { ApplicationInsights } from '@microsoft/applicationinsights-web';
    
    const appInsights = new ApplicationInsights({
      config: {
        connectionString: 'InstrumentationKey=<YOUR_KEY>;IngestionEndpoint=<YOUR_ENDPOINT>',
      },
    });
    appInsights.loadAppInsights();
    
  4. Registrer en logger med Copilot Managed Runtime SDK, så platformen videresender målepunkter til Application Insights. Registrer den én gang.

    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. Hvis sikkerhedspolitik for indhold (CSP) håndhæves i dit miljø, blokerer standardpolitikken telemetri i at nå Application Insights, fordi connect-src den kun tillader din apps egen oprindelse. Få en administrator til at føje Application Insights-indgangsoprindelser til connect-src. Se Konfigurer sikkerhedspolitik for indhold for at identificere de blokerede oprindelser og opdatere direktivet.

Få vist dataene

Åbnovervågningslogfiler> i din Application Insights-ressource, og forespørg i customEvents tabellen for at få vist de målepunkter, din app sender. SDK'et rapporterer indbyggede målepunkter for sessionsbelastning og netværksanmodninger, og du kan logføre dine egne hændelser ved at kalde Application Insights-API'erne direkte på de punkter, der er vigtige for dig.

Vigtigt!

Undgå at logføre følsomme eller unødvendige data, og følg altid organisationens retningslinjer for overholdelse af regler og standarder.

Overvågning af platforme

Ud over telemetri pr. app kan administratorer se alle apps i lejeren i Microsoft 365 Administration. De får målinger af driftstilstand med beskeder for at registrere og løse problemer, før de påvirker brugerne.

Disse oplevelser kræver ingen konfiguration fra udvikleren. Apps vises automatisk i det centraliserede lager og overvågning.

Få mere at vide om, hvordan du tilføjer beskeder for dine apps

CLI-telemetri

ms CLI sender som standard anonymiseret telemetri for at hjælpe med at forbedre produktet. Det registrerer brugs- og diagnosticeringssignaler, f.eks. hvilke kommandoer der køres, om de lykkes, samt ydelses- og fejldata. Den indsamler ikke din kildekode eller din apps data.

Brug kommandoerne til at styre samlingenms telemetry.

Kontrollér den aktuelle indstilling med ms telemetry status:

ms telemetry status

Slå telemetri fra med ms telemetry disable:

ms telemetry disable

Slå den til igen med ms telemetry enable:

ms telemetry enable

Begge enable og disable accepter to flag, der markerer, hvad de gælder for:

  • --remote: Styrer afsendelse af telemetri til tjenesten. Dette flag er standard, når der ikke er angivet et flag.
  • --console: Styrer udskrivning af telemetrihændelser til din lokale konsol, hvilket er nyttigt til at se præcis, hvad CLI ville udsende.

Passere begge flag for at slå begge mål mellem på én gang.

Opbyg og installer telemetri

Hvert build, som platformen kører, producerer en post, du kan inspicere fra CLI. Bruges ms app build-status til at kontrollere status og resultatet af et build:

ms app build-status --app <name> --commit <sha>

Hvis et build mislykkedes, indeholder outputtet årsagen, så du kan rette koden og skubbe igen. Buildstatus beskriver det build, ikke hvad der i øjeblikket er live, og det udfører ikke en annullering af opdatering. Et vellykket build er ikke bevis for, at bekræftelsen er installeret.

Bruges ms app info til at undersøge den aktuelle apptilstand på serversiden, herunder den udrullede bekræftelse forkortet til syv tegn.

Hvis du vil gendanne en kendt fungerende version, skal du bruge udrulningskommandoen til appens lagertilstand:

  • Git-støttet app: Geninstaller en kendt, push-bekræftelse med ms app deploy --commit <sha>. Se Gendan en tidligere version.
  • Ekstern artefaktapp: Genudrul en bevaret kendt fungerende buildartefakt med ms app deploy --artifact <path>. Disse apps understøtter --commitikke. Installation af eksterne artefakter kræver den relevante miljøindstilling.