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

Ez a cikk azt ismerteti, hogyan engedélyezheti és konfigurálhatja az OpenTelemetry-alapú adatgyűjtést az Azure Monitor 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.

Ha szeretne többet megtudni az Azure Monitor OpenTelemetry Distro használatának előnyeiről, tekintse meg a Miért érdemes az Azure Monitor OpenTelemetry Distro-t használni.

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.

Feljegyzés

Az Azure Functions Apps esetében lásd: OpenTelemetria használata az Azure Functions használatával.

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 fület a nyelvspecifikus 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-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.

Telepítse a klienskönyvtárat

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

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

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

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

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:

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

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

pip install azure-monitor-opentelemetry

Az alkalmazás módosítása

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

Adja hozzá az Azure Monitor exportert a(z) program.cs osztály minden OpenTelemetry-jeléhez.

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

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

Az alkalmazás JVM-argumeteihez adja hozzá a -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" elemet, hogy a Java virtuális gép a jar fájlra mutasson.

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. Ha váratlan díjakat vagy magas költségeket lát az Application Insightsban, ez az útmutató segíthet. Olyan gyakori okokra terjed ki, mint a magas telemetriai mennyiség, az adatbetöltési csúcsok és a helytelenül konfigurált mintavételezés. Különösen hasznos, ha a költségnövekedéssel, a telemetriai mennyiséggel, a mintavételezés hibás működésével, az adatforgalmi korlátokkal, a magas betöltéssel vagy a váratlan számlázással kapcsolatos problémákat hárítja el. Első lépésként tekintse meg az Application Insights magas adatbetöltésének hibaelhárításával foglalkozó témakört.

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.

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

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.

A kapcsolati karakterlánc 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 karakterlánc másolása:

Nyissa meg az Application Insights-erőforrás Áttekintés panelét.
Keresse meg a kapcsolati karakterlánc.
Vigye az egérmutatót a kapcsolati karakterlánc fölé, é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

Azt javasoljuk, hogy a kapcsolat stringet csak helyi fejlesztési és tesztelési környezetekben állítsa be kódon keresztül.

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

Beállítás környezeti változó által - ajánlott

Cserélje le <Your connection string> a következő parancsban a saját kapcsolati sztringjére.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Beállítás a konfigurációs fájlon keresztül - Csak Java

Hozzon létre egy konfigurációs fájlt, applicationinsights.jsonés helyezze ugyanabban a könyvtárban, mint applicationinsights-agent-3.7.5.jar a következő tartalommal:
```
{
  "connectionString": "<Your connection string>"
}
```
Cserélje le a precedens JSON-ban lévő <Your connection string> karakterláncot az ön egyedi kapcsolati sztringjére.
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:

Kód
Környezeti változó
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.

Képernyőkép az Application Insights Áttekintés lapról, amelyen a kiszolgálókérések és a kiszolgáló válaszideje ki van emelve.

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ókért lásd: Az Azure-alkalmazások Statsbeatje az Insightsban.

Mintaalkalmazások

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

Következő lépések

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.

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.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-09-26

Megosztás a következőn keresztül:

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

Az OpenTelemetry kiadásának állapota

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

Előfeltételek

Telepítse a klienskönyvtárat

Az alkalmazás módosítása

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

A kapcsolati sztring beillesztése a környezetbe

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

Mintaalkalmazások

Következő lépések

Visszajelzés

További források