OpenTelemetry v rámci Azure SDK pro "crates" Rust

Když pracujete se sadou Azure SDK for Rust, potřebujete přehled o operacích sady SDK, abyste mohli ladit problémy, monitorovat výkon a pochopit, jak vaše aplikace komunikuje se službami Azure. V tomto článku se dozvíte, jak implementovat efektivní strategie protokolování a telemetrie založené na OpenTelemetry, které poskytují přehled o vnitřních fungování aplikací Rust v Azure.

Telemetrie pro vývojáře Azure

Sada Azure SDK for Rust poskytuje komplexní pozorovatelnost prostřednictvím integrace OpenTelemetry, kterou doporučujeme pro scénáře monitorování a distribuovaného trasování. Ať už řešíte problémy s toky ověřování, monitorováním cyklů požadavků rozhraní API nebo analýzou kritických bodů výkonu, tento průvodce se zabývá nástroji a technikami OpenTelemetry, které potřebujete k získání přehledu o operacích se sadou Azure SDK.

Azure SDK pro Rust balíčky používá OpenTelemetry jako standardní přístup ke sledovatelnosti a nabízí:

• Standardní telemetrie: Použití formátů OpenTelemetry kompatibilních s monitorovacími platformami
• Distribuované trasování: Sledování požadavků napříč několika službami a prostředky Azure
• Pokročilí vývozci: Odesílání dat do Jaegeru, Prometheus, Grafana a dalších platforem pozorovatelnosti
• Korelace mezi službami: Automatické šíření kontextu trasování mezi mikroslužby
• Monitorování v produkčním prostředí: Vytvořeno pro vysoce škálovaná produkční prostředí s využitím vzorkování a optimalizace výkonu

Nastavení protokolování OpenTelemetry

Chcete-li použít OpenTelemetry, potřebujete azure_core_opentelemetry bednu. Samotný azure_core balíček nezahrnuje podporu OpenTelemetry.

1. Přihlaste se k Azure CLI:

   az login
   

2. Vytváření prostředků Azure Monitoru pomocí Azure CLI:

   # Set variables
   RESOURCE_GROUP="rust-telemetry-rg"
   LOCATION="eastus"
   APP_INSIGHTS_NAME="rust-app-insights"
   LOG_ANALYTICS_WORKSPACE="rust-logs-workspace"
   
   # Create resource group
   az group create --name $RESOURCE_GROUP --location $LOCATION
   
   # Create Log Analytics workspace
   WORKSPACE_ID=$(az monitor log-analytics workspace create \
     --resource-group $RESOURCE_GROUP \
     --workspace-name $LOG_ANALYTICS_WORKSPACE \
     --location $LOCATION \
     --query id -o tsv)
   
   # Create Application Insights instance
   az extension add --name application-insights
   INSTRUMENTATION_KEY=$(az monitor app-insights component create \
     --app $APP_INSIGHTS_NAME \
     --location $LOCATION \
     --resource-group $RESOURCE_GROUP \
     --workspace $WORKSPACE_ID \
     --query instrumentationKey -o tsv)
   
   # Get connection string
   CONNECTION_STRING=$(az monitor app-insights component show \
     --app $APP_INSIGHTS_NAME \
     --resource-group $RESOURCE_GROUP \
     --query connectionString -o tsv)
   
   echo "Application Insights Connection String: $CONNECTION_STRING"
   

3. Nakonfigurujte projekt Rust. Přidejte požadované závislosti do :Cargo.toml

   [dependencies]
   azure_core_opentelemetry = "*"
   azure_security_keyvault_secrets = "*"
   azure_identity = "*"
   opentelemetry = "0.31"
   opentelemetry_sdk = "0.31"
   opentelemetry-otlp = "0.31"  # For exporting to OpenTelemetry Collector
   tokio = { version = "1.47.1", features = ["full"] }
   

   Poznámka:

   Tato opentelemetry-otlp bedna je součástí exportu telemetrických dat do kolektoru OpenTelemetry, který pak může předávat data do služby Azure Monitor. Přímý export do Azure Monitoru z aplikací v jazyce Rust není podporován.

4. Vytvořte hlavní aplikaci s konfigurací OpenTelemetry. Podrobnosti najdete v azure_core_opentelemetry dokumentaci.

5. Nastavte požadované proměnné prostředí a spusťte aplikaci:

   # Set Key Vault URL (replace with your actual Key Vault URL)
   export AZURE_KEYVAULT_URL="https://mykeyvault.vault.azure.net/"
   
   # Run the application
   cargo run
   

Jakmile ve své aplikaci nakonfigurujete OpenTelemetry a spustíte ji, můžete přidat vlastní instrumentaci a monitorovat telemetrická data.

Export telemetrie do služby Azure Monitor

Vzhledem k tomu, že Rust nemá přímý exportér OpenTelemetry pro Azure Monitor, musíte implementovat nepřímý přístup k získání telemetrických dat do služby Azure Monitor. Tady jsou doporučené metody:

Možnost 1: Kolektor OpenTelemetry (doporučeno)

Kolekce OpenTelemetry funguje jako střední vrstva, která může přijímat telemetrická data z vaší aplikace Rust a předávat ji do služby Azure Monitor:

1. Nasaďte OpenTelemetry Collector ve vašem prostředí (jako sidecar, agent nebo brána)
2. Konfigurace aplikace Rust pro export do kolektoru pomocí protokolu OTLP (OpenTelemetry Protocol)
3. Konfigurujte kolektor s exportérem Azure Monitoru pro odesílání dat do Application Insights

Možnost 2: Azure Storage + rozhraní API pro příjem dat

Ve scénářích, ve kterých potřebujete větší kontrolu nad zpracováním dat:

1. Export telemetrie do služby Azure Storage (Blob Storage nebo Datové Jezero)
2. Zpracování dat pomocí Azure Functions, Logic Apps nebo vlastních aplikací
3. Příjem zpracovaných dat do služby Azure Monitor pomocí rozhraní API pro příjem protokolů

Možnost 3: Streamování služby Event Hubs

Pro zpracování telemetrie v reálném čase:

1. Streamování telemetrie do služby Azure Event Hubs z aplikace Rust
2. Zpracování událostí pomocí Azure Stream Analytics, Azure Functions nebo vlastních příjemců
3. Předávání zpracovaných telemetrických dat do služby Azure Monitor nebo Application Insights

Přizpůsobení telemetrických dat

OpenTelemetry poskytuje flexibilní architekturu pro přizpůsobení telemetrických dat tak, aby vyhovovala potřebám vaší aplikace. Pomocí těchto strategií můžete vylepšit telemetrii:

Instrumentujte kód aplikace

Přidání vlastní instrumentace do kódu aplikace vám pomůže korelovat obchodní logiku s operacemi sady Azure SDK. Tato korelace usnadňuje pochopení kompletního toku operací.

Analýza výkonu

OpenTelemetry poskytuje podrobné přehledy o vzorech výkonu sady Azure SDK. Tyto přehledy vám pomůžou identifikovat a vyřešit kritické body výkonu.

Diagnostika chyb

OpenTelemetry zachycuje bohatý kontext chyb, který přesahuje jednoduché chybové zprávy. Tento kontext vám pomůže pochopit nejen to, co selhalo, ale proč a za jakých okolností.

Vysvětlení šíření chyb sady SDK: Trasujte, jak chyby procházejí kódem vaší aplikace a vrstvami sady Azure SDK. Toto trasování vám pomůže pochopit úplnou cestu k chybě a identifikovat původní příčinu.

Protokol přechodných a trvalých selhání: Rozlišovat mezi dočasnými selháními (například vypršením časového limitu sítě, které můžou při opakování proběhnout úspěšně) a trvalými selháními (například chybami ověřování, které vyžadují změny konfigurace). Tento rozdíl vám pomůže vytvářet odolné aplikace.

Porozumění protokolům, metrikám a upozorněním

Vaše aplikace a služby generují telemetrická data, která vám pomůžou monitorovat jejich stav, výkon a využití. Azure tuto telemetrii kategorizuje do protokolů, metrik a upozornění.

Azure nabízí čtyři druhy telemetrie:

Vyberte správnou telemetrii pro vaši otázku:

Zobrazení telemetrických dat ve službě Azure Monitor

Po nastavení OpenTelemetry v aplikaci Rust a konfiguraci přechodného mechanismu exportu můžete zobrazit telemetrická data ve službě Azure Monitor prostřednictvím Application Insights. Vzhledem k tomu, že Rust nemá přímé možnosti exportu služby Azure Monitor, budete muset implementovat jeden z těchto přístupů:

• OpenTelemetry Collector: Nakonfigurujte kolekci OpenTelemetry tak, aby přijímala data z vaší aplikace Rust a předávala je do služby Azure Monitor.
• Integrace služby Azure Storage: Export telemetrie do služby Azure Storage a použití rozhraní API pro příjem dat služby Azure Monitor k importu dat
• Streamování služby Event Hubs: Streamování telemetrie prostřednictvím služby Azure Event Hubs a jejich zpracování pro příjem dat ve službě Azure Monitor

Jakmile vaše telemetrická data dosáhnou služby Azure Monitor prostřednictvím jedné z těchto metod, můžete je analyzovat:

1. Na webu Azure Portal přejděte na Application Insights:

   az monitor app-insights component show \
     --app $APP_INSIGHTS_NAME \
     --resource-group $RESOURCE_GROUP \
     --query "{name:name,appId:appId,instrumentationKey:instrumentationKey}"
   

2. Zobrazení trasování a záznamů:

   • Přejít navyhledávání transakcí>
   • Hledejte stopy s názvy operací, například get_keyvault_secrets
   • Zkontrolujte část Protokoly a spusťte dotazy KQL:

   traces
   | where timestamp > ago(1h)
   | where message contains "Azure operations" or message contains "secrets"
   | order by timestamp desc
   

3. Zobrazit distribuované trasování:

   • Přejděte na mapu aplikace a zobrazte závislosti služeb.
   • Vyberte Výkon pro zobrazení časování operací.
   • Zobrazení úplných toků požadavků pomocí podrobných podrobností o transakcích

4. Vlastní dotazy KQL pro vaši aplikaci Rust:

   // View all custom logs from your Rust app
   traces
   | where customDimensions.["service.name"] == "rust-azure-app"
   | order by timestamp desc
   
   // View Azure SDK HTTP operations
   dependencies
   | where type == "HTTP"
   | where target contains "vault.azure.net"
   | order by timestamp desc
   
   // Monitor error rates
   traces
   | where severityLevel >= 3  // Warning and above
   | summarize count() by bin(timestamp, 1m), severityLevel
   | render timechart
   

Monitorování v reálném čase

Nastavte živé monitorování, abyste viděli data při jejich doručení:

# Stream live logs (requires Azure CLI)
az monitor app-insights events show \
  --app $APP_INSIGHTS_NAME \
  --resource-group $RESOURCE_GROUP \
  --event traces \
  --start-time $(date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%S)

Optimalizace nákladů

Náklady na Azure Monitor můžete výrazně snížit pochopením osvědčených postupů pro možnosti konfigurace a příležitostí ke snížení množství dat, která Azure Monitor shromažďuje.

Klíčové strategie pro aplikace Rust:

• Použijte odpovídající úrovně protokolů: Odpovídajícím způsobem nakonfigurujte úrovně protokolů OpenTelemetry pro produkční prostředí, aby se snížil objem.
• Implementace vzorkování: Konfigurace vzorkování OpenTelemetry pro aplikace s velkým objemem
• Filtrování citlivých dat: Vyhněte se protokolování tajných kódů, tokenů nebo velkých datových částí, které zvyšují náklady.
• Monitorování zpracování dat: Pravidelně kontrolujte využití dat a náklady spojené s Application Insights

Zdroje informací a další kroky

• Pokyny pro Azure SDK for Rust
• Dokumentace k OpenTelemetry Rust
• Služba Azure Monitor