Az Azure Monitor OpenTelemetria engedélyezése .NET-, Node.js-, Python- és Java-alkalmazásokhoz

Ez a cikk bemutatja, hogyan engedélyezheti és konfigurálhatja az OpenTelemetry-alapú adatgyűjtést az Application Insightsban. Az Azure Monitor OpenTelemetria disztribúciója:

• OpenTelemetria-disztribúciót biztosít, amely támogatja az Azure Monitorra vonatkozó funkciókat.
• Lehetővé teszi az automatikus telemetriát az OpenTelemetry-eszközkódtárak használatával nyomkövetések, metrikák, naplók és kivételek gyűjtéséhez.
• Lehetővé teszi az egyéni telemetriai adatok gyűjtését.
• Támogatja az élő metrikákat az élő, éles webalkalmazásokból származó további telemetriai adatok monitorozásához és gyűjtéséhez.

Az Azure Monitor OpenTelemetry Distro használatának előnyeiről további információt az Azure Monitor OpenTelemetry Distro használatának miért érdemes használnia?

Ha többet szeretne megtudni az adatok OpenTelemetria használatával történő gyűjtéséről, tekintse meg az adatgyűjtés alapjait vagy az OpenTelemetria gyakori kérdéseit.

Az OpenTelemetry kiadásának állapota

Az OpenTelemetry-ajánlatok .NET-, Node.js-, Python- és Java-alkalmazásokhoz érhetők el. A funkciónkénti kiadási állapotot a gyakori kérdések között találja.

OpenTelemetria engedélyezése az Application Insights használatával

Kövesse az ebben a szakaszban leírt lépéseket az alkalmazás OpenTelemetria használatával történő rendszerezettségéhez. Válasszon egy lapot a langauge-specifikus utasításokhoz.

Feljegyzés

A .NET több forgatókönyvet is lefed, beleértve a klasszikus ASP.NET, a konzolalkalmazásokat, a Windows Formst (WinForms) és sok mást.

Előfeltételek

• Azure-előfizetés: Azure-előfizetés létrehozása ingyenesen
• Application Insights-erőforrás: Application Insights-erőforrás létrehozása

ASP.NET Core

• ASP.NET Core-alkalmazás a .NET hivatalosan támogatott verziójával

Tipp.

Ha a klasszikus Application Insights API-ból migrál, tekintse meg a migrálási dokumentációt.

.NET

• A .NET vagy .NET-keretrendszer 4.6.2-es és újabb verzióit használó alkalmazás.

Tipp.

Ha a klasszikus Application Insights API-ból migrál, tekintse meg a migrálási dokumentációt.

Java

• Java-alkalmazás a Java 8+ használatával

Java natív

• Java-alkalmazás a GraalVM 17+ használatával

Node.js

• Az alkalmazás a Node.js futtatókörnyezet hivatalosan támogatott verzióját használja:
  • OpenTelemetry által támogatott futtatókörnyezetek
  • Az Azure Monitor OpenTelemetry-exportőr által támogatott futtatókörnyezetek

Feljegyzés

Ha nem támaszkodik a nem támogatott táblázatban felsorolt tulajdonságokra, az ApplicationInsights shim lesz a legegyszerűbb elérési út a bétaverzióból való kiesés után.

Ha ezekre a tulajdonságokra támaszkodik, folytassa az Azure Monitor OpenTelemetry Disztribúcióval. Hamarosan migrálási útmutatót is biztosítunk.

Tipp.

Ha a klasszikus Application Insights API-ból migrál, tekintse meg a migrálási dokumentációt.

Python

• Python-alkalmazás a Python 3.8+ használatával

Tipp.

Ha az OpenCensus-ból migrál, tekintse meg a migrálási dokumentációt.

Telepítse az ügyfélkódtárat

ASP.NET Core

Telepítse a legújabb Azure.Monitor.OpenTelemetry.AspNetCore NuGet-csomagot:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

Telepítse a legújabb Azure.Monitor.OpenTelemetry.Exporter NuGet-csomagot:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Töltse le a applicationinsights-agent-3.6.0.jar fájlt.

Figyelmeztetés

Ha egy korábbi 3.x-es verzióról frissít, az alapértelmezett beállítások módosítása vagy az összegyűjtött adatok kismértékben eltérőek lehetnek. További információt a kibocsátási megjegyzések áttelepítési szakaszában talál. 3.5.0, 3.4.0, 3.3.0, 3.2.0 és 3.1.0

Java natív

Spring Boot natív alkalmazások esetén:

• Importálja az OpenTelemetry Bills of Materials (BOM) elemet.
• Adja hozzá a Spring Cloud Azure Starter Monitor-függőséget .
• Kövesse ezeket az utasításokat az Azure SDK JAR (Java Archive) fájljaihoz.

A Quarkus natív alkalmazásai esetén:

• Adja hozzá a Quarkus OpenTelemetry-exportőrt az Azure-függőséghez .

Node.js

Telepítse a legújabb @azure/monitor-opentelemetry csomagot:

npm install @azure/monitor-opentelemetry

A következő csomagokat a cikk későbbi részében ismertetett konkrét forgatókönyvekhez is használjuk:

• @opentelemetry/api
• @opentelemetry/sdk-metrikák
• @opentelemetry/erőforrások
• @opentelemetry/szemantikai konvenciók
• @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

Telepítse a legújabb Azure-monitor-opentelemetry PyPI-csomagot:

pip install azure-monitor-opentelemetry

Az alkalmazás módosítása

ASP.NET Core

Importálja a Azure.Monitor.OpenTelemetry.AspNetCore névteret, adja hozzá az OpenTelemetryt, és konfigurálja az Azure Monitor használatára az program.cs osztályban:

// 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

Adja hozzá az Azure Monitor-exportőrt az osztály minden Egyes OpenTelemetria jeléhez 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();
    });
});

Feljegyzés

További információ: Az OpenTelemetry .NET első lépéseinek oktatóanyaga

Java

Az autoinstrumentáció konfigurációs módosításokkal engedélyezve van. Nincs szükség kódmódosításra.

Mutasson a Java virtuális gépre (JVM) az alkalmazás JVM-argjeihez való hozzáadással -javaagent:"path/to/applicationinsights-agent-3.6.0.jar" a jar-fájlra.

Feljegyzés

A mintavételezés alapértelmezés szerint másodpercenként 5 kéréssel engedélyezett, ami segít a költségkezelésben. Előfordulhat, hogy a telemetriai adatok hiányoznak az ilyen arányt meghaladó forgatókönyvekben. A mintavételezési konfiguráció módosításáról további információt a mintavételezési felülbírálások című témakörben talál.

Tipp.

A forgatókönyvre vonatkozó útmutatásért tekintse meg az Első lépések (kiegészítő) című témakört.

Tipp.

Spring Boot-alkalmazás fejlesztése esetén a JVM argumentumot igény szerint programozott konfigurációval helyettesítheti. További információ: Az Azure Monitor Application Insights használata a Spring Boot használatával.

Java natív

Az autoinstrumentáció konfigurációs módosításokkal engedélyezve van. Nincs szükség kódmódosításra.

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

A kapcsolati sztring másolása az Application Insights-erőforrásból

A kapcsolati sztring egyedi, és meghatározza, hogy az Azure Monitor OpenTelemetry Distro hová küldi az általa gyűjtött telemetriát.

Tipp.

Ha még nem rendelkezik Application Insights-erőforrásokkal, hozzon létre egyet az alábbi útmutató alapján. Javasoljuk, hogy a meglévő helyett hozzon létre egy új erőforrást.

A kapcsolati sztring másolása:

1. Nyissa meg az Application Insights-erőforrás Áttekintés panelét.
2. Keresse meg a kapcsolati sztring.
3. Vigye az egérmutatót a kapcsolati sztring, és válassza a Vágólapra másolás ikont.

A kapcsolati sztring beillesztése a környezetbe

A kapcsolati sztring beillesztéséhez válasszon a következő lehetőségek közül:

Fontos

Javasoljuk, hogy a kapcsolati sztring csak helyi fejlesztési és tesztelési környezetekben állítsa be a kódon keresztül.

Éles környezetben használjon környezeti változót vagy konfigurációs fájlt (csak Java esetén).

• Beállítás javasolt környezeti változóval -

  Cserélje le <Your connection string> a következő parancsot a kapcsolati sztring.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Beállítás csak a konfigurációs fájlon - keresztül Java-on keresztül

  Hozzon létre egy konfigurációs fájlt, applicationinsights.jsonés helyezze ugyanabban a könyvtárban, mint applicationinsights-agent-3.6.0.jar a következő tartalommal:

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

  Cserélje le <Your connection string> az előző JSON-t az egyedi kapcsolati sztring.

• Csak a ASP.NET Core, Node.js és Python kóddal - állítható be

  A kapcsolati sztring kódon keresztüli beállítására kapcsolati sztring konfigurációban talál példát.

Feljegyzés

Ha több helyen állítja be a kapcsolati sztring, a környezeti változó rangsorolása a következő sorrendben történik:

1. Kód
2. Környezeti változó
3. Konfigurációs fájl

Adatok áramlásának ellenőrzése

Futtassa az alkalmazást, majd nyissa meg az Application Insightst az Azure Portalon. Az adatok megjelenítése eltarthat néhány percig.

Az Application Insights mostantól engedélyezve van az alkalmazás számára. Az alábbi lépések nem kötelezőek, és lehetővé teszik a további testreszabást.

Fontos

Ha két vagy több olyan szolgáltatása van, amely telemetriát bocsát ki ugyanahhoz az Application Insights-erőforráshoz, akkor a felhőbeli szerepkörneveket be kell állítania, hogy megfelelően ábrázolják őket az alkalmazástérképen.

Az Application Insights rendszerállapotának részeként diagnosztikai adatokat gyűjtünk és küldünk a Microsoftnak. Ezek az adatok segítenek az Application Insights futtatásában és fejlesztésében. További információ: Statsbeat in Azure-alkalmazás Insights.

Mintaalkalmazások

Az Azure Monitor OpenTelemetry mintaalkalmazásai az összes támogatott nyelvhez elérhetők:

• ASP.NET Core mintaalkalmazás
• NET-mintaalkalmazás
• Java-mintaalkalmazások
• Java GraalVM natív mintaalkalmazások
• Node.js mintaalkalmazás
• Python-mintaalkalmazások

Következő lépések

ASP.NET Core

• Az Azure Monitor OpenTelemetria hozzáadásáról és módosításáról további információt az Azure Monitor OpenTelemetria hozzáadása és módosítása című témakörben talál.
• Az OpenTelemetria-disztribúció további konfigurálásához tekintse meg az Azure Monitor OpenTelemetry konfigurációját.
• A forráskód áttekintéséhez tekintse meg az Azure Monitor AspNetCore GitHub-adattárat.
• A NuGet-csomag telepítéséhez, frissítések kereséséhez vagy kibocsátási megjegyzések megtekintéséhez tekintse meg az Azure Monitor AspNetCore NuGet-csomag oldalát.
• Az Azure Monitor és az OpenTelemetria megismeréséhez tekintse meg az Azure Monitor példaalkalmazást.
• Az OpenTelemetryről és annak közösségéről az OpenTelemetry .NET GitHub-adattárban olvashat bővebben.
• A használati élmény engedélyezéséhez engedélyezze a web- vagy böngészőfelhasználói figyelést.
• A gyakori kérdések, a hibaelhárítási lépések, a támogatási lehetőségek vagy az OpenTelemetria-visszajelzések megtekintéséhez tekintse meg az OpenTelemetry súgóját, támogatását és visszajelzését az Azure Monitor Application Insightshoz.

.NET

• Az Azure Monitor OpenTelemetria hozzáadásáról és módosításáról további információt az Azure Monitor OpenTelemetria hozzáadása és módosítása című témakörben talál.
• Az OpenTelemetria-disztribúció további konfigurálásához tekintse meg az Azure Monitor OpenTelemetry konfigurációját.
• A forráskód áttekintéséhez tekintse meg az Azure Monitor Exporter GitHub-adattárat.
• A NuGet-csomag telepítéséhez, a frissítések kereséséhez vagy a kibocsátási megjegyzések megtekintéséhez tekintse meg az Azure Monitor Exportőr NuGet-csomag oldalát.
• Az Azure Monitor és az OpenTelemetria megismeréséhez tekintse meg az Azure Monitor példaalkalmazást.
• Az OpenTelemetryről és annak közösségéről az OpenTelemetry .NET GitHub-adattárban olvashat bővebben.
• A használati élmény engedélyezéséhez engedélyezze a web- vagy böngészőfelhasználói figyelést.
• A gyakori kérdések, a hibaelhárítási lépések, a támogatási lehetőségek vagy az OpenTelemetria-visszajelzések megtekintéséhez tekintse meg az OpenTelemetry súgóját, támogatását és visszajelzését az Azure Monitor Application Insightshoz.

Java

• Az Azure Monitor OpenTelemetria hozzáadásával és módosításával kapcsolatos részletekért tekintse meg az Azure Monitor OpenTelemetria hozzáadását és módosítását ismertető cikket.
• Tekintse át a Java autoinstrumentációs konfigurációs beállításait.
• Tekintse át a forráskódot az Azure Monitor Java autoinstrumentation GitHub-adattárában.
• További információ az OpenTelemetryről és annak közösségéről az OpenTelemetry Java GitHub-adattárban.
• Engedélyezze a használati szolgáltatásokat a webes vagy böngésző felhasználói figyelésének engedélyezésével.
• Tekintse át a GitHub kibocsátási megjegyzéseit .
• A gyakori kérdések, a hibaelhárítási lépések, a támogatási lehetőségek vagy az OpenTelemetria-visszajelzések megtekintéséhez tekintse meg az OpenTelemetry súgóját, támogatását és visszajelzését az Azure Monitor Application Insightshoz.

Java natív

• Az Azure Monitor OpenTelemetria hozzáadásával és módosításával kapcsolatos részletekért tekintse meg az Azure Monitor OpenTelemetria hozzáadását és módosítását ismertető cikket.
• Tekintse át az Azure Monitor OpenTelemetry Distro forráskódját a Spring Boot natív rendszerképének Java-alkalmazásában és az Azure-hoz készült Quarkus OpenTelemetry-exportőrben.
• További információ az OpenTelemetryről és annak közösségéről az OpenTelemetry Java GitHub-adattárban.
• További funkciók a Spring Boot natív rendszerkép-alkalmazásaiban az OpenTelemetry SpringBoot starterben
• További információk a Quarkus natív alkalmazásaihoz az Azure-hoz készült Quarkus OpenTelemetry-exportőrben.
• Tekintse át a GitHub kibocsátási megjegyzéseit .
• A gyakori kérdések, a hibaelhárítási lépések, a támogatási lehetőségek vagy az OpenTelemetria-visszajelzések megtekintéséhez tekintse meg az OpenTelemetry súgóját, támogatását és visszajelzését az Azure Monitor Application Insightshoz.

Node.js

• Az Azure Monitor OpenTelemetria hozzáadásáról és módosításáról további információt az Azure Monitor OpenTelemetria hozzáadása és módosítása című témakörben talál.
• A forráskód áttekintéséhez tekintse meg az Azure Monitor OpenTelemetry GitHub-adattárat.
• Az npm-csomag telepítéséhez és a frissítések kereséséhez tekintse meg az @azure/monitor-opentelemetry npm csomag oldalát.
• Az Azure Monitor Application Insights és az OpenTelemetria megismeréséhez tekintse meg az Azure Monitor példaalkalmazást.
• Az OpenTelemetryről és annak közösségéről az OpenTelemetry JavaScript GitHub-adattárban olvashat bővebben.
• A használati élmény engedélyezéséhez engedélyezze a web- vagy böngészőfelhasználói figyelést.
• A gyakori kérdések, a hibaelhárítási lépések, a támogatási lehetőségek vagy az OpenTelemetria-visszajelzések megtekintéséhez tekintse meg az OpenTelemetry súgóját, támogatását és visszajelzését az Azure Monitor Application Insightshoz.

Python

• Az Azure Monitor OpenTelemetria hozzáadásával és módosításával kapcsolatos részletekért tekintse meg az Azure Monitor OpenTelemetria hozzáadását és módosítását ismertető cikket.
• Tekintse át a forráskódot és a további dokumentációt az Azure Monitor Distro GitHub-adattárban.
• További minták és használati esetek megtekintése az Azure Monitor disztribúciós mintáiban.
• Tekintse át a változásnaplót a GitHubon.
• Telepítse a PyPI-csomagot, ellenőrizze a frissítéseket, vagy tekintse meg a kibocsátási megjegyzéseket az Azure Monitor Distro PyPI-csomag oldalán.
• Az Azure Monitor Application Insights és az OpenTelemetria megismerése az Azure Monitor példaalkalmazásban.
• További információ az OpenTelemetryről és annak közösségéről az OpenTelemetry Python GitHub-adattárban.
• Az OpenTelemetry Közreműködő Python GitHub-adattárában elérhető OpenTelemetry-rendszerállapotok és -összetevők megtekintése.
• A használati élmény engedélyezése a webes vagy böngésző felhasználói figyelésének engedélyezésével.
• A gyakori kérdések, a hibaelhárítási lépések, a támogatási lehetőségek vagy az OpenTelemetria-visszajelzések megtekintéséhez tekintse meg az OpenTelemetry súgóját, támogatását és visszajelzését az Azure Monitor Application Insightshoz.