Een app instrumenteer voor bewaking
Op basisniveau betekent 'instrumenteren' eenvoudigweg dat een toepassing telemetriegegevens kan vastleggen. Er zijn twee methoden om uw toepassing te instrumenteren:
- Automatische instrumentatie (auto-instrumentatie)
- Handmatige instrumentatie
Automatische instrumentatie maakt het verzamelen van telemetrie mogelijk via de configuratie zonder de code van de toepassing aan te raken. Hoewel het handiger is, is het meestal minder configureerbaar. Het is ook niet beschikbaar in alle talen. Zie Ondersteunde omgevingen en talen voor Autoinstrumentation. Wanneer automatische instrumentatie beschikbaar is, is dit de eenvoudigste manier om Azure Monitor Application Insights in te schakelen.
Handmatige instrumentatie codeert op basis van de Application Insights- of OpenTelemetry-API. In de context van een gebruiker verwijst deze doorgaans naar het installeren van een taalspecifieke SDK in een toepassing. Dit betekent dat u de updates voor de nieuwste pakketversie zelf moet beheren. U kunt deze optie gebruiken als u aangepaste afhankelijkheidsaanroepen of API-aanroepen wilt maken die niet standaard worden vastgelegd met automatische instrumentatie. Er zijn twee opties voor handmatige instrumentatie:
Inschakelen via Application Insights SDK's
U hoeft de Application Insights SDK alleen in de volgende omstandigheden te installeren:
- U hebt aangepaste gebeurtenissen en metrische gegevens nodig
- U hebt controle nodig over de stroom van telemetrie
- Automatische instrumentatie is niet beschikbaar (meestal vanwege taal- of platformbeperkingen)
Als u de SDK wilt gebruiken, installeert u een klein instrumentatiepakket in uw app en instrumentt u vervolgens de web-app, eventuele achtergrondonderdelen en JavaScript op de webpagina's. De app en de bijbehorende onderdelen hoeven niet te worden gehost in Azure. De instrumentatie bewaakt uw app en stuurt de telemetriegegevens naar een Application Insights-resource met behulp van een uniek token.
Een lijst met SDK-versies en -namen wordt gehost op GitHub. Ga naar SDK-versie voor meer informatie.
Inschakelen via OpenTelemetry
Microsoft werkte samen met belanghebbenden van twee eerder populaire opensource-telemetrieprojecten, OpenCensus en OpenTracing. Samen hebben we geholpen bij het maken van één project, OpenTelemetry. OpenTelemetry omvat bijdragen van alle grote leveranciers van cloud- en Application Performance Management (APM) en bevindt zich binnen de Cloud Native Computing Foundation (CNCF). Microsoft is een Platinum Member van de CNCF.
Sommige verouderde termen in Application Insights zijn verwarrend vanwege de convergentie van de industrie op OpenTelemetry. In de volgende tabel worden deze verschillen gemarkeerd. OpenTelemetry-termen vervangen Application Insights-termen.
| Analyses van toepassingen | OpenTelemetry |
|---|---|
| Autocollectors | Instrumentatiebibliotheken |
| Channel | Exportfunctie |
| Codeloos/ op basis van agents | Autoinstrumentatie |
| Traceringen | Logboeken |
| Verzoeken | Serverspanne |
| Afhankelijkheden | Andere spantypen (client, intern, enzovoort) |
| Bewerkings-id | Tracerings-id |
| Bovenliggende id of bewerkings-id | Span ID |