Úvod do Application Insights – pozorovatelnost OpenTelemetry

Azure Monitor Application Insights je funkce monitorování výkonu aplikací (APM) služby Azure Monitor. V případě podporovaných scénářů můžete použít OpenTelemetry (OTel), architekturu pozorovatelnosti neutrálního dodavatele k instrumentaci aplikací a shromažďování telemetrických dat a následné analýze této telemetrie v Application Insights.

Zkušenosti Application Insights

Application Insights podporuje OpenTelemetry (OTel) ke shromažďování telemetrických dat ve standardizovaném formátu napříč platformami. Integrace se službami Azure umožňuje efektivní monitorování a diagnostiku, což zlepšuje pozorovatelnost a výkon aplikací.

Prošetření

Pomocí těchto nástrojů můžete diagnostikovat problémy a porozumět chování modulu runtime vaší aplikace.

• Řídicí panel aplikace: Přehledné posouzení stavu a výkonu aplikace
• Mapa aplikace: Vizuální přehled interakcí architektury aplikací a komponent.
• Živé metriky: Řídicí panel analýzy v reálném čase pro přehled o aktivitě a výkonu aplikací.
• Zobrazení hledání: Trasování a diagnostika transakcí za účelem identifikace problémů a optimalizace výkonu
• Zobrazení dostupnosti: Proaktivně monitorujte a otestujte dostupnost a rychlost odezvy koncových bodů aplikace.
• Zobrazení selhání: Identifikace a analýza selhání ve vaší aplikaci za účelem minimalizace výpadků
• Zobrazení výkonu: Zkontrolujte metriky výkonu aplikací a potenciální kritické body.
• Podrobnosti o agentech: Jednotné zobrazení pro monitorování agentů umělé inteligence v sadě Microsoft Foundry, Copilot Studio a agentech třetích stran.

Sledování

Pomocí těchto nástrojů můžete nepřetržitě sledovat stav aplikace a nastavovat proaktivní oznámení.

• Upozornění: Monitorujte širokou škálu aspektů aplikace a aktivujte různé akce.
• Metriky: Podrobné informace o datech metrik, abyste porozuměli vzorům a trendům využití.
• Nastavení diagnostiky: Nakonfigurujte export protokolů platformy a metrik streamování do zvoleného cíle.
• Protokoly: Načtení, konsolidace a analýza všech dat shromážděných do protokolů monitorování Azure
• Sešity: Vytvářejte interaktivní sestavy a řídicí panely, které vizualizují data monitorování aplikací.
• Řídicí panely s Grafana: Vytváření, přizpůsobení a sdílení řídicích panelů Grafana pro data Application Insights přímo na webu Azure Portal
• Statistiky sady SDK: Vizualizujte úspěšnost exportéru, vyřazené počty, počty opakování a důvody vyřazení ze sad SDK a agentů Application Insights.

Využití

Tyto nástroje vám pomůžou pochopit, jak uživatelé pracují s vaší aplikací.

• Uživatelé, relace a události: Určete, kdy, kde a jak uživatelé pracují s vaší webovou aplikací.
• Trychtýře: Analyzujte míry konverze a zjistěte, kde uživatelé postupují dál nebo opouštějí trychtýř.
• Toky: Vizualizujte cesty uživatelů na vašem webu za účelem identifikace oblastí s vysokým zapojením a míst odchodu.
• Kohorty: Seskupení uživatelů podle sdílených charakteristik za účelem zjednodušení identifikace trendu, segmentace a řešení potíží s výkonem

Analýza kódu

Pomocí těchto nástrojů můžete profilovat a ladit kód aplikace.

• .NET Profiler: Zaznamenávat, identifikovat a zobrazit trasy výkonu vaší aplikace.
• Optimalizace kódu: Využijte AI k vytváření lepších a efektivnějších aplikací.
• Ladicí program pro snímky: Automatické shromažďování snímků při vzniku výjimek v aplikaci .NET

Model logiky

Diagram modelu logiky vizualizuje komponenty Application Insights a jejich interakci.

Poznámka:

Aby bylo možné dosáhnout koncových bodů příjmu dat, musí být nastavení brány firewall upraveno. Další informace najdete v tématu Přístup ke koncovému bodu služby Azure Monitor a konfigurace brány firewall.

Začínáme

Tato část se zabývá zahájením shromažďování dat založených na OpenTelemetry v Azure Monitor Application Insights.

Vstupní body zahrnují:

• Webové aplikace na straně serveru
• Webové aplikace na straně serveru hostované na virtuálním počítači
• Klientské aplikace v JavaScriptu
• Azure Functions
• Agenti umělé inteligence

Návod

• U většiny scénářů na straně serveru založených na kódu se doporučená instalace používá OpenTelemetry Distro služby Azure Monitor.
• Scénáře, kdy openTelemetry není k dispozici, jsou jasně identifikovány.

Zvolte kartu, která nejlépe odpovídá vašemu pracovnímu vytížení nebo modelu hostování. Každá karta zobrazuje doporučenou cestu shromažďování dat pro daný scénář.

Nastavení shromažďování dat

Webové aplikace

Tuto cestu použijte pro webové aplikace na straně serveru, které instrumentujete v kódu.

1. Vytvořte prostředek Application Insights.
2. Získejte připojovací řetězec prostředku.
3. Přidejte do aplikace Azure Monitor OpenTelemetry Distro.
4. Nakonfigurujte připojovací řetězec.

Návod

Některé platformy umožňují automatické shromažďování dat prostřednictvím automatické instrumentace. Pokud chcete více možností konfigurace a rozšiřitelnosti, přepněte na instrumentaci založenou na kódu pomocí Azure Monitor Distro.

VM

Tuto cestu použijte, když aplikace běží na virtuálním počítači nebo škálovací sadě virtuálních počítačů. Tok založený na kódu je stejný jako u jiných aplikací na straně serveru.

1. Vytvořte prostředek Application Insights.
2. Získejte připojovací řetězec prostředku.
3. Přidejte do aplikace Azure Monitor OpenTelemetry Distro.
4. Nakonfigurujte připojovací řetězec.

Návod

Některé platformy umožňují automatické shromažďování dat prostřednictvím automatické instrumentace. Pokud chcete více možností konfigurace a rozšiřitelnosti, přepněte na instrumentaci založenou na kódu pomocí Azure Monitor Distro.

JavaScript

Tuto cestu použijte pro telemetrii prohlížeče, jako jsou zobrazení stránek a interakce uživatelů. Aplikace prohlížeče používají sadu Application Insights JavaScript SDK, nikoli OpenTelemetry.

1. Vytvořte prostředek Application Insights.
2. Získejte připojovací řetězec prostředku.
3. Přidejte JavaScript SDK do své aplikace.
4. Nakonfigurujte připojovací řetězec.

Poznámka:

Sada Application Insights JavaScript SDK nepoužívá OpenTelemetry. Další informace naleznete v tématu Lze OpenTelemetry použít pro webové prohlížeče?

Functions

Tuto cestu použijte pro Azure Functions. Začněte nastavením aplikace funkcí a postupujte podle článku o funkcích pro konkrétní jazyk.

1. V souboru aplikace host.json funkcí povolte OpenTelemetry nastavením "telemetryMode": "OpenTelemetry".
2. Přidejte nastavení aplikace pomocí připojovacího řetězce Application Insights.
3. Dokončete instrumentaci specifickou pro jazyk a všechna požadovaná nastavení pracovního procesu v Use OpenTelemetry s Azure Functions.

Poznámka:

OpenTelemetry se v současné době nepodporuje pro procesní aplikace jazyka C#.

Tuto cestu použijte pro aplikace spuštěné ve službě Azure Kubernetes Service (AKS). Tok založený na kódu je stejný jako u jiných aplikací na straně serveru.

1. Vytvořte prostředek Application Insights.
2. Získejte připojovací řetězec prostředku.
3. Přidejte do aplikace OpenTelemetry Distro.
4. Nakonfigurujte připojovací řetězec.

Poznámka:

Automatická instrumentace pro Azure Kubernetes Service (AKS) je dostupná jako veřejná ukázka.

Agenti

Tuto cestu použijte pro agenty AI. Zvolte nastavení, které odpovídá vašemu modelu hostování.

• Spravované hostování

  • Azure AI Foundry: U agentů a pracovních postupů spravovaných Foundry začněte s nastavením sledování ve Foundry. Pro instrumentaci na straně aplikace můžete také použít distro Azure Monitor OpenTelemetry s Foundry SDK.

• Samoobslužné hostování

  • Microsoft Agent Framework: Pokud vytváříte agenta od začátku a vlastního hostování, použijte Microsoft Agent Framework k orchestraci agenta a generování telemetrie pro Azure Monitor.
  • Agenti třetích stran: Pokud jste vytvořili agenta jinde, použijte Azure AI OpenTelemetry Tracer k generování telemetrie do Azure Monitor. Tyto agenty je také možné zaregistrovat v Azure AI Foundry. Pokyny specifické pro architekturu najdete v tématu Povolení trasování pro agenty založené na jazyku LangChain a LangGraph a povolení trasování pro agenty založené na sadě OPENAI Agents SDK.

Jakmile telemetrie proudí, jste připraveni prozkoumat zobrazení podrobností agenta v Application Insights.

Pokud se rozhodnete shromáždit úplné informace o výzvě, například pomocí příznaku EnableSensitiveData v rozhraní Agent Framework, můžete vyhledávat výzvy v zobrazení hledání a kontrolovat konverzace, včetně zpráv asistentů, systémových výzev a použití nástrojů, v zobrazení Podrobnosti transakce .

Dejte každému agentovi jedinečný název, abyste je mohli oddělit v zobrazení podrobností agenta. Pokud jsou komponenty agentů součástí větší aplikace, zvažte jejich odeslání do existujícího prostředku Application Insights.

Pokud chcete vidět své agenty nejen v Azure Monitor, ale i v Azure AI Foundry, připojte prostředek Application Insights k projektu Foundry.

Hodnocení můžete nastavit také těmito způsoby:

• Dávkové vyhodnocení
  • Místní vyhodnocení pomocí Azure AI Evaluation SDK:Spusťte vyhodnocení na svém vývojovém stroji během testování.
  • Cloudové vyhodnocení pomocí sady Foundry SDK:Provádějte hodnocení v Azure pro rozsáhlejší datové soubory nebo pro týmovou spolupráci.
  • Vyhodnocení založená na portálu Foundry:Použijte portál Foundry pro pracovní postupy vyhodnocení bez kódu.
• Průběžné vyhodnocení:Nastavte automatizované vyhodnocení, která běží proti produkčnímu provozu, aby se detekují regrese kvality.

Po dokončení nastavení pro váš scénář spusťte aplikaci a počkejte několik minut, než se telemetrie objeví v Application Insights. Pak prozkoumejte prostředí Application Insights.

Důležité

Pokud migrujete ze starších sad Application Insights SDK, přečtěte si téma Migrace na Azure Monitor OpenTelemetry.

Další integrace OpenTelemetry na Azure

Azure Monitor Application Insights se integruje s dalšími službami Azure, které používají OpenTelemetry. Pro Azure služby, sady SDK (Software Development Kit) a nástroje, které používají OpenTelemetry, použijte následující zdroje informací:

Integrace	Description
Sémantické konvence sady Azure SDK	Konvence vytváření názvů atributů OpenTelemetry používané napříč všemi Sady Azure SDK
** Trasování Java v Azure SDK	Podpora distribuovaného trasování pro Azure SDK pro klienty Java
Pozorovatelnost sady SDK služby Azure Cosmos DB	Trasování OpenTelemetry a metriky generované Azure Cosmos DB sadou SDK
pozorovatelnost .NET pomocí OpenTelemetry	Pokyny k instrumentaci OpenTelemetry pro aplikace .NET
Kanál Azure Monitor na okraji sítě a ve více cloudech	Shromažďování a předávání dat OpenTelemetry z hraničních a multicloudových prostředí do Azure Monitor
Ingestování dat OpenTelemetry do Azure Data Exploreru	Ingestování dat OpenTelemetry do Azure Data Explorer, Synapse Data Explorer a Real-Time Intelligence.
Agent OpenTelemetry pro Azure Container Apps	Integrovaný agent OpenTelemetry pro Azure Container Apps
Řídicí panel Aspire	Řídicí panel pro místní vývoj k zobrazení tras a metrik OpenTelemetry z aplikací .NET Aspire

Řešení problémů

Pomoc s řešením potíží s Application Insights najdete v naší vyhrazené dokumentaci k řešení potíží.

Nápověda a podpora

Technická podpora Azure

V případě problémů s podporou Azure otevřete lístek podpory Azure.

Obecné otázky

Publikujte obecné dotazy na fóru Microsoft Questions and Answers.

Otázky týkající se kódování

Položte otázky týkající se kódování na Stack Overflow pomocí tagu azure-application-insights.

Komunita zpětné vazby

Napište nám svůj názor na produkt pro technický tým v komunitě Feedback.