Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
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
Opret en Application Insights-ressource på Azure Portal, og kopiér dens forbindelsesstreng.
Installér Application Insights-web-SDK i dit projekt.
npm install @microsoft/applicationinsights-webInitialiser 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();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); }, }, });Hvis sikkerhedspolitik for indhold (CSP) håndhæves i dit miljø, blokerer standardpolitikken telemetri i at nå Application Insights, fordi
connect-srcden kun tillader din apps egen oprindelse. Få en administrator til at føje Application Insights-indgangsoprindelser tilconnect-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.