Povolení 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 Application Insights. Distribuce OpenTelemetry služby Azure Monitor:

• 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.

Povolení OpenTelemetry pomocí Application Insights

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

Poznámka:

.NET se zabývá několika scénáři, včetně klasických ASP.NET, konzolových aplikací, model 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 core aplikace využívající oficiálně podporovanou verzi .NET

Tip

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

.NET

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

Tip

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 využívající oficiálně podporovanou verzi modulu runtime Node.js:
  • Podporované moduly 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 na některé z těchto vlastností spoléháte, pokračujte v distribuci OpenTelemetry služby Azure Monitor. Brzy vám poskytneme průvodce migrací.

Tip

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ší

Tip

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

Instalace klientské knihovny

ASP.NET Core

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

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

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

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Stáhněte soubor applicationinsights-agent-3.6.0.jar.

Upozorňující

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 kusovníky materiálů (BOM) OpenTelemetry.
• Přidejte závislost Spring Cloud azure Starter Monitoru .
• Postupujte podle těchto pokynů pro soubory JAR sady Azure SDK (Java Archive).

Nativní aplikace Quarkus :

• Přidejte závislost Quarkus OpenTelemetry 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

Azure.Monitor.OpenTelemetry.AspNetCore Naimportujte obor názvů, 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 exportér Azure Monitoru do každého signálu program.cs OpenTelemetry ve třídě:

// 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á správa je povolená prostřednictvím změn 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.6.0.jar" do prostředků 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ě konfigurace vzorkování najdete v tématu přepsání vzorkování.

Tip

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

Tip

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á správa je povolená prostřednictvím změn 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 the `configure_azure_monitor()` function from the
# `azure.monitor.opentelemetry` package.
from azure.monitor.opentelemetry import configure_azure_monitor

# Import the tracing api from the `opentelemetry` package.
from opentelemetry import trace

# Configure OpenTelemetry to use Azure Monitor with the 
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor()

Zkopírování 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.

Tip

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.

Kopírování připojovací řetězec:

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

Vložení 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 doporučené proměnné - prostředí

  Nahraďte <Your connection string> v následujícím příkazu připojovací řetězec.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Nastavení pouze přes konfigurační soubor - Java

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

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

  Nahraďte <Your connection string> v předchozím kódu JSON jedinečným připojovací řetězec.

• Nastavení pouze prostřednictvím kódu - ASP.NET Core, Node.js a Pythonu

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

Poznámka:

Pokud nastavíte připojovací řetězec na více místech, proměnná prostředí bude mít prioritu 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 v Aplikace Azure lication 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á aplikace Node.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.
• Pokud chcete povolit používání, povolte monitorování uživatelů ve webovém nebo 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.

.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.
• Pokud chcete povolit používání, povolte monitorování uživatelů ve webovém nebo 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.

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 možnosti konfigurace automatického nastavení Javy.
• 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 distrou OpenTelemetry služby Azure Monitor v aplikaci Java nativní image Spring Boot a exportéru Quarkus OpenTelemetry 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 imagí 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.
• Pokud chcete povolit používání, povolte monitorování uživatelů ve webovém nebo 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.

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 se službou Azure Monitor Application Insights a OpenTelemetry v ukázkové aplikaci Azure Monitoru.
• 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.
• Povolením monitorování uživatelů ve webovém nebo prohlížeči povolte možnosti používání.
• 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.