Použití OpenTelemetry v .NET Aspire

  • 7 min

.NET Aspire pomáhá zaznamenávat chování aplikace nativní pro cloud tím, že při vytváření projektu .NET Aspire automaticky zahrne podporu OpenTelemetry.

Představte si, že pracujete pro prodejce venkovního vybavení. Rozhodli jste se, že chcete zaznamenávat telemetrická data. Teď chcete zjistit, jak rozhraní .NET Aspire pomáhá s telemetrií.

V této lekci se dozvíte o integraci mezi rozhraními API .NET Aspire a OpenTelemetry.

.NET Aspire a OpenTelemetry

Hlavním cílem návrhu a implementace rozhraní .NET Aspire je zajistit, aby aplikace nativní pro cloud byly snadno monitorovat a řešit potíže. .NET Aspire zjednodušuje zajištění, aby byla kompletní aplikace pozorovatelná a plně instrumentovaná pomocí rozhraní OpenTelemetry API a automaticky nastavovala zdroje telemetrických dat pokaždé, když vytvoříte novou aplikaci ze šablon nebo přidáte existující aplikaci do orchestrace .NET Aspire.

Integrace .NET Aspire mají také integrovanou podporu telemetrie.

.NET Aspire poskytuje řídicí panel .NET Aspire při místním ladění. Toto webové rozhraní obsahuje bohaté nástroje, které zobrazují protokoly, metriky v grafických formátech a trasování na časových osách.

Snímek obrazovky zobrazující stránku Trasování na řídicím panelu .NET Aspire

Konfigurace OpenTelemetry v .NET Aspire

Kód, který přidává a konfiguruje OpenTelemetry v řešení .NET Aspire, je v projektu ServiceDefaults . V souboru Extensions.cs najdete:

  • Metoda ConfigureOpenTelemetry() , která přidává protokolování, metriky a trasovací služby.
  • Metoda AddOpenTelemetryExporters() , která přidává exportéry OTLP (OpenTelemetry Protocol).
  • Metoda AddBuiltInMeters() , která přidá všechny metriky, které jsou integrované do .NET.

Pokud nechcete přidávat další vývozce nebo metriky, můžete tento kód ponechat tak, jak je.

Tento kód byste měli rozšířit, pokud chcete:

  • Přidejte další zdroje metrik nebo distribuovaných trasovacích dat, jako jsou vlastní metriky.
  • Přidejte exportéry pro odesílání telemetrických dat do systému Správy výkonu aplikací (APM), jako je Application Insights nebo Grafana.

Export telemetrie

OpenTelemetry může exportovat data, která zaznamenává, do různých nástrojů, takže můžete zvolit ten, který podporuje potřebnou analýzu.

Mezi běžné cíle exportu telemetrie patří:

  • Řídicí panel Aspire. Další informace o řídicím panelu se dozvíte později v tomto modulu.
  • Další nástroje pro správu výkonu aplikací (APM), jako jsou Prometheus a Grafana.
  • Azure Application Insights Tato funkce služby Azure Monitor dokáže analyzovat a zobrazovat data o chování z mnoha zdrojů, a to jak v Rámci Azure, tak z jiných zdrojů, jako jsou aplikace nativní pro cloud.

Další informace