Apps bewaken (preview)

[Dit artikel is voorlopige documentatie en kan worden gewijzigd.]

Apps bieden zichtbaarheid op drie niveaus:

Niveau Beschrijving
App-telemetrie Runtime-statistieken van uw actieve app, die u doorstuurt naar Application Insights of een ander bewakingsprogramma dat u kiest.
Platform monitoring Bouw en implementeer de status vanuit de CLI, plus gebruikersanalyses voor de hele tenant en de operationele status in het Microsoft 365-beheercentrum.
CLI-telemetrie Geanonimiseerde gebruiks- en diagnostische gegevens uit de ms CLI zelf, die je kunt uitschakelen.

App-telemetrie

De Microsoft Copilot Managed Runtime SDK rapporteert runtime-statistieken, zoals prestaties van sessiebelasting en samenvattingen van netwerkaanvragen, aan een logger die u opgeeft. Jij bepaalt waar die statistieken naartoe gaan. Azure Monitor Application Insights is een veelgebruikte keuze, maar hetzelfde patroon werkt voor elk monitoringprogramma. Het platform levert de metrische payloads; De implementatie van uw logger bepaalt hoe ermee om te gaan.

Opmerking

De app legt telemetriegegevens pas vast nadat deze met succes is geladen. Opstartfouten, zoals een app die niet kan worden geladen, worden hier niet weergegeven. Ze komen aan de oppervlakte bij platformbewaking.

Toepassingsinzichten instellen

  1. Maak een Application Insights-resource in de Azure Portal en kopieer de verbindingsreeks.

  2. Installeer de web-SDK Application Insights in uw project.

    npm install @microsoft/applicationinsights-web

  3. Initialiseer Application Insights in uw app.

    import { ApplicationInsights } from '@microsoft/applicationinsights-web';

const appInsights = new ApplicationInsights({
  config: {
    connectionString: 'InstrumentationKey=<YOUR_KEY>;IngestionEndpoint=<YOUR_ENDPOINT>',
  },
});
appInsights.loadAppInsights();

  4. Registreer een logger bij de Copilot Managed Runtime SDK, zodat het platform metrische gegevens doorstuurt naar Application Insights. Registreer het eenmalig.

    import { setConfig } from '@microsoft/managed-apps';
import type { Metric } from '@microsoft/managed-apps';

setConfig({
  logger: {
    logMetric: (value: Metric) => {
      appInsights.trackEvent({ name: value.type }, value.data);
    },
  },
});

  5. Als Content Security Policy (CSP) in uw omgeving wordt afgedwongen, blokkeert het standaardbeleid dat telemetrie toegang heeft tot Application Insights, omdat connect-src alleen de eigen origin van uw app wordt toegestaan. Laat een beheerder de Application Insights-opname-origins toevoegen aan connect-src. Zie Content Security Policy configureren (preview) om de geblokkeerde origins te identificeren en de richtlijn bij te werken.

De gegevens weergeven

Open Monitoring>Logs in uw Application Insights-resource en voer een query in de customEvents tabel uit om de metrische gegevens te zien die door de app worden verzonden. De SDK rapporteert ingebouwde metrische gegevens voor sessiebelasting en netwerkaanvragen, en u kunt uw eigen gebeurtenissen registreren door de Application Insights-API's rechtstreeks aan te roepen op de punten die voor u belangrijk zijn.

Belangrijk

Vermijd het registreren van gevoelige of onnodige gegevens en volg altijd de nalevingsrichtlijnen van uw organisatie.

Platform monitoring

Naast telemetrie per app kunnen beheerders elke app in de tenant zien in het Microsoft 365-beheercentrum. Ze krijgen operationele gezondheidsstatistieken met waarschuwingen om problemen te detecteren en op te lossen voordat ze gevolgen hebben voor gebruikers.

Deze ervaringen vereisen geen installatie van de ontwikkelaar. Apps worden automatisch weergegeven in de centrale inventaris en bewaking.

Meer informatie over het toevoegen van waarschuwingen voor uw apps

CLI-telemetrie

De ms CLI verzendt standaard geanonimiseerde telemetrie om het product te verbeteren. Het registreert gebruiks- en diagnostische signalen, zoals welke opdrachten worden uitgevoerd, of ze slagen, en prestatie- en foutgegevens. Het verzamelt niet uw broncode of de gegevens van uw app.

Gebruik de ms telemetry opdrachten om het verzamelen te beheren.

Controleer de huidige instelling:

ms telemetry status

Telemetrie uitschakelen:

ms telemetry disable

Schakel het weer in:

ms telemetry enable

Beide enable en disable accepteer twee vlaggen waarmee wordt aangegeven waarop ze van toepassing zijn:

  • --remote: hiermee wordt het verzenden van telemetrie naar de service bepaald. Deze vlag is de standaardvlag wanneer er geen vlag wordt gegeven.
  • --console: hiermee bepaal je het afdrukken van telemetriegebeurtenissen naar je lokale console, wat handig is om precies te zien wat de CLI zou uitzenden.

Geef beide vlaggen door om beide doelen tegelijk in of uit te schakelen.

Telemetrie bouwen en implementeren

Elke build die het platform uitvoert, levert een record op die u vanuit de CLI kunt inspecteren. Hiermee kunt ms app build-status u de status en het resultaat van een build controleren:

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

Als een build is mislukt, bevat de uitvoer de reden, zodat u de code kunt herstellen en opnieuw kunt pushen. Omdat elke implementatie wordt ondersteund door een build, kunt u op deze manier ook traceren wat momenteel live is en terugkeren naar een commit waarvan bekend is dat deze goed is.

  • Laatst bijgewerkt om