Az Application Insights bemutatása – OpenTelemetria megfigyelhetősége

Az Azure Monitor Application Insights az Azure Monitor alkalmazásteljesítmény-monitorozási (APM) funkciója. Támogatott forgatókönyvek esetén az OpenTelemetry (OTel) egy szállítósemleges megfigyelhetőségi keretrendszer használatával rendszerezheti az alkalmazásokat, és telemetriai adatokat gyűjthet, majd elemezheti ezt a telemetriát az Application Insightsban.

Application Insights-élmények

Az Application Insights támogatja az OpenTelemetry (OTel) szolgáltatást a telemetriai adatok szabványosított formában történő gyűjtéséhez a platformokon. Az Azure-szolgáltatásokkal való integráció hatékony monitorozást és diagnosztikát tesz lehetővé, ami javítja az alkalmazások megfigyelhetőségét és teljesítményét.

Vizsgálat

Ezekkel az eszközökkel diagnosztizálhatja a problémákat, és megismerheti az alkalmazás futtatókörnyezeti viselkedését.

• Alkalmazás irányítópultja: Az alkalmazás állapotának és teljesítményének áttekintése egy pillantással.
• Alkalmazástérkép: Az alkalmazásarchitektúra és az összetevők interakcióinak vizuális áttekintése.
• Élő metrikák: Valós idejű elemzési irányítópult az alkalmazástevékenység és a teljesítmény elemzéséhez.
• Keresési nézet: Tranzakciók nyomon követése és diagnosztizálása a problémák azonosításához és a teljesítmény optimalizálásához.
• Rendelkezésre állási nézet: Proaktívan monitorozza és teszteli az alkalmazásvégpontok rendelkezésre állását és válaszképességét.
• Hibák nézet: Az alkalmazás hibáinak azonosítása és elemzése az állásidő minimalizálása érdekében.
• Teljesítménynézet: Az alkalmazás teljesítménymetrikáinak és lehetséges szűk keresztmetszeteinek áttekintése.
• Ügynökök részletei: Egységes nézet a Microsoft Foundry, a Copilot Studio és a külső ügynökök AI-ügynökeinek monitorozásához.

Figyelés

Ezekkel az eszközökkel folyamatosan nyomon követheti az alkalmazás állapotát, és proaktív értesítéseket állíthat be.

• Riasztások: Az alkalmazás számos aspektusának figyelése és különböző műveletek aktiválása.
• Metrikák: Részletes elemzés a metrikák adatairól a használati minták és trendek megismeréséhez.
• Diagnosztikai beállítások: A platformnaplók és metrikák streamelési exportálásának konfigurálása a választott célhelyre.
• Naplók: Az Azure Monitoring Logsban összegyűjtött összes adat lekérése, összesítése és elemzése.
• Munkafüzetek: Alkalmazásfigyelési adatokat megjelenítő interaktív jelentések és irányítópultok létrehozása.
• Irányítópultok Grafanával: Grafana-irányítópultok létrehozása, testreszabása és megosztása az Application Insights-adatokhoz közvetlenül az Azure Portalon.
• SDK-statisztikák: Az exportőr sikerességét, az elvetett darabszámokat, az újrapróbálkozási számokat és az Application Insights SDK-k és -ügynökök elvetési okait jeleníti meg.

Használat

Ezekkel az eszközökkel megtudhatja, hogyan használják a felhasználók az alkalmazást.

• Felhasználók, munkamenetek és események: Meghatározza, hogy a felhasználók mikor, hol és hogyan használják a webalkalmazást.
• Tölcsérek: Elemezze a konverziós arányokat annak megállapításához, hogy a felhasználók hol haladnak vagy ugranak le a tölcsérben.
• Folyamatok: Felhasználói útvonalak megjelenítése a webhelyen a magas előjegyzési területek és a kilépési pontok azonosításához.
• Kohorszok: Felhasználók csoportosítása megosztott jellemzők szerint a trendazonosítás, a szegmentálás és a teljesítmény hibaelhárításának egyszerűsítése érdekében.

Kódelemzés

Ezekkel az eszközökkel profilt hozhat létre és hibakeresést végezhet az alkalmazáskódban.

• .NET Profiler: Az alkalmazás teljesítménykövetéseinek rögzítése, azonosítása és megtekintése.
• Kódoptimalizálások: Az AI kihasználása jobb és hatékonyabb alkalmazások létrehozásához.
• Pillanatkép-hibakereső: Hibakeresési pillanatképek automatikus gyűjtése a .NET-alkalmazásban történő kivételek esetén

Logikai modell

A logikai modell diagramja az Application Insights összetevőit és azok interakcióját jeleníti meg.

Megjegyzés

A tűzfalbeállításokat módosítani kell ahhoz, hogy az adatok elérjék a betöltési végpontokat. További információ: Azure Monitor végponthozzáférés és tűzfalkonfiguráció.

Kezdő lépések

Ez a szakasz az OpenTelemetry-alapú adatgyűjtés első lépéseit ismerteti az Azure Monitor Application Insightsban.

A belépési pontok a következők:

• Kiszolgálóoldali webalkalmazások
• Virtuális gépen (VM) üzemeltetett kiszolgálóoldali webalkalmazások
• Ügyféloldali JavaScript-alkalmazások
• Azure Functions
• AI-ügynökök

Jótanács

• A legtöbb kódalapú kiszolgálóoldali forgatókönyv esetében az ajánlott beállítás az Azure Monitor OpenTelemetry Distrot használja.
• Egyértelműen azonosíthatók azok a forgatókönyvek, amelyekben az OpenTelemetria nem érhető el.

Válassza ki a számítási feladatnak vagy az üzemeltetési modellnek leginkább megfelelő lapot. Az egyes lapok az adott forgatókönyvhöz ajánlott adatgyűjtési útvonalat jelenítik meg.

Adatgyűjtés beállítása

Webalkalmazások

Használja ezt az elérési utat a kódban mért kiszolgálóoldali webalkalmazásokhoz.

1. Hozzon létre egy Application Insights-erőforrást.
2. Kérje le az erőforrás kapcsolati karakterláncát.
3. Adja hozzá az Azure Monitor OpenTelemetry Distro az alkalmazáshoz.
4. Konfigurálja a kapcsolati karakterláncot.

Jótanács

Egyes platformok automatikus rendszerezéssel automatikusan engedélyezik az adatgyűjtést. Váltson az Azure Monitor OpenTelemetry Distro használatával végzett kódalapú instrumentálásra, ha további konfigurációs és bővíthetőségi lehetőségekre van szüksége.

VM

Ezt az elérési utat akkor használja, ha az alkalmazás virtuális gépen vagy virtuálisgép-méretezési csoportban fut. A kódalapú folyamat ugyanaz, mint a többi kiszolgálóoldali alkalmazás esetében.

1. Hozzon létre egy Application Insights-erőforrást.
2. Kérje le az erőforrás kapcsolati karakterláncát.
3. Adja hozzá az Azure Monitor OpenTelemetry Distro az alkalmazáshoz.
4. Konfigurálja a kapcsolati karakterláncot.

Jótanács

Egyes platformok automatikus rendszerezéssel automatikusan engedélyezik az adatgyűjtést. Váltson az Azure Monitor OpenTelemetry Distro használatával végzett kódalapú instrumentálásra, ha további konfigurációs és bővíthetőségi lehetőségekre van szüksége.

JavaScript

Használja ezt az elérési utat a böngésző telemetriai adataihoz, például a lapmegtekintésekhez és a felhasználói interakciókhoz. A böngészőalkalmazások az Application Insights JavaScript SDK-t használják, nem az OpenTelemetryt.

1. Hozzon létre egy Application Insights-erőforrást.
2. Kérje le az erőforrás kapcsolati karakterláncát.
3. Adja hozzá a JavaScript SDK-t az alkalmazáshoz.
4. Konfigurálja a kapcsolati karakterláncot.

Megjegyzés

Az Application Insights JavaScript SDK nem használja az OpenTelemetryt. További információ: Használható-e az OpenTelemetria webböngészőkhöz?

Funkciók

Az Azure Functions szolgáltatáshoz használja ezt az elérési utat. Kezdje a függvényalkalmazás beállításaival, majd kövesse a Nyelvspecifikus lépésekhez tartozó Functions-cikket.

1. Engedélyezze az OpenTelemetryt a függvényalkalmazás host.json fájljában a "telemetryMode": "OpenTelemetry" beállítással.
2. Adja hozzá a APPLICATIONINSIGHTS_CONNECTION_STRINGalkalmazási beállítást az Application Insights kapcsolati karakterlánc használatával.
3. Végezze el a nyelvspecifikus instrukciót és a szükséges feldolgozói beállításokat a Use OpenTelemetry with Azure Functions.

Megjegyzés

Az OpenTelemetria jelenleg nem támogatott a C# folyamatban lévő alkalmazások esetében.

Kubernetes

Ezt az elérési utat az Azure Kubernetes Service-ben (AKS) futó alkalmazásokhoz használhatja. A kódalapú folyamat ugyanaz, mint a többi kiszolgálóoldali alkalmazás esetében.

1. Hozzon létre egy Application Insights-erőforrást.
2. Kérje le az erőforrás kapcsolati karakterláncát.
3. Adja hozzá az OpenTelemetry Distro az alkalmazáshoz.
4. Konfigurálja a kapcsolati karakterláncot.

Megjegyzés

Automatic instrumentation for Azure Kubernetes Service (AKS) nyilvános előzetes verzióként érhető el.

ügynökök

Használja ezt az útvonalat a mesterséges intelligencia ügynökök számára. Válassza ki az üzemeltetési modellnek megfelelő beállítást.

• Felügyelt üzemeltetés

  • Azure AI Foundry: Az Foundry által felügyelt ügynökök és munkafolyamatok esetében kezdje a követés beállításával a Foundryben. Az alkalmazásoldali műszerezéshez használhatja az Azure Monitor OpenTelemetry elosztást is a Foundry SDK-val.

• Önkiszolgáló üzemeltetés

  • Microsoft Agent Framework: Ha egy ügynököt teljesen a semmiből hoz létre és saját hostolást alkalmaz, használja az Microsoft Agent Framework-öt az ügynök vezényléséhez és telemetria küldéséhez az Azure Monitorba.
  • Harmadik fél által biztosított ügynökök: Ha máshol készített ügynököt, az Azure AI OpenTelemetry Tracerrel telemetriát bocsáthat ki az Azure Monitorra. Ezek az ügynökök regisztrálhatók az Azure AI Foundryben is. A keretrendszerre vonatkozó útmutatásért tekintse meg a LangChain & LangGraphra épülő ügynökök nyomkövetésének engedélyezése és az OpenAI Agents SDK-ra épülő ügynökök nyomkövetésének engedélyezése című témakört.

Miután a telemetriai adatok beérkeznek, készen áll az Application Insights ügynök részletező nézetének megismerésére.

Ha úgy dönt, hogy teljes körű információkat gyűjt, például az EnableSensitiveData Agent Framework jelölőjének használatával, a Keresés nézetben kereshet, és áttekintheti a beszélgetéseket, beleértve az asszisztensi üzeneteket, a rendszerkéréseket és az eszközhasználatot a Tranzakció részletei nézetben.

Adjon külön nevet az egyes ügynököknek, hogy az Ügynök részletei nézetben megkülönböztethesse őket egymástól. Ha az ügynöki összetevők egy nagyobb alkalmazás részét képezik, érdemes lehet egy meglévő Application Insights-erőforrásba elküldeni őket.

Ha az ügynököket a Azure Monitor mellett Azure AI Foundry is látni szeretné, csatlakoztatnia kell egy Application Insights-erőforrást a Foundry-projekthez.

Az értékeléseket az alábbi módokon is beállíthatja:

• Batch-értékelések
  • Helyi értékelések az Azure AI Evaluation SDK-val:Kiértékelések futtatása a fejlesztői gépen a tesztelés során.
  • Felhőkiértékelések a Foundry SDK-val:Kiértékelések végrehajtása az Azure-ban a nagyobb adatkészletekhez vagy a csapatmunkához.
  • Foundry portálalapú értékelések:A Foundry portál használata kód nélküli értékelési munkafolyamatokhoz.
• Folyamatos értékelések:Automatikus értékelések beállítása, amelyek az éles forgalmon futnak a minőségi regressziók észleléséhez.

Miután elvégezte a forgatókönyv beállítását, futtassa az alkalmazást, és várjon néhány percet, amíg a telemetria megjelenik az Application Insightsban. Ezután ismerkedjen meg az Application Insights-élményekkel.

Fontos

Ha a régebbi Application Insights SDK-kről migrál, tekintse meg a Azure Monitor OpenTelemetry című témakört.

Egyéb OpenTelemetria-integrációk Azure

Azure Monitor Application Insights integrálható más, OpenTelemetryt használó Azure szolgáltatásokkal. Használja a következő erőforrásokat Azure szolgáltatásokhoz, szoftverfejlesztői készletekhez (SDK-khoz) és OpenTelemetryt használó eszközökhöz:

Integration	Description
Azure SDK szemantikai konvenciók	Az összes Azure SDK-ban használt OpenTelemetry-attribútumok elnevezési konvenciói.
Java nyomkövetése az Azure SDK-ban	Elosztott nyomkövetési támogatás Azure SDK Java ügyfelek számára.
Az Azure Cosmos DB SDK megfigyelhetősége	A Azure Cosmos DB SDK által kibocsátott OpenTelemetry-nyomkövetések és metrikák.
.NET megfigyelhetőség az OpenTelemetria használatával	Az OpenTelemetry eszközállapot-útmutatója .NET alkalmazásokhoz.
Azure Monitor folyamatkezelő perem- és multicloud környezetben	OpenTelemetria-adatok gyűjtése és továbbítása peremhálózati és többfelhős környezetekből a Azure Monitor.
OpenTelemetry betöltése az Azure Data Explorerbe	OpenTelemetria-adatok betöltése Azure Data Explorer, Synapse Data Explorer és Real-Time Intelligencebe.
Azure Container Apps OpenTelemetry-ügynök	Beépített OpenTelemetry-ügynök az Azure Container Appshez.
Aspire irányítópult	Helyi fejlesztési irányítópult az OpenTelemetry-nyomkövetések és -metrikák .NET Aspire alkalmazásokból való megtekintéséhez.

Hibaelhárítás

Az Application Insights hibaelhárításával kapcsolatos segítségért tekintse meg a dedikált hibaelhárítási dokumentációt.

Súgó és támogatás

Az Azure technikai támogatása

Azure-támogatási problémák esetén nyisson meg egy Azure-támogatási jegyet.

Általános kérdések

Általános kérdéseket tehet fel a Microsoft Kérdések és válaszok fórumára.

Kódolási kérdések

Kódolási kérdések közzététele a Stack Overflow-ba címke azure-application-insights használatával.

Visszajelzési közösség

Hagyjon visszajelzést a mérnöki csapatnak a visszajelzési közösségben.