Povolte OpenTelemetry služby Azure Monitor pro aplikace .NET, Node.js, Python a Java

Tento článek popisuje, jak povolit a nakonfigurovat shromažďování dat založených na OpenTelemetry v rámci služby Azure Monitor Application Insights. Azure Monitor OpenTelemetry Distro:

• Poskytuje distribuci OpenTelemetry , která zahrnuje podporu funkcí specifických pro Azure Monitor.
• Umožňuje automatickou telemetrii zahrnutím knihoven instrumentace OpenTelemetry ke shromažďování trasování, metrik, protokolů a výjimek.
• Umožňuje shromažďovat vlastní telemetrii.
• Podporuje živé metriky pro monitorování a shromažďování dalších telemetrických dat z živých webových aplikací v produkčním prostředí.

Další informace o výhodách používání distrou OpenTelemetry služby Azure Monitor najdete v tématu Proč používat distro openTelemetry služby Azure Monitor.

Další informace o shromažďování dat pomocí OpenTelemetry najdete v tématu Základy shromažďování dat nebo nejčastější dotazy k OpenTelemetry.

Stav vydání OpenTelemetry

Nabídky OpenTelemetry jsou k dispozici pro aplikace .NET, Node.js, Python a Java. Informace o stavu vydání funkcí podle funkcí najdete v nejčastějších dotazech.

Poznámka:

Informace o aplikacích Funkcí Azure najdete v tématu Použití OpenTelemetry se službou Azure Functions.

Aktivujte OpenTelemetry pomocí Application Insights

Pomocí kroků v této části instrumentujte aplikaci pomocí OpenTelemetry. Vyberte kartu pro pokyny specifické pro jazyk.

Poznámka:

.NET podporuje několik scénářů, včetně klasického ASP.NET, konzolových aplikací, Windows Forms (WinForms) a dalších.

Požadavky

• Předplatné Azure: Bezplatné vytvoření předplatného Azure
• Prostředek Application Insights: Vytvoření prostředku Application Insights

ASP.NET Core

• ASP.NET základní aplikace využívající oficiálně podporovanou verzi .NET

Návod

Pokud migrujete z klasického rozhraní API Application Insights, prohlédni si naše dokumentace k migraci.

.NET

• Aplikace využívající podporovanou verzirozhraní .NET nebo .NET Framework 4.6.2 a novější.

Návod

Pokud migrujete z klasického rozhraní API Application Insights, prohlédni si naše dokumentace k migraci.

Java

• Aplikace v Javě s využitím Javy 8 nebo novější

Nativní Java

• Aplikace Java využívající GraalVM 17 nebo novější

Node.js

• Aplikace používající oficiálně podporovanou verzi modulu runtime Node.js:
  • Podporované runtime OpenTelemetry
  • Moduly runtime podporované exportérem OpenTelemetry pro Azure Monitor

Poznámka:

Pokud se nespoléháte na žádné vlastnosti uvedené v tabulce, které nejsou podporované, bude shim ApplicationInsights vaší nejjednodušší cestou vpřed po přechodu z beta verze.

Pokud se spoléháte na některou z těchto vlastností, pokračujte s distribucí OpenTelemetry pro Azure Monitor. Brzy vám poskytneme průvodce migrací.

Návod

Pokud migrujete z klasického rozhraní API Application Insights, prohlédni si naše dokumentace k migraci.

Python

• Aplikace Pythonu využívající Python 3.8 nebo novější

Návod

Pokud migrujete z OpenCensus, prohlédni si naše dokumentace k migraci.

Instalace klientské knihovny

ASP.NET Core

Nainstalujte nejnovější Azure.Monitor.OpenTelemetry.AspNetCorebalíček NuGet:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

Nainstalujte nejnovější Azure.Monitor.OpenTelemetry.Exporterbalíček NuGet:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Stáhněte si nejnovější soubor applicationinsights-agent-3.7.1.jar .

Varování

Pokud upgradujete ze starší verze 3.x, může to mít vliv na změnu výchozích hodnot nebo drobných rozdílů ve shromažďovaných datech. Další informace najdete v části migrace v poznámkách k verzi. 3.5.0, 3.4.0, 3.3.0, 3.2.0 a 3.1.0

Nativní Java

Nativní aplikace Spring Boot :

• Importujte seznam materiálů (BOM) OpenTelemetry.
• Přidejte závislost Spring Cloud Azure Starter Monitor.
• Postupujte podle těchto pokynů pro soubory JAR sady Azure SDK (Java Archive).

Nativní aplikace Quarkus :

• Přidejte závislost Quarkus OpenTelemetry Exporter pro Azure.

Node.js

Nainstalujte nejnovější balíček @azure/monitor-opentelemetry :

npm install @azure/monitor-opentelemetry

Následující balíčky se také používají pro některé konkrétní scénáře popsané dále v tomto článku:

• @opentelemetry/api
• @opentelemetry/sdk-metrics
• @opentelemetry/prostředky
• @opentelemetry/sémantické konvence
• @opentelemetry/sdk-trace-base

npm install @opentelemetry/api
npm install @opentelemetry/sdk-metrics
npm install @opentelemetry/resources
npm install @opentelemetry/semantic-conventions
npm install @opentelemetry/sdk-trace-base

Python

Nainstalujte nejnovější balíček PyPI azure-monitor-opentelemetry :

pip install azure-monitor-opentelemetry

Úprava aplikace

ASP.NET Core

Importujte obor názvů Azure.Monitor.OpenTelemetry.AspNetCore, přidejte OpenTelemetry a nakonfigurujte ho tak, aby používal Azure Monitor ve vaší program.cs třídě.

// Import the Azure.Monitor.OpenTelemetry.AspNetCore namespace.
using Azure.Monitor.OpenTelemetry.AspNetCore;

var builder = WebApplication.CreateBuilder(args);

// Add OpenTelemetry and configure it to use Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor();

var app = builder.Build();

app.Run();

.NET

Přidejte Azure Monitor exportér ke každému OpenTelemetry signálu ve třídě program.cs.

// Create a new tracer provider builder and add an Azure Monitor trace exporter to the tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/trace#tracerprovider-management
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter();

// Add an Azure Monitor metric exporter to the metrics provider builder.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics#meterprovider-management
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddAzureMonitorMetricExporter();

// Create a new logger factory.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/logs#logger-management
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        logging.AddAzureMonitorLogExporter();
    });
});

Poznámka:

Další informace najdete v kurzu Začínáme pro OpenTelemetry .NET.

Java

Automatická instrumentace se povoluje změnami konfigurace. Nejsou vyžadovány žádné změny kódu.

Nasměrujte virtuální počítač Java (JVM) na soubor jar přidáním -javaagent:"path/to/applicationinsights-agent-3.7.1.jar" do argumentů JVM vaší aplikace.

Poznámka:

Vzorkování je ve výchozím nastavení povolené rychlostí 5 požadavků za sekundu a pomáhá tak s řízením nákladů. Ve scénářích překračujících tuto rychlost můžou chybět telemetrická data. Další informace o úpravách konfigurace vzorkování naleznete v části přepisy vzorkování. Pokud se vám v Application Insights zobrazují neočekávané poplatky nebo vysoké náklady, může vám pomoct tento průvodce. Zahrnuje běžné příčiny, jako jsou vysoké objemy telemetrie, špičky příjmu dat a chybně nakonfigurované vzorkování. Je zvlášť užitečné, pokud řešíte problémy související se špičkami nákladů, objemem telemetrie, nefunkčním vzorkováním, limity dat, vysokým příjmem dat nebo neočekávanou fakturací. Pokud chcete začít, přečtěte si téma Řešení potíží s vysokým příjmem dat ve službě Application Insights.

Návod

Pokyny specifické pro konkrétní scénář najdete v tématu Začínáme (doplňkové).

Návod

Pokud vyvíjíte aplikaci Spring Boot, můžete volitelně nahradit argument JVM programovou konfigurací. Další informace najdete v tématu Použití služby Azure Monitor Application Insights se spring bootem.

Nativní Java

Automatická instrumentace se povoluje změnami konfigurace. Nejsou vyžadovány žádné změny kódu.

Node.js

// Import the `useAzureMonitor()` function from the `@azure/monitor-opentelemetry` package.
const { useAzureMonitor } = require("@azure/monitor-opentelemetry");

// Call the `useAzureMonitor()` function to configure OpenTelemetry to use Azure Monitor.
useAzureMonitor();

Python

import logging
# Import the `configure_azure_monitor()` function from the
# `azure.monitor.opentelemetry` package.
from azure.monitor.opentelemetry import configure_azure_monitor

# Configure OpenTelemetry to use Azure Monitor with the 
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor(
    logger_name="<your_logger_namespace>",  # Set the namespace for the logger in which you would like to collect telemetry for if you are collecting logging telemetry. This is imperative so you do not collect logging telemetry from the SDK itself.
)
logger = logging.getLogger("<your_logger_namespace>")  # Logging telemetry will be collected from logging calls made with this logger and all of it's children loggers.

Zkopírujte připojovací řetězec z prostředku Application Insights.

Připojovací řetězec je jedinečný a určuje, kde distro Služby Azure Monitor OpenTelemetry odesílá telemetrii, která shromažďuje.

Návod

Pokud ještě prostředek Application Insights nemáte, vytvořte si ho podle tohoto průvodce. Místo použití existujícího prostředku doporučujeme vytvořit nový prostředek.

Nakopírovat připojovací řetězec:

1. Přejděte do podokna Přehled prostředku Application Insights.
2. Najděte připojovací řetězec.
3. Najeďte myší na připojovací řetězec a vyberte ikonu Kopírovat do schránky .

Vložte připojovací řetězec do prostředí

Pokud chcete vložit připojovací řetězec, vyberte z následujících možností:

Důležité

Doporučujeme nastavit připojovací řetězec prostřednictvím kódu pouze v místním vývojovém a testovacím prostředí.

V produkčním prostředí použijte proměnnou prostředí nebo konfigurační soubor (pouze Java).

• Nastavení prostřednictvím proměnné prostředí - doporučeno

  Nahraďte <Your connection string> ve následujícím příkazu vaším připojovacím řetězcem.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Nastavení prostřednictvím konfiguračního souboru - Pouze Java

  Vytvořte konfigurační soubor s názvem applicationinsights.jsona umístěte ho do stejného adresáře jako applicationinsights-agent-3.7.1.jar s následujícím obsahem:

  {
    "connectionString": "<Your connection string>"
  }
  

  Nahraďte <Your connection string> v předchozím JSONu svým jedinečným připojovacím řetězcem.

• Nastavení prostřednictvím kódu - pouze ASP.NET Core, Node.jsa Python

  Příklad nastavení připojovacího řetězce prostřednictvím kódu najdete v konfiguraci připojovacího řetězce .

Poznámka:

Pokud nastavíte připojovací řetězec na více místech, bude upřednostněna proměnná prostředí v následujícím pořadí:

1. Kód
2. Proměnná prostředí
3. Konfigurační soubor

Potvrzení toku dat

Spusťte aplikaci a pak otevřete Application Insights na webu Azure Portal. Zobrazení dat může trvat několik minut.

Application Insights je teď pro vaši aplikaci povolená. Následující kroky jsou volitelné a umožňují další přizpůsobení.

Důležité

Pokud máte dvě nebo více služeb, které generují telemetrii do stejného prostředku Application Insights, musíte nastavit názvy cloudových rolí tak, aby je správně představovaly na mapě aplikace.

V rámci instrumentace Application Insights shromažďujeme a odesíláme diagnostická data do Microsoftu. Tato data nám pomáhají spouštět a vylepšovat Application Insights. Další informace najdete v tématu Statsbeat ve službě Azure Application Insights.

Ukázkové aplikace

Ukázkové aplikace Azure Monitor OpenTelemetry jsou dostupné pro všechny podporované jazyky:

• ukázková aplikace ASP.NET Core
• Ukázková aplikace NET
• Ukázkové aplikace v Javě
• Nativní ukázkové aplikace Java GraalVM
• ukázková aplikaceNode.js
• Ukázkové aplikace v Pythonu

Další kroky

ASP.NET Core

• Podrobnosti o přidávání a úpravách OpenTelemetry služby Azure Monitor najdete v tématu Přidání a úprava OpenTelemetry služby Azure Monitor.
• Další konfiguraci distribuce OpenTelemetry najdete v tématu Konfigurace OpenTelemetry služby Azure Monitor.
• Informace o zdrojovém kódu najdete v úložišti Azure Monitor AspNetCore na GitHubu.
• Pokud chcete nainstalovat balíček NuGet, vyhledat aktualizace nebo zobrazit poznámky k verzi, podívejte se na stránku balíčku NuGet AspNetCore služby Azure Monitor .
• Pokud se chcete seznámit se službou Azure Monitor a OpenTelemetry, podívejte se na ukázkovou aplikaci Azure Monitoru.
• Další informace o OpenTelemetry a její komunitě najdete v úložišti OpenTelemetry .NET Na GitHubu.
• Aby bylo možné povolit uživatelské zkušenosti, povolte sledování uživatelů webu nebo prohlížeče.
• Pokud chcete zkontrolovat nejčastější dotazy, postup řešení potíží, možnosti podpory nebo poskytnout zpětnou vazbu k OpenTelemetry, přečtěte si nápovědu k OpenTelemetry, podporu a zpětnou vazbu pro Azure Monitor Application Insights.

.NET

• Podrobnosti o přidávání a úpravách OpenTelemetry služby Azure Monitor najdete v tématu Přidání a úprava OpenTelemetry služby Azure Monitor.
• Další konfiguraci distribuce OpenTelemetry najdete v tématu Konfigurace OpenTelemetry služby Azure Monitor.
• Pokud chcete zkontrolovat zdrojový kód, projděte si úložiště GitHubu exportéru služby Azure Monitor.
• Pokud chcete nainstalovat balíček NuGet, vyhledat aktualizace nebo zobrazit poznámky k verzi, podívejte se na stránku balíčku NuGet exportéru služby Azure Monitor .
• Pokud se chcete seznámit se službou Azure Monitor a OpenTelemetry, podívejte se na ukázkovou aplikaci Azure Monitoru.
• Další informace o OpenTelemetry a její komunitě najdete v úložišti OpenTelemetry .NET Na GitHubu.
• Aby bylo možné povolit uživatelské zkušenosti, povolte sledování uživatelů webu nebo prohlížeče.
• Pokud chcete zkontrolovat nejčastější dotazy, postup řešení potíží, možnosti podpory nebo poskytnout zpětnou vazbu k OpenTelemetry, přečtěte si nápovědu k OpenTelemetry, podporu a zpětnou vazbu pro Azure Monitor Application Insights.

Java

• Podrobnosti o přidávání a úpravách OpenTelemetry služby Azure Monitor najdete v tématu Přidání a úprava OpenTelemetry služby Azure Monitor.
• Přehled možností konfigurace autoinstrumentace pro Java.
• Zkontrolujte zdrojový kód v úložišti GitHubu pro automatickou správu Java služby Azure Monitor.
• Přečtěte si další informace o OpenTelemetry a její komunitě v úložišti OpenTelemetry Java Na GitHubu.
• Pokud chcete povolit možnosti použití, prohlédněte si možnost Povolit monitorování uživatelů ve webovém prohlížeči.
• Projděte si poznámky k verzi na GitHubu.
• Pokud chcete zkontrolovat nejčastější dotazy, postup řešení potíží, možnosti podpory nebo poskytnout zpětnou vazbu k OpenTelemetry, přečtěte si nápovědu k OpenTelemetry, podporu a zpětnou vazbu pro Azure Monitor Application Insights.

Nativní Java

• Podrobnosti o přidávání a úpravách OpenTelemetry služby Azure Monitor najdete v tématu Přidání a úprava OpenTelemetry služby Azure Monitor.
• Projděte si zdrojový kód v Azure Monitor OpenTelemetry distribuci v Java aplikaci s nativním obrazem Spring Boot a Quarkus OpenTelemetry exportéru pro Azure.
• Přečtěte si další informace o OpenTelemetry a její komunitě v úložišti OpenTelemetry Java Na GitHubu.
• Další informace o funkcích nativních obrazů aplikací Spring Boot v úvodní sadě OpenTelemetry SpringBoot
• Další informace o funkcích nativních aplikací Quarkus najdete v exportéru Quarkus OpenTelemetry pro Azure.
• Projděte si poznámky k verzi na GitHubu.
• Pokud chcete zkontrolovat nejčastější dotazy, postup řešení potíží, možnosti podpory nebo poskytnout zpětnou vazbu k OpenTelemetry, přečtěte si nápovědu k OpenTelemetry, podporu a zpětnou vazbu pro Azure Monitor Application Insights.

Node.js

• Podrobnosti o přidávání a úpravách OpenTelemetry služby Azure Monitor najdete v tématu Přidání a úprava OpenTelemetry služby Azure Monitor.
• Pokud chcete zkontrolovat zdrojový kód, projděte si úložiště Azure Monitor OpenTelemetry na GitHubu.
• Pokud chcete nainstalovat balíček npm a vyhledat aktualizace, podívejte se na @azure/monitor-opentelemetry stránku balíček npm .
• Pokud se chcete seznámit se službou Azure Monitor Application Insights a OpenTelemetry, podívejte se na ukázkovou aplikaci služby Azure Monitor.
• Další informace o OpenTelemetry a její komunitě najdete v úložišti OpenTelemetry JavaScript Na GitHubu.
• Aby bylo možné povolit uživatelské zkušenosti, povolte sledování uživatelů webu nebo prohlížeče.
• Pokud chcete zkontrolovat nejčastější dotazy, postup řešení potíží, možnosti podpory nebo poskytnout zpětnou vazbu k OpenTelemetry, přečtěte si nápovědu k OpenTelemetry, podporu a zpětnou vazbu pro Azure Monitor Application Insights.

Python

• Podrobnosti o přidávání a úpravách OpenTelemetry služby Azure Monitor najdete v tématu Přidání a úprava OpenTelemetry služby Azure Monitor.
• Projděte si zdrojový kód a další dokumentaci v úložišti Azure Monitor Distro Na GitHubu.
• Podívejte se na další ukázky a případy použití v ukázkách distribuce služby Azure Monitor.
• Projděte si protokol změn na GitHubu.
• Nainstalujte balíček PyPI, vyhledejte aktualizace nebo si prohlédněte poznámky k verzi na stránce balíčku PyPI služby Azure Monitor .
• Seznamte se blíže se službou Azure Monitor Application Insights a OpenTelemetry v příkladové aplikaci Azure Monitor.
• Přečtěte si další informace o OpenTelemetry a její komunitě v úložišti GitHub v Pythonu OpenTelemetry.
• Podívejte se na dostupné instrumentace a komponenty OpenTelemetry v úložišti Python GitHub přispěvatele OpenTelemetry.
• Umožněte zážitky z užívání povolením monitorování uživatelů ve webovém prohlížeči.
• Pokud chcete zkontrolovat nejčastější dotazy, postup řešení potíží, možnosti podpory nebo poskytnout zpětnou vazbu k OpenTelemetry, přečtěte si nápovědu k OpenTelemetry, podporu a zpětnou vazbu pro Azure Monitor Application Insights.