Włączanie usługi Azure Monitor OpenTelemetry dla aplikacji .NET, Node.js, Python i Java

W tym artykule opisano sposób włączania i konfigurowania zbierania danych opartych na protokole OpenTelemetry w celu obsługi środowisk w usłudze Azure Monitor Application Insights. Omówimy sposób instalowania dystrybucji OpenTelemetry usługi Azure Monitor. Dystrybucja OpenTelemetry usługi Azure Monitor udostępnia dystrybucję OpenTelemetry, która obejmuje obsługę funkcji specyficznych dla usługi Azure Monitor. Dystrybucja umożliwia automatyczne telemetrię, włączając biblioteki instrumentacji OpenTelemetry do zbierania śladów, metryk, dzienników i wyjątków oraz umożliwia zbieranie niestandardowych danych telemetrycznych. Możesz również użyć funkcji Metryki na żywo zawartej w dystrybucji, aby monitorować i zbierać więcej danych telemetrycznych z dynamicznych aplikacji internetowych w środowisku produkcyjnym. Aby uzyskać więcej informacji na temat zalet korzystania z dystrybucji OpenTelemetry usługi Azure Monitor, zobacz Dlaczego należy używać dystrybucji "Azure Monitor OpenTelemetry"?.

Aby dowiedzieć się więcej na temat zbierania danych przy użyciu biblioteki OpenTelemetry, zobacz Często zadawane pytania dotyczące zbierania danych lub OpenTelemetry.

Stan wydania OpenTelemetry

Oferty OpenTelemetry są dostępne dla aplikacji .NET, Node.js, Python i Java.

Uwaga

• Aby uzyskać stan wersji funkcji po funkcji, zobacz często zadawane pytania.
• Druga karta tego artykułu obejmuje wszystkie scenariusze platformy .NET, w tym klasyczne ASP.NET, aplikacje konsolowe, formularze systemu Windows (WinForms) itp.

Rozpocznij

Wykonaj kroki opisane w tej sekcji, aby instrumentować aplikację przy użyciu funkcji OpenTelemetry.

Wymagania wstępne

• Subskrypcja platformy Azure: tworzenie bezpłatnej subskrypcji platformy Azure
• Zasób usługi Application Insights: tworzenie zasobu usługi Application Insights

ASP.NET Core

• ASP.NET Core Application przy użyciu oficjalnie obsługiwanej wersji platformy .NET

.NET

• Aplikacja korzystająca z oficjalnie obsługiwanej wersji programu .NET Core lub .NET Framework , która jest co najmniej .NET Framework 4.6.2

Java

• Aplikacja Java korzystająca z języka Java 8 lub nowszego

Java Native

• Aplikacja Java korzystająca z maszyny GraalVM 17+

Node.js

Uwaga

Jeśli korzystasz z żadnych właściwości w tabeli nieobsługiwanej, użyj dystrybucji i wkrótce udostępnimy przewodnik migracji. Jeśli tak nie jest, podkładka usługi App Insights jest najprostszą ścieżką do przodu, gdy jest poza wersją beta.

• Aplikacja korzystająca z oficjalnie obsługiwanej wersji środowiska uruchomieniowego Node.js:
  • Obsługiwane środowiska uruchomieniowe OpenTelemetry
  • Obsługiwane środowiska uruchomieniowe eksportera OpenTelemetry w usłudze Azure Monitor

Python

• Aplikacja języka Python korzystająca z języka Python w wersji 3.8 lub nowszej

Instalowanie biblioteki klienta

ASP.NET Core

Zainstaluj najnowszy Azure.Monitor.OpenTelemetry.AspNetCore pakiet NuGet:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

Zainstaluj najnowszy Azure.Monitor.OpenTelemetry.Exporter pakiet NuGet:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Pobierz plik applicationinsights-agent-3.5.3.jar.

Ostrzeżenie

W przypadku uaktualniania z wcześniejszej wersji 3.x może to mieć wpływ na zmianę wartości domyślnych lub niewielkie różnice w zbieranych danych. Aby uzyskać więcej informacji, zobacz sekcję migracji w informacjach o wersji. 3.5.0, 3.4.0, 3.3.0, 3.2.0 i 3.1.0

Java Native

W przypadku aplikacji natywnych platformy Spring Boot:

• Zaimportuj rachunki za materiały OpenTelemetry (BOM).
• Dodaj zależność usługi Spring Cloud Azure Starter Monitor.
• Postępuj zgodnie z tymi instrukcjami dla plików JAR (Java Archive) zestawu Azure SDK.

W przypadku aplikacji natywnych quarkus:

• Dodaj eksportera Quarkus OpenTelemetry dla zależności platformy Azure.

Node.js

Zainstaluj następujące pakiety:

• @azure/monitor-opentelemetry

npm install @azure/monitor-opentelemetry

Następujące pakiety są również używane w niektórych konkretnych scenariuszach opisanych w dalszej części tego artykułu:

• @opentelemetry/api
• @opentelemetry/sdk-metrics
• @opentelemetry/zasoby
• @opentelemetry/konwencje semantyczne
• @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

Zainstaluj najnowszy pakiet PyPI azure-monitor-opentelemetry :

pip install azure-monitor-opentelemetry

Włączanie usługi Azure Monitor Application Insights

Aby włączyć usługę Azure Monitor Application Insights, należy wprowadzić drobne modyfikacje aplikacji i ustawić "Parametry połączenia". Parametry połączenia informują aplikację, gdzie mają być wysyłane dane telemetryczne zbierane przez dystrybucję i są unikatowe dla Ciebie.

Modyfikowanie aplikacji

ASP.NET Core

Dodaj UseAzureMonitor() element do uruchamiania aplikacji znajdujący się w program.cs klasie .

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

// Create a new WebApplicationBuilder instance.
var builder = WebApplication.CreateBuilder(args);

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

// Build the application.
var app = builder.Build();

// Run the application.
app.Run();

.NET

Dodaj eksportera usługi Azure Monitor do każdego sygnału OpenTelemetry podczas uruchamiania aplikacji. W zależności od używanej wersji platformy .NET jest ona w klasie startup.cs lub 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(options =>
    {
        options.AddAzureMonitorLogExporter();
    });
});

Uwaga

Aby uzyskać więcej informacji, zobacz samouczek wprowadzający dla platformy .NET OpenTelemetry.

Java

Autoinstrumentacja języka Java jest włączona za pomocą zmian konfiguracji; nie są wymagane żadne zmiany kodu.

Wskaż maszynę wirtualną Java (JVM) do pliku jar, dodając -javaagent:"path/to/applicationinsights-agent-3.5.3.jar" do args maszyny wirtualnej JVM aplikacji.

Napiwek

Próbkowanie jest domyślnie włączone w tempie 5 żądań na sekundę, co ułatwia zarządzanie kosztami. W scenariuszach przekraczających tę częstotliwość mogą brakować danych telemetrycznych. Aby uzyskać więcej informacji na temat modyfikowania konfiguracji próbkowania, zobacz przesłonięcia próbkowania.

Napiwek

Aby uzyskać wskazówki specyficzne dla scenariusza, zobacz Wprowadzenie (uzupełnienie).

Napiwek

Jeśli tworzysz aplikację Spring Boot, opcjonalnie możesz zastąpić argument JVM konfiguracją programową. Aby uzyskać więcej informacji, zobacz Using Azure Monitor Application Insights with Spring Boot (Korzystanie z usługi Azure Monitor Application Insights z platformą Spring Boot).

Java Native

Kilka automatycznych instrumentacji jest włączanych za pomocą zmian konfiguracji; nie są wymagane żadne zmiany w kodzie

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()

Kopiowanie parametrów połączenia z zasobu usługi Application Insights

Napiwek

Jeśli jeszcze go nie masz, możesz teraz utworzyć zasób usługi Application Insights. W tym przypadku zalecamy utworzenie nowego zasobu usługi Application Insights w porównaniu z użyciem istniejącego zasobu.

Aby skopiować unikatowe parametry połączenia:

1. Przejdź do okienka Przegląd zasobu usługi Application Insights.
2. Znajdź parametry połączenia.
3. Umieść kursor na parametry połączenia i wybierz ikonę Kopiuj do schowka.

Wklej parametry połączenia w środowisku

Aby wkleić parametry połączenia, wybierz następujące opcje:

Odp. Ustawianie za pomocą zmiennej środowiskowej (zalecane)

Zastąp <Your Connection String> ciąg w poniższym poleceniu unikatowym parametry połączenia.

APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>

B. Ustawianie za pomocą pliku konfiguracji — tylko język Java (zalecane)

Utwórz plik konfiguracji o nazwie applicationinsights.jsoni umieść go w tym samym katalogu, co applicationinsights-agent-3.5.3.jar w przypadku następującej zawartości:

{
  "connectionString": "<Your Connection String>"
}

Zastąp <Your Connection String> element w poprzednim formacie JSON unikatowym parametry połączenia.

C. Ustaw za pomocą kodu — ASP.NET Core, Node.js i Tylko język Python (niezalecane)

Zobacz Konfiguracja parametrów połączenia, aby zapoznać się z przykładem ustawienia parametrów połączenia za pomocą kodu.

Uwaga

Jeśli ustawisz parametry połączenia w więcej niż jednym miejscu, przestrzegamy następującego pierwszeństwa:

1. Kod
2. Zmienna środowiskowa
3. Plik konfiguracji

Potwierdzanie, że dane przepływają

Uruchom aplikację i otwórz kartę Zasób usługi Application Insights w witrynie Azure Portal. Wyświetlenie danych w portalu może potrwać kilka minut.

Usługa Application Insights jest teraz włączona dla aplikacji. Wszystkie poniższe kroki są opcjonalne i umożliwiają dalsze dostosowywanie.

Ważne

Jeśli masz co najmniej dwie usługi, które emitują dane telemetryczne do tego samego zasobu usługi Application Insights, musisz ustawić nazwy ról w chmurze, aby reprezentować je prawidłowo na mapie aplikacji.

W ramach instrumentacji usługi Application Insights zbieramy i wysyłamy dane diagnostyczne do firmy Microsoft. Te dane pomagają nam uruchamiać i ulepszać usługę Application Insights. Aby dowiedzieć się więcej, zobacz Statsbeat in aplikacja systemu Azure Insights (Statystyki w usłudze aplikacja systemu Azure Insights).

Przykłady

Przykładowe aplikacje OpenTelemetry w usłudze Azure Monitor są dostępne dla wszystkich obsługiwanych języków.

ASP.NET Core

• przykładowa aplikacja ASP.NET Core

.NET

• Przykładowa aplikacja platformy NET

Java

• Przykładowe aplikacje w języku Java

Java Native

• Przykładowe aplikacje java GraalVM

Node.js

• przykładowa aplikacja Node.js

Python

• Przykładowe aplikacje języka Python

Następne kroki

ASP.NET Core

• Aby uzyskać szczegółowe informacje na temat dodawania i modyfikowania usługi Azure Monitor OpenTelemetry, zobacz Dodawanie i modyfikowanie funkcji OpenTelemetry usługi Azure Monitor.
• Aby jeszcze bardziej skonfigurować dystrybucję OpenTelemetry, zobacz Azure Monitor OpenTelemetry configuration (Konfiguracja biblioteki OpenTelemetry w usłudze Azure Monitor).
• Aby przejrzeć kod źródłowy, zobacz repozytorium GitHub aspnetcore usługi Azure Monitor.
• Aby zainstalować pakiet NuGet, sprawdź dostępność aktualizacji lub wyświetl informacje o wersji, zobacz stronę Pakiet NuGet platformy AspNetCore usługi Azure Monitor.
• Aby zapoznać się z usługami Azure Monitor i OpenTelemetry, zobacz Przykładowa aplikacja usługi Azure Monitor.
• Aby dowiedzieć się więcej na temat biblioteki OpenTelemetry i jej społeczności, zobacz repozytorium GitHub OpenTelemetry .NET.
• Aby włączyć środowiska użycia, włącz monitorowanie użytkowników sieci Web lub przeglądarki.

.NET

• Aby uzyskać szczegółowe informacje na temat dodawania i modyfikowania usługi Azure Monitor OpenTelemetry, zobacz Dodawanie i modyfikowanie funkcji OpenTelemetry usługi Azure Monitor.
• Aby jeszcze bardziej skonfigurować dystrybucję OpenTelemetry, zobacz Azure Monitor OpenTelemetry configuration (Konfiguracja biblioteki OpenTelemetry w usłudze Azure Monitor).
• Aby przejrzeć kod źródłowy, zobacz repozytorium GitHub eksportera usługi Azure Monitor.
• Aby zainstalować pakiet NuGet, sprawdź aktualizacje lub wyświetl informacje o wersji, zobacz stronę Pakiet NuGet eksportera usługi Azure Monitor.
• Aby zapoznać się z usługami Azure Monitor i OpenTelemetry, zobacz Przykładowa aplikacja usługi Azure Monitor.
• Aby dowiedzieć się więcej na temat biblioteki OpenTelemetry i jej społeczności, zobacz repozytorium GitHub OpenTelemetry .NET.
• Aby włączyć środowiska użycia, włącz monitorowanie użytkowników sieci Web lub przeglądarki.

Java

• Zobacz Dodawanie i modyfikowanie usługi Azure Monitor OpenTelemetry , aby uzyskać szczegółowe informacje na temat dodawania i modyfikowania funkcji OpenTelemetry usługi Azure Monitor.
• Zapoznaj się z opcjami konfiguracji autoinstrumentacji języka Java.
• Przejrzyj kod źródłowy w repozytorium GitHub autoinstrumentacji Java usługi Azure Monitor.
• Dowiedz się więcej o technologii OpenTelemetry i jej społeczności w repozytorium GitHub OpenTelemetry Java.
• Włącz środowiska użycia, zobacz Włączanie monitorowania użytkowników w internecie lub przeglądarce.
• Przejrzyj informacje o wersji w witrynie GitHub.

Java Native

• Zobacz Dodawanie i modyfikowanie usługi Azure Monitor OpenTelemetry , aby uzyskać szczegółowe informacje na temat dodawania i modyfikowania funkcji OpenTelemetry usługi Azure Monitor.
• Przejrzyj kod źródłowy w usłudze Azure Monitor OpenTelemetry Distro in Spring Boot native image Application (Aplikacja Java obrazu natywnego platformy Spring Boot) i Eksporter Quarkus OpenTelemetry dla platformy Azure.
• Dowiedz się więcej o technologii OpenTelemetry i jej społeczności w repozytorium GitHub OpenTelemetry Java.
• Dowiedz się więcej o funkcjach aplikacji obrazów natywnych platformy Spring Boot w szablonie startowym SpringBoot OpenTelemetry
• Dowiedz się więcej o funkcjach aplikacji natywnych quarkus w eksporterze Quarkus OpenTelemetry dla platformy Azure.
• Przejrzyj informacje o wersji w witrynie GitHub.

Node.js

• Aby uzyskać szczegółowe informacje na temat dodawania i modyfikowania usługi Azure Monitor OpenTelemetry, zobacz Dodawanie i modyfikowanie funkcji OpenTelemetry usługi Azure Monitor.
• Aby przejrzeć kod źródłowy, zobacz repozytorium GitHub OpenTelemetry usługi Azure Monitor.
• Aby zainstalować pakiet npm i sprawdzić dostępność aktualizacji, zobacz @azure/monitor-opentelemetry stronę pakiet npm.
• Aby lepiej zapoznać się z usługami Azure Monitor Application Insights i OpenTelemetry, zobacz Przykładowa aplikacja usługi Azure Monitor.
• Aby dowiedzieć się więcej o technologii OpenTelemetry i jej społeczności, zobacz repozytorium GitHub Języka JavaScript openTelemetry.
• Aby włączyć środowiska użycia, włącz monitorowanie użytkowników sieci Web lub przeglądarki.

Python

• Zobacz Dodawanie i modyfikowanie usługi Azure Monitor OpenTelemetry , aby uzyskać szczegółowe informacje na temat dodawania i modyfikowania funkcji OpenTelemetry usługi Azure Monitor.
• Przejrzyj kod źródłowy i dodatkową dokumentację w repozytorium GitHub dystrybucji usługi Azure Monitor.
• Zobacz dodatkowe przykłady i przypadki użycia w przykładach dystrybucji usługi Azure Monitor.
• Przejrzyj dziennik zmian w witrynie GitHub.
• Zainstaluj pakiet PyPI, sprawdź aktualizacje lub wyświetl informacje o wersji na stronie Pakiet PyPI usługi Azure Monitor.
• Zapoznaj się z usługą Azure Monitor Application Insights i aplikacją OpenTelemetry w przykładowej aplikacji usługi Azure Monitor.
• Dowiedz się więcej na temat biblioteki OpenTelemetry i jej społeczności w repozytorium GitHub OpenTelemetry Python.
• Zobacz dostępne instrumentacje i składniki openTelemetry w repozytorium GitHub Współautor openTelemetry.
• Włącz środowiska użycia, włączając monitorowanie użytkowników w internecie lub przeglądarce.

Często zadawane pytania

Ta sekcja zawiera odpowiedzi na typowe pytania.

Co to jest OpenTelemetry?

Jest to nowy standard open source umożliwiający obserwowanie. Dowiedz się więcej na stronie OpenTelemetry.

Dlaczego usługa Microsoft Azure Monitor inwestuje w rozwiązanie OpenTelemetry?

Firma Microsoft jest jednym z największych współautorów usługi OpenTelemetry.

Najważniejsze propozycje dotyczące biblioteki OpenTelemetry są neutralne dla dostawcy i zapewniają spójne interfejsy API/zestawy SDK w różnych językach.

Z biegiem czasu uważamy, że platforma OpenTelemetry umożliwi klientom usługi Azure Monitor obserwowanie aplikacji napisanych w językach poza obsługiwanymi językami. Rozszerza również typy danych, które można zbierać za pomocą bogatego zestawu bibliotek instrumentacji. Ponadto zestawy SDK (Software Development Kit) openTelemetry są zwykle bardziej wydajne na dużą skalę niż ich poprzedniki, zestawy SDK usługi Application Insights.

Na koniec platforma OpenTelemetry jest zgodna ze strategią firmy Microsoft w celu przyjęcia rozwiązania open source.

Jaki jest stan funkcji OpenTelemetry?

Zobacz Stan openTelemetry.

Co to jest "Dystrybucja opentelemetrii usługi Azure Monitor"?

Można go traktować jako cienką otokę, która łączy wszystkie składniki OpenTelemetry dla środowiska pierwszej klasy na platformie Azure. Ta otoka jest również nazywana dystrybucją w usłudze OpenTelemetry.

Dlaczego należy używać dystrybucji "Azure Monitor OpenTelemetry"?

Korzystanie z dystrybucji OpenTelemetry usługi Azure Monitor za pośrednictwem natywnej biblioteki OpenTelemetry z poziomu społeczności ma kilka zalet:

• Zmniejsza nakład pracy przy włączaniu
• Obsługiwane przez firmę Microsoft
• Udostępnia funkcje specyficzne dla platformy Azure, takie jak:
  • Próbkowanie zgodne z klasycznymi zestawami SDK usługi Application Insights
  • Uwierzytelnianie Microsoft Entra
  • Magazyn w trybie offline i automatyczne ponawianie prób
  • Statystykabeat
  • Metryki standardowe usługi Application Insights
  • Wykrywanie metadanych zasobów w celu automatycznego wypełniania nazwy roli chmury i wystąpienia roli chmury w różnych środowiskach platformy Azure
  • Metryki na żywo

W duchu OpenTelemetry zaprojektowaliśmy dystrybucję tak, aby była otwarta i rozszerzalna. Możesz na przykład dodać następujące elementy:

• Eksporter Protokołu OTLP (OpenTelemetry Protocol) i wysyłany jednocześnie do drugiego miejsca docelowego
• Inne biblioteki instrumentacji nieuwzględniane w dystrybucji

Ponieważ dystrybucja dystrybucji zapewnia dystrybucję OpenTelemetry, dystrybucja obsługuje wszystkie elementy obsługiwane przez bibliotekę OpenTelemetry. Na przykład można dodać więcej procesorów telemetrycznych, eksporterów lub bibliotek instrumentacji, jeśli usługa OpenTelemetry je obsługuje.

Uwaga

Dystrybucja ustawia próbkator na niestandardowy przykładowy, stały współczynnik dla usługi Application Insights. Można to zmienić na inny przykład, ale może to spowodować wyłączenie niektórych dołączonych możliwości dystrybucji. Aby uzyskać więcej informacji na temat obsługiwanego przykładnika, zobacz sekcję Włączanie próbkowania w temacie Konfigurowanie usługi Azure Monitor OpenTelemetry.

W przypadku języków bez obsługiwanego autonomicznego eksportera OpenTelemetry usługa Azure Monitor OpenTelemetry Distro jest jedynym obecnie obsługiwanym sposobem korzystania z biblioteki OpenTelemetry w usłudze Azure Monitor. W przypadku języków z obsługiwanym autonomicznym eksporterem OpenTelemetry możesz użyć dystrybucji OpenTelemetry usługi Azure Monitor lub odpowiedniego autonomicznego eksportera OpenTelemetry OpenTelemetry w zależności od scenariusza telemetrii. Aby uzyskać więcej informacji, zobacz Kiedy należy używać eksportera OpenTelemetry usługi Azure Monitor?.

Jak przetestować dystrybucję opentelemetrii usługi Azure Monitor?

Zapoznaj się z naszymi dokumentami dotyczącymi włączania dla platform .NET, Java, JavaScript (Node.js) i języka Python.

Czy należy używać interfejsu OpenTelemetry lub zestawu SDK usługi Application Insights?

Zalecamy korzystanie z dystrybucji OpenTelemetry, chyba że wymagana jest funkcja dostępna tylko z obsługą formalną w zestawie SDK usługi Application Insights.

Wdrażanie biblioteki OpenTelemetry teraz uniemożliwia przeprowadzenie migracji w późniejszym terminie.

Kiedy należy używać eksportera OpenTelemetry usługi Azure Monitor?

W przypadku ASP.NET Core, Java, Node.js i Python zalecamy użycie dystrybucji OpenTelemetry usługi Azure Monitor. Jest to jeden wiersz kodu, aby rozpocząć pracę.

W przypadku wszystkich innych scenariuszy platformy .NET, w tym klasycznych ASP.NET, aplikacji konsolowych, formularzy systemu Windows (WinForms) itp., zalecamy użycie eksportera OpenTelemetry platformy .NET usługi Azure Monitor: Azure.Monitor.OpenTelemetry.Exporter.

W przypadku bardziej złożonych scenariuszy telemetrii języka Python wymagających zaawansowanej konfiguracji zalecamy użycie eksportera OpenTelemetry usługi Azure Monitor w języku Python.

Jaki jest bieżący stan wersji funkcji w usłudze Azure Monitor OpenTelemetry Distro?

Na poniższym wykresie przedstawiono obsługę funkcji OpenTelemetry dla każdego języka.

Funkcja	.NET	Node.js	Python	Java
Śledzenie rozproszone	✅	✅	✅	✅
Metryki niestandardowe	✅	✅	✅	✅
Metryki standardowe (dokładność, na którą ma obecnie wpływ próbkowanie)	✅	✅	✅	✅
Próbkowanie o stałej częstotliwości	✅	✅	✅	✅
Magazyn w trybie offline i automatyczne ponawianie prób	✅	✅	✅	✅
Raportowanie wyjątków	✅	✅	✅	✅
Zbieranie dzienników	✅	⚠️	✅	✅
Zdarzenia niestandardowe	⚠️	⚠️	⚠️	✅
Uwierzytelnianie Microsoft Entra	✅	✅	✅	✅
Metryki na żywo	✅	✅	✅	✅
Filtrowanie metryk na żywo	❌	❌	❌	❌
Wykrywanie kontekstu zasobów dla maszyn wirtualnych/zestawu skalowania maszyn wirtualnych i usługi App Service	✅	❌	✅	✅
Wykrywanie kontekstu zasobów dla usługi Azure Kubernetes Service (AKS) i funkcji	❌	❌	❌	✅
Zdarzenia testowania dostępności generowane przy użyciu interfejsu API śledzenia dostępności	❌	❌	❌	✅
Filtrowanie żądań, zależności, dzienników i wyjątków według anonimowego identyfikatora użytkownika i syntetycznego źródła	❌	❌	❌	✅
Filtrowanie zależności, dzienników i wyjątków według nazwy operacji	❌	❌	❌	✅
Próbkowanie adaptacyjne	❌	❌	❌	✅
Profiler	✅	❌	❌	⚠️
Debuger migawek	✅	❌	❌	❌

Klawisz

• ✅ Ta funkcja jest dostępna dla wszystkich klientów z formalnym wsparciem.
• ⚠✔ Ta funkcja jest dostępna jako publiczna wersja zapoznawcza. Zobacz Dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure.
• ❌ Ta funkcja jest niedostępna lub nie ma zastosowania.

Czy można używać funkcji OpenTelemetry dla przeglądarek internetowych?

Tak, ale nie zalecamy jej i platforma Azure nie obsługuje jej. Język JavaScript openTelemetry jest mocno zoptymalizowany pod kątem Node.js. Zamiast tego zalecamy używanie zestawu SDK języka JavaScript usługi Application Insights.

Kiedy można oczekiwać, że zestaw SDK OpenTelemetry będzie dostępny do użycia w przeglądarkach internetowych?

Internetowy zestaw SDK openTelemetry nie ma ustalonej osi czasu dostępności. Prawdopodobnie kilka lat od zestawu SDK przeglądarki jest realną alternatywą dla zestawu SDK języka JavaScript usługi Application Insights.

Czy mogę przetestować metrykę OpenTelemetry w przeglądarce internetowej dzisiaj?

Piaskownica internetowa OpenTelemetry to rozwidlenie przeznaczone do działania openTelemetry w przeglądarce. Nie można jeszcze wysyłać danych telemetrycznych do usługi Application Insights. Zestaw SDK nie definiuje ogólnych zdarzeń klienta.

Czy działa usługa Application Insights obok agentów konkurencji, takich jak AppDynamics, DataDog i NewRelic, jest obsługiwana?

Ta praktyka nie jest czymś, co planujemy przetestować ani obsługiwać , chociaż nasze dystrybucje umożliwiają eksportowanie do punktu końcowego OTLP wraz z usługą Azure Monitor jednocześnie.

Czy mogę używać funkcji w wersji zapoznawczej w środowiskach produkcyjnych?

Nie zalecamy tego. Zobacz Dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure.

Jaka jest różnica między instrumentacją ręczną i automatyczną?

Zobacz Omówienie usługi OpenTelemetry.

Czy mogę użyć modułu zbierającego OpenTelemetry?

Niektórzy klienci używają modułu zbierającego OpenTelemetry jako alternatywy dla agenta, mimo że firma Microsoft oficjalnie nie obsługuje podejścia opartego na agencie do monitorowania aplikacji. W międzyczasie społeczność typu open source przyczyniła się do eksportera usługi Azure Monitor modułu zbierającego openTelemetry, którego niektórzy klienci używają do wysyłania danych do usługi Azure Monitor Application Insights. Nie jest to obsługiwane przez firmę Microsoft.

Jaka jest różnica między usługami OpenCensus i OpenTelemetry?

OpenCensus jest prekursorem OpenTelemetry. Firma Microsoft pomogła połączyć rozwiązania OpenTracing i OpenCensus w celu utworzenia biblioteki OpenTelemetry— jednego standardu obserwacji dla świata. Bieżący zestaw SDK języka Python zalecany w środowisku produkcyjnym dla usługi Azure Monitor jest oparty na usłudze OpenCensus. Firma Microsoft zobowiązuje się do tworzenia usługi Azure Monitor na podstawie biblioteki OpenTelemetry.

Rozwiązywanie problemów

ASP.NET Core

Nie działa? Zapoznaj się ze stroną rozwiązywania problemów dla ASP.NET Core.

.NET

Nie działa? Zapoznaj się ze stroną rozwiązywania problemów dla platformy .NET.

Java

Nie działa? Zapoznaj się ze stroną rozwiązywania problemów dla języka Java.

Node.js

Nie działa? Zapoznaj się ze stroną rozwiązywania problemów dla Node.js.

Python

Nie działa? Zapoznaj się ze stroną rozwiązywania problemów dla języka Python.

Pomoc techniczna

Wybierz kartę dla wybranego języka, aby odnaleźć opcje pomocy technicznej.

ASP.NET Core

• W przypadku problemów z pomoc techniczna platformy Azure otwórz bilet pomoc techniczna platformy Azure.
• W przypadku problemów z usługą OpenTelemetry skontaktuj się bezpośrednio ze społecznością platformy .NET OpenTelemetry.
• Aby uzyskać listę otwartych problemów związanych z eksporterem usługi Azure Monitor, zobacz stronę Problemów z usługą GitHub.

.NET

• W przypadku problemów z pomoc techniczna platformy Azure otwórz bilet pomoc techniczna platformy Azure.
• W przypadku problemów z usługą OpenTelemetry skontaktuj się bezpośrednio ze społecznością platformy .NET OpenTelemetry.
• Aby uzyskać listę otwartych problemów związanych z eksporterem usługi Azure Monitor, zobacz stronę Problemów z usługą GitHub.

Java

• W przypadku problemów z pomoc techniczna platformy Azure otwórz bilet pomoc techniczna platformy Azure.
• Aby uzyskać pomoc dotyczącą rozwiązywania problemów, zapoznaj się z krokami rozwiązywania problemów.
• W przypadku problemów z usługą OpenTelemetry skontaktuj się bezpośrednio ze społecznością OpenTelemetry.
• Aby uzyskać listę otwartych problemów związanych z autoinstrumentacją Java usługi Azure Monitor, zobacz stronę Problemów z usługą GitHub.

Node.js

• W przypadku problemów z pomoc techniczna platformy Azure otwórz bilet pomoc techniczna platformy Azure.
• W przypadku problemów z biblioteką OpenTelemetry skontaktuj się bezpośrednio ze społecznością języka JavaScript openTelemetry.
• Aby uzyskać listę otwartych problemów związanych z eksporterem usługi Azure Monitor, zobacz stronę Problemów z usługą GitHub.

Python

• W przypadku problemów z pomoc techniczna platformy Azure otwórz bilet pomoc techniczna platformy Azure.
• W przypadku problemów z biblioteką OpenTelemetry skontaktuj się bezpośrednio ze społecznością języka Python OpenTelemetry.
• Aby uzyskać listę otwartych problemów związanych z dystrybucją usługi Azure Monitor, zobacz stronę Problemów z usługą GitHub.

Opinie dotyczące usługi OpenTelemetry

Aby przekazać opinię:

• Wypełnij ankietę opinii klientów społeczności OpenTelemetry.
• Poinformuj firmę Microsoft o sobie, dołączając do społeczności wczesnych użytkowników openTelemetry.
• Skontaktuj się z innymi użytkownikami usługi Azure Monitor w społeczności technicznej firmy Microsoft.
• Wyślij żądanie funkcji na forum opinii platformy Azure.