Aspire telemetrie

Jedním z hlavních cílů Aspire je zajistit, aby aplikace byly jednoduché pro ladění a diagnostiku. Aspire Integrace automaticky nastaví konfigurace protokolování, trasování a metrik, které se někdy označují jako pilíře pozorovatelnosti pomocí .NETOpenTelemetry sady SDK.

• Protokolování: Události protokolu popisují, co se děje během běhu aplikace. Sada standardních hodnot je ve výchozím nastavení povolená pro Aspire integrace a k diagnostice konkrétních problémů je možné povolit rozsáhlejší protokolování na vyžádání.

• trasování: Trasování koreluje události protokolu, které jsou součástí stejné logické aktivity (např. zpracování jednoho požadavku), i když jsou rozložené mezi více počítačů nebo procesů.

• Metriky: Metriky zpřístupňují výkon a vlastnosti stavu aplikace jako jednoduché číselné hodnoty. V důsledku toho mají nízkou režii na výkon a mnoho služeb je konfiguruje jako vždy zapnutou telemetrii. To je také vhodné pro aktivaci výstrah při zjištění potenciálních problémů.

Tyto typy telemetrie vám společně umožňují získat přehled o chování a výkonu vaší aplikace pomocí různých monitorovacích a analytických nástrojů. V závislosti na zálohovací službě můžou některé integrace podporovat pouze některé z těchto funkcí.

integrace AspireOpenTelemetry

Sada .NETOpenTelemetry SDK obsahuje funkce pro shromažďování dat z několika rozhraní API .NET, včetně ILogger, Activity, Metera Instrument<T>. Tato rozhraní API odpovídají funkcím telemetrie, jako je protokolování, trasování a metriky. Projekty Aspire definují konfigurace sady SDK OpenTelemetry v projektu ServiceDefaults. Další informace najdete v tématu Aspire Výchozí hodnoty služby.

Ve výchozím nastavení metoda ConfigureOpenTelemetry umožňuje protokolování, trasování a metriky pro aplikaci. Přidává také vývozce těchto datových bodů, aby je mohly shromažďovat další monitorovací nástroje.

Export OpenTelemetry dat pro monitorování

Aspire umožňuje exportovat telemetrická data do softwarového nástroje pro ukládání nebo do nástroje pro vytváření reportů. Mechanismus exportu telemetrie spoléhá naprotokolu (OTLP), který slouží jako standardizovaný přístup k přenosu telemetrických dat prostřednictvím nebo gRPC. Metoda ConfigureOpenTelemetry také zaregistruje vývozce, kteří poskytují telemetrická data jiným monitorovacím nástrojům, jako je Prometheus nebo Azure Monitor. Další informace viz OpenTelemetry konfigurace.

OpenTelemetry proměnné prostředí

OpenTelemetry obsahuje seznam známých proměnných prostředí, které konfigurují nejdůležitější chování pro shromažďování a export telemetrie. OpenTelemetry SDK, včetně .NET SDK, podporují čtení těchto proměnných.

Aspire Projekty se spouštějí s proměnnými prostředí, které konfigurují název a ID aplikace pro export telemetrie a nastaví adresu koncového bodu serveru OTLP pro export dat. Například:

• OTEL_SERVICE_NAME = myfrontend
• OTEL_RESOURCE_ATTRIBUTES = service.instance.id=1a5f9c1e-e5ba-451b-95ee-ced1ee89c168
• OTEL_EXPORTER_OTLP_ENDPOINT = http://localhost:4318

Proměnné prostředí se automaticky nastaví v místním vývoji.

Aspire místní vývoj

Při vytváření projektu Aspire řídicí panel Aspire poskytuje uživatelské rozhraní pro zobrazení telemetrie aplikace ve výchozím nastavení. Telemetrická data se odesílají na řídicí panel pomocí OTLP a řídicí panel implementuje server OTLP, který přijímá telemetrická data a ukládá je do paměti. Pracovní Aspire postup ladění je následující:

• Vývojář spustí Aspire projekt v režimu ladění, stiskne F5.
• Aspire Řídicí panel a řídicí rovina pro vývojáře (DCP) se spouští.
• Konfigurace aplikace se spouští v projektu AppHost.
  • Proměnné prostředí OpenTelemetry se automaticky přidávají do projektů .NET během konfigurace aplikace.
  • DCP poskytuje název (OTEL_SERVICE_NAME) a ID (OTEL_RESOURCE_ATTRIBUTES) aplikace v exportované telemetrii.
  • Koncový bod OTLP je port HTTP/2 spuštěný řídicím panelem. Tento koncový bod je nastavený v proměnné prostředí OTEL_EXPORTER_OTLP_ENDPOINT v každém projektu. To dává projektům pokyn k exportu telemetrie zpět na řídicí panel.
  • Malé intervaly exportu (OTEL_BSP_SCHEDULE_DELAY, OTEL_BLRP_SCHEDULE_DELAY, OTEL_METRIC_EXPORT_INTERVAL), takže data jsou na řídicím panelu rychle dostupná. Malé hodnoty se používají v místním vývoji k určení priority odezvy řídicího panelu před efektivitou.
• Systém DCP spustí nakonfigurované projekty, kontejnery a spustitelné soubory.
• Po spuštění aplikace odesílají telemetrii na řídicí panel.
• Řídicí panel zobrazuje telemetrii všech Aspire projektů téměř v reálném čase.

Všechny tyto kroky probíhají interně, takže ve většině případů vývojář jednoduše potřebuje spustit aplikaci, aby tento proces viděl v akci.

Aspire nasazení

Aspire prostředí nasazení by měla nakonfigurovat OpenTelemetry proměnných prostředí, které mají smysl pro jejich prostředí. Například OTEL_EXPORTER_OTLP_ENDPOINT by mělo být nakonfigurované pro místní kolektor OTLP prostředí nebo službu monitorování.

Aspire Telemetrie funguje nejlépe v prostředích, která podporují OTLP. Export OTLP je zakázaný, pokud není nakonfigurovaný OTEL_EXPORTER_OTLP_ENDPOINT.

Další informace najdete v tématu Aspire nasazení.