Inleiding tot Application Insights - Waarneembaarheid van OpenTelemetry

Azure Monitor Application Insights is een APM-functie (Application Performance Monitoring) van Azure Monitor. Voor ondersteunde scenario's kunt u OpenTelemetry (OTel), een leverancierneutraal waarneembaarheidsframework gebruiken om uw toepassingen te instrumenteren en telemetriegegevens te verzamelen en die telemetrie vervolgens te analyseren in Application Insights.

Application Insights-ervaringen

Application Insights ondersteunt OpenTelemetry (OTel) voor het verzamelen van telemetriegegevens in een gestandaardiseerde indeling op verschillende platforms. Integratie met Azure-services maakt efficiënte bewaking en diagnose mogelijk, waardoor de waarneembaarheid en prestaties van toepassingen worden verbeterd.

Onderzoeken

Gebruik deze hulpprogramma's om problemen vast te stellen en inzicht te hebben in het runtimegedrag van uw toepassing.

• Toepassingsdashboard: een overzicht van de status en prestaties van uw toepassing.
• Toepassingsoverzicht: Een visueel overzicht van de interacties van toepassingsarchitectuur en onderdelen.
• Live statistieken: een realtime analysedashboard voor inzicht in de activiteit en prestaties van applicaties.
• Zoekweergave: Transacties traceren en diagnosticeren om problemen te identificeren en prestaties te optimaliseren.
• Beschikbaarheidsweergave: Proactief de beschikbaarheid en reactiesnelheid van toepassingseindpunten bewaken en testen.
• Overzicht van fouten: Identificeer en analyseer fouten in uw applicatie om downtime te minimaliseren.
• Prestatieweergave: Bekijk metrische gegevens over de prestaties van toepassingen en mogelijke knelpunten.
• Details van agenten: een uniforme weergave voor het monitoren van AI-agenten binnen Microsoft Foundry, Copilot Studio en agenten van derden.

Controleren

Gebruik deze hulpprogramma's om de status van uw toepassing continu bij te houden en proactieve meldingen in te stellen.

• Waarschuwingen: Bewaak een breed scala aan aspecten van uw toepassing en activeer verschillende acties.
• Metrische gegevens: duik diep in metrische gegevens om inzicht te hebben in gebruikspatronen en trends.
• Diagnostische instellingen: configureer streaming-export van platformlogboeken en metrische gegevens naar de bestemming van uw keuze.
• Logs: alle gegevens ophalen, samenvoegen en analyseren die zijn verzameld in Azure bewakingslogboeken.
• Werkmappen: maak interactieve rapporten en dashboards waarmee bewakingsgegevens van toepassingen worden gevisualiseerd.
• Dashboards met Grafana: Grafana-dashboards maken, aanpassen en delen voor Application Insights-gegevens rechtstreeks in de Azure-portal.
• SDK-statistieken: visualiseer exportsucces, vervallen aantallen, herhalingsaantallen en dropredenen van Application Insights SDK's en agenten.

Gebruik

Gebruik deze hulpprogramma's om te begrijpen hoe gebruikers met uw toepassing werken.

• Gebruikers, sessies en gebeurtenissen: bepaal wanneer, waar en hoe gebruikers communiceren met uw web-app.
• Trechters: analyseer conversiepercentages om te bepalen waar gebruikers voortgang maken of afhaken in de trechter.
• Stromen: Visualiseer gebruikerspaden op uw site om sterk betrokken gebieden en uitstappunten te identificeren.
• Cohorten: Groepeer gebruikers op gedeelde kenmerken om trendidentificatie, segmentatie en prestatieproblemen te vereenvoudigen.

Codeanalyse

Gebruik deze hulpprogramma's om uw toepassingscode te profilen en fouten op te sporen.

• .NET Profiler: Prestatietraceringen vastleggen, identificeren en weergeven voor uw toepassing.
• Codeoptimalisaties: Maak gebruik van AI om betere en efficiëntere toepassingen te maken.
• Snapshot-foutopsporingsprogramma: Automatisch foutopsporingsmomentopnamen verzamelen wanneer er uitzonderingen optreden in .NET toepassing

Logisch model

Het logische modeldiagram visualiseert onderdelen van Application Insights en hoe ze communiceren.

Notitie

Firewallinstellingen moeten worden aangepast zodat gegevens de opname-eindpunten kunnen bereiken. Zie Azure Monitor-eindpunttoegang en firewallconfiguratie voor meer informatie.

Aan de slag

In deze sectie wordt beschreven hoe u aan de slag gaat met gegevensverzameling op basis van OpenTelemetry in Azure Monitor Application Insights.

Toegangspunten zijn onder andere:

• Web-apps aan de serverzijde
• Web-apps aan de serverzijde die worden gehost op een virtuele machine (VM)
• JavaScript-apps aan de clientzijde
• Azure Functions (serverloze computerdiensten van Azure)
• AI-agenten

Aanbeveling

• Gebruik voor de meeste op code gebaseerde serverscenario's de Microsoft OpenTelemetry Distro voor .NET, Node.jsen Python of de Azure Monitor OpenTelemetry Distro voor Java.
• Scenario's waarin OpenTelemetry niet beschikbaar is, worden duidelijk geïdentificeerd.

Kies het tabblad dat het beste overeenkomt met uw workload of hostingmodel. Elk tabblad toont het aanbevolen pad voor het verzamelen van gegevens voor dat scenario.

Gegevensverzameling instellen

Web-apps

Gebruik dit pad voor web-apps aan de serverzijde die u in code instrumenteer.

1. Een Application Insights-resource maken.
2. Haal de verbindingsreeks van de resource op.
3. Voeg voor .NET, Node.jsen Python de Microsoft OpenTelemetry Distro toe aan uw app. Gebruik voor Java de Azure Monitor OpenTelemetry Distro.
4. Stel de verbindingsreeks in.

Aanbeveling

Op sommige platforms kan gegevens automatisch worden verzameld via automatische instrumentatie. Schakel over naar instrumentatie op basis van code met de Microsoft OpenTelemetry Distro voor .NET, Node.jsen Python of de Azure Monitor OpenTelemetry Distro voor Java als u meer configuratie- en uitbreidbaarheidsopties wilt.

VM

Gebruik dit pad wanneer uw app draait op een virtuele machine of virtuele machineschaalset. De code-gebaseerde flow is hetzelfde als voor andere apps aan de serverzijde.

1. Een Application Insights-resource maken.
2. Haal de verbindingsreeks van de resource op.
3. Voeg voor .NET, Node.jsen Python de Microsoft OpenTelemetry Distro toe aan uw app. Gebruik voor Java de Azure Monitor OpenTelemetry Distro.
4. Stel de verbindingsreeks in.

Aanbeveling

Op sommige platforms kan gegevens automatisch worden verzameld via automatische instrumentatie. Schakel over naar instrumentatie op basis van code met de Microsoft OpenTelemetry Distro voor .NET, Node.jsen Python of de Azure Monitor OpenTelemetry Distro voor Java als u meer configuratie- en uitbreidbaarheidsopties wilt.

JavaScript

Gebruik dit pad voor browsertelemetrie, zoals paginaweergaven en gebruikersinteracties. Browser-apps gebruiken de Application Insights JavaScript SDK, niet OpenTelemetry.

1. Een Application Insights-resource maken.
2. Haal de verbindingsreeks van de resource op.
3. Voeg de JavaScript SDK toe aan uw app.
4. Stel de verbindingsreeks in.

Notitie

De JavaScript SDK van Application Insights maakt geen gebruik van OpenTelemetry. Zie Kan OpenTelemetry worden gebruikt voor webbrowsers voor meer informatie?

Functies

Gebruik dit pad voor Azure Functions. Begin met de instellingen van de functie-app en volg vervolgens het Functions-artikel voor de taalspecifieke stappen.

1. Schakel OpenTelemetry in door de host.json-file van uw functie-app te configureren met "telemetryMode": "OpenTelemetry".
2. Voeg de APPLICATIONINSIGHTS_CONNECTION_STRINGtoepassingsinstelling toe met behulp van uw Application Insights verbindingsreeks.
3. Voltooi de taalspecifieke instrumentatie en de vereiste werkrolinstellingen in Use OpenTelemetry met Azure Functions.

Notitie

OpenTelemetry wordt momenteel niet ondersteund voor in-process C#-apps.

Kubernetes

Gebruik dit pad voor apps die worden uitgevoerd op Azure Kubernetes Service (AKS). De code-gebaseerde flow is hetzelfde als voor andere apps aan de serverzijde.

1. Een Application Insights-resource maken.
2. Haal de verbindingsreeks van de resource op.
3. Voeg voor .NET, Node.jsen Python de Microsoft OpenTelemetry Distro toe aan uw app. Gebruik voor Java de Azure Monitor OpenTelemetry Distro.
4. Stel de verbindingsreeks in.

Notitie

Automatische instrumentatie voor Azure Kubernetes Service (AKS) is beschikbaar als openbare proefversie.

Agenten

Gebruik dit pad voor AI-agents. Kies de installatie die overeenkomt met uw hostingmodel.

• Beheerde hosting

  • Azure AI Foundry: Voor door Foundry beheerde agents en werkstromen begint u met traceringsinstellingen in Foundry. Voor instrumentatie aan de app-zijde kunt u ook de Microsoft OpenTelemetry Distro gebruiken met de Foundry SDK.

• Zelfhosting

  • Microsoft Agent Framework: Als u een volledig nieuwe agent bouwt en zelfhosting uitvoert, gebruikt u het Microsoft Agent Framework om uw agent te organiseren en telemetrie te verzenden naar Azure Monitor.
  • Agenten van derden: Als u ergens anders een agent hebt gemaakt, gebruikt u de Azure AI OpenTelemetry Tracer om telemetrie naar Azure Monitor te verzenden. Deze agents kunnen ook worden geregistreerd in Azure AI Foundry. Zie Tracering inschakelen voor agents die zijn gebouwd op LangChain & LangGraph en Tracering inschakelen voor agents die zijn gebouwd op de OpenAI Agents SDK voor frameworkspecifieke richtlijnen.

Nadat de telemetrie beschikbaar is, kunt u de detailsweergave van de Application Insights-agent verkennen.

Als u ervoor kiest om volledige promptgegevens te verzamelen, bijvoorbeeld met behulp van de EnableSensitiveData flag in Agent Framework, kunt u in de zoekweergave zoeken en gesprekken bekijken, waaronder assistentberichten, systeemprompts en het gebruik van hulpmiddelen, in de weergave Transactiedetails.

Geef elke agent een afzonderlijke naam, zodat u ze kunt onderscheiden in de weergave Agentdetails. Als uw agentische onderdelen deel uitmaken van een grotere toepassing, kunt u deze verzenden naar een bestaande Application Insights-resource.

Als u uw agents ook in Azure AI Foundry naast Azure Monitor wilt zien, een Application Insights-resource verbinden met uw Foundry-project.

U kunt evaluaties ook op deze manieren instellen:

• Batch-evaluaties
  • Lokale evaluaties met Azure AI Evaluation SDK:Voer evaluaties uit op uw ontwikkelcomputer tijdens het testen.
  • Cloud-evaluaties met de Foundry SDK:Execute-evaluaties in Azure voor grotere gegevenssets of teamsamenwerking.
  • Evaluaties op basis van de Foundry-portal:Gebruik de Foundry-portal voor werkstromen voor evaluatie zonder code.
• Doorlopende evaluaties:stel geautomatiseerde evaluaties in die worden uitgevoerd op productieverkeer om kwaliteitsregressies te detecteren.

Nadat u de installatie voor uw scenario hebt voltooid, voert u uw app uit en wacht u enkele minuten tot telemetrie wordt weergegeven in Application Insights. Verken vervolgens Application Insights-ervaringen.

Belangrijk

Als u migreert van oudere Application Insights-SDK's, raadpleegt u Migrate naar Azure Monitor OpenTelemetry.

Andere OpenTelemetry-integraties op Azure

Azure Monitor Application Insights kan worden geïntegreerd met andere Azure-services die gebruikmaken van OpenTelemetry. Gebruik de volgende bronnen voor Azure services, SDK's (Software Development Kits) en hulpprogramma's die gebruikmaken van OpenTelemetry:

Integration	Description
Semantische conventies voor Azure SDK	Naamconventies voor openTelemetry-kenmerken die in alle Azure-SDK's worden gebruikt.
Java tracing in de Azure SDK	Ondersteuning voor gedistribueerde tracering voor Azure SDK voor Java-clients.
Waarneembaarheid van Azure Cosmos DB SDK	OpenTelemetry-traceringen en metrische gegevens die worden verzonden door de Azure Cosmos DB SDK.
.NET waarneembaarheid met OpenTelemetry	OpenTelemetry-instrumentatierichtlijnen voor .NET toepassingen.
Azure Monitor-pipeline aan de edge en in multicloud-omgevingen	OpenTelemetry-gegevens verzamelen en doorsturen vanuit edge- en multicloudomgevingen naar Azure Monitor.
OpenTelemetry-gegevensopname in Azure Data Explorer	OpenTelemetry-gegevens opnemen in Azure Data Explorer, Synapse-Data Explorer en Real-Time Intelligence.
Azure Container Apps OpenTelemetry-agent	Ingebouwde OpenTelemetry-agent voor Azure Container Apps.
Aspire-dashboard	Lokaal ontwikkeldashboard voor het weergeven van OpenTelemetry-traceringen en metrische gegevens uit .NET Aspire-apps.

Probleemoplossingsproces

Raadpleeg onze speciale documentatie voor probleemoplossing voor Application Insights voor hulp bij het oplossen van problemen met Application Insights.

Help en ondersteuning

Azure technische ondersteuning

Voor ondersteuning voor Azure problemen opent u een ondersteuning voor Azure-ticket.

Algemene vragen

Stel algemene vragen op het Microsoft Questions and Answers-forum.

Codevragen

Post codeervragen naar Stack Overflow met behulp van een azure-application-insights tag.

Feedback Gemeenschap

Laat productfeedback achter voor het technische team in de feedbackcommunity.