Sdílet prostřednictvím


Nápověda, podpora a zpětná vazba k OpenTelemetry

Tento článek obsahuje nápovědu, podporu a možnosti zpětné vazby pro OpenTelemetry ve službě Azure Monitor Application Insights pro .NET, Javu, Node.js a aplikace v Pythonu.

Nejčastější dotazy

Co je OpenTelemetry?

Jedná se o nový opensourcový standard pro pozorovatelnost. Další informace najdete v OpenTelemetry.

Proč Microsoft Azure Monitor investuje do OpenTelemetry?

Microsoft investuje do OpenTelemetry z následujících důvodů:

  • Je neutrální od dodavatele a poskytuje konzistentní rozhraní API a sady SDK napříč jazyky.
  • V průběhu času věříme, že OpenTelemetry umožní zákazníkům služby Azure Monitor sledovat aplikace napsané v jazycích nad rámec našich podporovaných jazyků.
  • Rozšiřuje typy dat, která můžete shromažďovat prostřednictvím bohaté sady knihoven instrumentace.
  • Sady OpenTelemetry Software Development Kit (SDK) mají tendenci být výkonnější ve velkém měřítku než jejich předchůdci, sady SDK Application Insights.
  • OpenTelemetry odpovídá strategii Microsoftu pro přijetí opensourcových řešení.

Jaký je stav OpenTelemetry?

Viz stav OpenTelemetry.

Co je distribuce OpenTelemetry služby Azure Monitor?

Můžete si ho představit jako tenký obal, který spojuje všechny komponenty OpenTelemetry pro prvotřídní prostředí v Azure. Tento obálka se také nazývá distribuce v OpenTelemetry.

Proč mám používat distrou OpenTelemetry služby Azure Monitor?

Použití opentelemetry Azure Monitoru přes nativní OpenTelemetry od komunity má několik výhod:

V duchu OpenTelemetry jsme navrhli distribuci tak, aby byla otevřená a rozšiřitelná. Můžete například přidat:

  • Vývozce protokolu OTLP (OpenTelemetry Protocol) a odeslání do druhého místa určení současně
  • Jiné knihovny instrumentace, které nejsou součástí distribuce

Vzhledem k tomu, že distro poskytuje distribuci OpenTelemetry, distro podporuje cokoli, co podporuje OpenTelemetry. Pokud je OpenTelemetry podporuje, můžete například přidat další procesory telemetrie, exportéry nebo knihovny instrumentace.

Poznámka:

Distribuce nastaví sampler na vlastní vzorkovník s pevnou rychlostí pro Application Insights. Můžete to změnit na jiný sampler, ale můžete to udělat tak, že zakážete některé zahrnuté funkce distribuce. Další informace o podporovaném sampleru najdete v části Povolení vzorkování v části Konfigurace OpenTelemetry služby Azure Monitor.

Pro jazyky bez podporovaného samostatného exportéru OpenTelemetry je jediným aktuálně podporovaným způsobem použití OpenTelemetry se službou Azure Monitor. Pro jazyky s podporovaným samostatným exportérem OpenTelemetry máte možnost použít distro služby Azure Monitor OpenTelemetry nebo příslušný samostatný exportér OpenTelemetry v závislosti na vašem scénáři telemetrie. Další informace najdete v tématu Kdy mám použít exportér OpenTelemetry služby Azure Monitor?.

Jak můžu otestovat distribuci OpenTelemetry služby Azure Monitor?

Projděte si naši dokumentaci k povolení pro .NET, Java, JavaScript (Node.js) a Python.

Mám použít OpenTelemetry nebo sadu Application Insights SDK?

Pokud nepotřebujete funkci, která je dostupná pouze s formální podporou v sadě Application Insights SDK, doporučujeme používat distro OpenTelemetry.

Přijetí OpenTelemetry teď brání migraci později.

Kdy mám použít exportér OpenTelemetry služby Azure Monitor?

Pro ASP.NET Core, Javu, Node.js a Python doporučujeme použít distro OpenTelemetry služby Azure Monitor. Začněte jedním řádkem kódu.

Pro všechny ostatní scénáře .NET, včetně klasických ASP.NET, konzolových aplikací, model Windows Forms (WinForms) atd., doporučujeme použít exportér OpenTelemetry pro .NET Azure Monitor: Azure.Monitor.OpenTelemetry.Exporter.

Pro složitější scénáře telemetrie Pythonu, které vyžadují pokročilou konfiguraci, doporučujeme použít exportér OpenTelemetry služby Python Azure Monitor.

Jaký je aktuální stav funkcí ve službě Azure Monitor OpenTelemetry Distro?

Následující graf rozebíral podporu funkcí OpenTelemetry pro každý jazyk.

Funkce .NET Node.js Python Java
Distribuované trasování
Vlastní metrika
Standardní metriky
Vzorkování s pevnou frekvencí
Offline úložiště a automatické opakování
Generování sestav výjimek
Shromažďování protokolů ⚠️
Vlastní události ⚠️ ⚠️ ⚠️
Ověřování Microsoft Entra
Živé metriky
Filtrování živých metrik
Zjištění kontextu prostředků pro virtuální počítač nebo VMSS a App Service
Zjištění kontextu prostředku pro službu Azure Kubernetes Service (AKS) a funkce
Události testování dostupnosti vygenerované pomocí rozhraní API pro sledování dostupnosti
Filtrování požadavků, závislostí, protokolů a výjimek podle anonymního ID uživatele a syntetického zdroje
Filtrování závislostí, protokolů a výjimek podle názvu operace
Adaptivní vzorkování
.NET Profiler ⚠️
Ladicí program snímků

Klíč

  • ✅ Tato funkce je dostupná všem zákazníkům s formální podporou.
  • ⚠✔ Tato funkce je k dispozici jako veřejná verze Preview. Přečtěte si doplňkové podmínky použití pro verze Preview Microsoft Azure.
  • ❌ Tato funkce není dostupná nebo se nedá použít.

Je možné OpenTelemetry použít pro webové prohlížeče?

Ano, ale nedoporučujeme ho a Azure ho nepodporuje. OpenTelemetry JavaScript je silně optimalizovaný pro Node.js. Místo toho doporučujeme použít sadu Application Insights JavaScript SDK.

Kdy můžeme očekávat, že sada OpenTelemetry SDK bude dostupná pro použití ve webových prohlížečích?

Webová sada SDK OpenTelemetry nemá určenou časovou osu dostupnosti. Pravděpodobně jsme několik let daleko od sady SDK prohlížeče, která je možná alternativou k sadě Application Insights JavaScript SDK.

Můžu dnes testovat OpenTelemetry ve webovém prohlížeči?

Webový sandbox OpenTelemetry je fork navržený tak, aby openTelemetry fungoval v prohlížeči. Zatím není možné odesílat telemetrii do Application Insights. Sada SDK nedefinuje obecné události klienta.

Podporuje se spouštění Application Insights společně s agenty konkurentů, jako jsou AppDynamics, DataDog a NewRelic?

Tento postup není něco, co plánujeme testovat nebo podporovat, i když naše distribuce umožňují exportovat do koncového bodu OTLP společně se službou Azure Monitor současně.

Můžu používat funkce preview v produkčních prostředích?

Nedoporučujeme ho. Přečtěte si doplňkové podmínky použití pro verze Preview Microsoft Azure.

Jaký je rozdíl mezi ručním a automatickým instrumentací?

Viz přehled OpenTelemetry.

Můžu použít kolektor OpenTelemetry?

Někteří zákazníci používají OpenTelemetry Collector jako alternativu agenta, i když Microsoft oficiálně nepodporuje přístup založený na agentech pro monitorování aplikací. Do té doby opensourcová komunita přispěla exportérem Služby Azure Monitoru OpenTelemetry, který někteří zákazníci používají k odesílání dat do služby Azure Monitor Application Insights. Microsoft to nepodporuje.

Jaký je rozdíl mezi OpenCensus a OpenTelemetry?

OpenCensus je prekurzorem OpenTelemetry. Microsoft pomohl spojit OpenTracing a OpenCensus k vytvoření OpenTelemetry, jediného pozorovatelného standardu pro svět. Aktuální sada Python SDK doporučená pro produkční prostředí pro Azure Monitor je založená na OpenCensus. Společnost Microsoft se zavázala vytvářet Azure Monitor na základě OpenTelemetry.

V Grafaně, proč vidím Status: 500. Can't visualize trace events using the trace visualizer?

Místo trasování OpenTelemetry se můžete pokoušet vizualizovat nezpracované textové protokoly.

V Application Insights tabulka Traces ukládá nezpracované textové protokoly pro účely diagnostiky. Pomáhají identifikovat a korelovat trasování související s požadavky uživatelů, dalšími událostmi a sestavami výjimek. Tabulka Traces ale přímo nepřispívá do kompletního zobrazení transakcí (vodopádový graf) v nástrojích vizualizace, jako je Grafana.

S rostoucím přijetím postupů nativních pro cloud existuje vývoj shromažďování a terminologie telemetrie. OpenTelemetry se stal standardem pro shromažďování a instrumentaci telemetrických dat. V tomto kontextu pojem Traces převzal nový význam. Místo nezpracovaných protokolů označují trasování v OpenTelemetry bohatší strukturovanou formu telemetrie, která zahrnuje rozsahy, které představují jednotlivé jednotky práce. Tato rozsahy jsou zásadní pro vytváření podrobných zobrazení transakcí, což umožňuje lepší monitorování a diagnostiku aplikací nativních pro cloud.

Řešení problému

Krok 1: Povolení protokolování diagnostiky

Exportér služby Azure Monitor používá k internímu protokolování EventSource. Protokoly vývozce jsou k dispozici pro jakýkoli EventListener tím, že se přihlásí ke zdroji s názvem OpenTelemetry-AzureMonitor-Exporter. Postup řešení potíží najdete v tématu Řešení potíží s OpenTelemetry na GitHubu.

Krok 2: Testování připojení mezi hostitelem vaší aplikace a službou příjmu dat

Sady Application Insights pro vývoj softwaru (SDK) a agenti odesílají telemetrii, aby se ingestovala jako volání REST v našich koncových bodech příjmu dat. Pokud chcete otestovat připojení z webového serveru nebo hostitelského počítače aplikace ke koncovým bodům služby pro příjem dat, použijte příkazy cURL nebo nezpracované požadavky REST z PowerShellu. Další informace najdete v tématu Řešení potíží s chybějící telemetrií aplikací ve službě Azure Monitor Application Insights.

Známé problémy

V následujících položkách jsou známé problémy pro exportéry OpenTelemetry služby Azure Monitor:

  • V telemetrii závislostí chybí název operace. Chybějící název operace způsobuje selhání a nepříznivě ovlivňuje výkon karty.

  • V požadavku a telemetrii závislostí chybí model zařízení. Chybějící model zařízení nepříznivě ovlivňuje analýzu kohorty zařízení.

Technická podpora

Vyberte kartu pro jazyk podle vašeho výběru a objevte možnosti podpory.

  • V případě podpora Azure problémů otevřete lístek podpora Azure.
  • V případě problémů s OpenTelemetry se obraťte přímo na komunitu OpenTelemetry .NET.
  • Seznam otevřených problémů souvisejících s exportérem služby Azure Monitor najdete na stránce Problémy GitHubu.

Zpětná vazba k OpenTelemetry

Poskytnutí zpětné vazby:

  • Vyplňte průzkum názorů zákazníků komunity OpenTelemetry.
  • Řekněte Microsoftu o sobě tím, že se připojíte ke komunitě OpenTelemetry Early Adopter.
  • Spojte se s dalšími uživateli služby Azure Monitor v technické komunitě Microsoftu.
  • Vytvořte žádost o funkci na fóru Azure Feedback.