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 Szczegółowe informacje. 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" w artykule OpenTelemetry FAQ (Często zadawane pytania dotyczące biblioteki OpenTelemetry w usłudze Azure Monitor).

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.

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 Szczegółowe informacje aplikacji: tworzenie zasobu Szczegółowe informacje aplikacji

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

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 app Szczegółowe informacje 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 pakiet NuGet Azure.Monitor.OpenTelemetry.AspNetCore :

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

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

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Pobierz plik applicationinsights-agent-3.5.1.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

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 Szczegółowe informacje aplikacji usługi Azure Monitor

Aby włączyć Szczegółowe informacje aplikacji usługi Azure Monitor, należy wprowadzić drobne modyfikacje aplikacji i ustawić ciąg "Połączenie ion". Ciąg Połączenie ion informuje 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.1.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 Szczegółowe informacje with Spring Boot (Korzystanie z usługi Azure Monitor Application Szczegółowe informacje z platformą Spring Boot).

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 ciągu Połączenie ion z zasobu usługi Application Szczegółowe informacje

Napiwek

Jeśli jeszcze go nie masz, możesz teraz utworzyć zasób Szczegółowe informacje aplikacji. W tym przypadku zalecamy utworzenie nowej aplikacji Szczegółowe informacje zasobu w porównaniu z użyciem istniejącego zasobu.

Aby skopiować unikatowy ciąg Połączenie ion:

1. Przejdź do okienka Przegląd zasobu Application Szczegółowe informacje.
2. Znajdź ciąg Połączenie ion.
3. Umieść kursor na parametry połączenia i wybierz ikonę Kopiuj do schowka.

Wklej ciąg Połączenie ion w środowisku

Aby wkleić ciąg Połączenie ion, wybierz elementy z następujących opcji:

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.1.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 Połączenie ion String Configuration (Konfiguracja ciągu Połączenie ion), aby zapoznać się z przykładem ustawienia ciągu Połączenie ion 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 Szczegółowe informacje aplikacji w witrynie Azure Portal. Wyświetlenie danych w portalu może potrwać kilka minut.

Aplikacja Szczegółowe informacje 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 aplikacji Szczegółowe informacje, musisz ustawić nazwy ról w chmurze, aby reprezentować je prawidłowo na mapie aplikacji.

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

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

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

• 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.
• Zapoznaj się z opcjami konfiguracji autoinstrumentacji języka Java.
• Aby przejrzeć kod źródłowy, zobacz repozytorium GitHub autoinstrumentacji Java usługi Azure Monitor.
• Aby dowiedzieć się więcej o technologii OpenTelemetry i jej społeczności, zobacz repozytorium GitHub OpenTelemetry Java.
• Aby włączyć środowiska użycia, zobacz Włączanie monitorowania użytkowników sieci Web lub przeglądarki.
• Zobacz 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ługą Azure Monitor Application Szczegółowe informacje i aplikacją 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

• 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 zapoznać się z kodem źródłowym i dodatkową dokumentacją, zobacz repozytorium GitHub dystrybucji usługi Azure Monitor.
• Aby wyświetlić dodatkowe przykłady i przypadki użycia, zobacz Przykłady dystrybucji usługi Azure Monitor.
• Zobacz dziennik zmian w witrynie GitHub.
• Aby zainstalować pakiet PyPI, sprawdź aktualizacje lub wyświetl informacje o wersji, zobacz stronę Pakiet PyPI usługi Azure Monitor.
• Aby lepiej zapoznać się z usługą Azure Monitor Application Szczegółowe informacje i aplikacją 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 Python.
• Aby wyświetlić dostępne instrumentacje i składniki openTelemetry, zobacz repozytorium GitHub Współautor openTelemetry.
• Aby włączyć środowiska użycia, włącz monitorowanie użytkowników sieci Web lub przeglądarki.

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 OpenTelemetry są bardziej wydajne na dużą skalę niż ich poprzedniki, zestawy SDK aplikacji Szczegółowe informacje.

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 aplikacji Szczegółowe informacje
  • Uwierzytelnianie Microsoft Entra
  • Magazyn w trybie offline i automatyczne ponawianie prób
  • Statystykabeat
  • Metryki standardowe aplikacji Szczegółowe informacje
  • 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 Szczegółowe informacje aplikacji. 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 Szczegółowe informacje?

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

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 itp., zalecamy użycie eksportera OpenTelemetry usługi Azure Monitor platformy .NET: 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	❌	❌	❌	✅
Wykrywanie kontekstu zasobów dla maszyn wirtualnych/zestawu skalowania maszyn wirtualnych i usługi App Service	✅	❌	✅	✅
Wykrywanie kontekstu zasobów dla usługi AKS i funkcji	❌	❌	❌	✅
Filtrowanie zakresu testowania dostępności	❌	❌	❌	✅
Autopopulacji identyfikatora użytkownika, uwierzytelnionego identyfikatora użytkownika i adresu IP użytkownika	❌	❌	❌	✅
Ręcznie przesłoń/ustaw nazwę operacji, identyfikator użytkownika lub uwierzytelniony identyfikator użytkownika	❌	❌	❌	✅
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życie zestawu SDK javaScript usługi Application Szczegółowe informacje.

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 istnieje kilka lat od zestawu SDK przeglądarki, który jest realną alternatywą dla zestawu SDK języka JavaScript usługi Application Szczegółowe informacje.

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 Szczegółowe informacje. Zestaw SDK nie definiuje ogólnych zdarzeń klienta.

Czy działa aplikacja Szczegółowe informacje obok agentów konkurencji, takich jak AppDynamics, DataDog i NewRelic obsługiwane?

L.p. 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ść 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 Szczegółowe informacje. 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.