Mengaktifkan Azure Monitor OpenTelemetry untuk aplikasi .NET, Node.js, Python, dan Java

Artikel ini menjelaskan cara mengaktifkan dan mengonfigurasi pengumpulan data berbasis OpenTelemetry dalam Azure Monitor Application Insights. Distro OpenTelemetry dari Azure Monitor

• Menyediakan distribusi OpenTelemetry, yang mencakup dukungan untuk fitur khusus untuk Azure Monitor.
• Mengaktifkan telemetri otomatis dengan menggunakan pustaka instrumentasi OpenTelemetry untuk mengumpulkan jejak, metrik, log, dan pengecualian.
• Memungkinkan pengumpulan telemetri kustom .
• Mendukung Metrik Langsung untuk memantau dan mengumpulkan telemetri dari aplikasi web yang sedang berjalan dan dalam produksi.

Untuk informasi selengkapnya tentang keuntungan menggunakan Distro OpenTelemetry Azure Monitor, lihat Apakah saya harus menggunakan Distro OpenTelemetry Azure Monitor.

Untuk mempelajari selengkapnya tentang mengumpulkan data menggunakan OpenTelemetry, lihat Mengumpulkan pengalaman OpenTelemetry (OTel) untuk Application Insights atau FAQ OpenTelemetry.

Status rilis OpenTelemetry

Penawaran OpenTelemetry tersedia untuk aplikasi .NET, Node.js, Python, dan Java. Untuk status rilis fitur demi fitur, lihat FAQ.

Catatan

Untuk Azure Function Apps, lihat Gunakan OpenTelemetry dengan Azure Functions.

Mengaktifkan OpenTelemetry dengan Application Insights

Ikuti langkah-langkah pada bagian ini untuk melengkapi aplikasi Anda dengan OpenTelemetry. Pilih tab untuk instruksi khusus bahasa.

Catatan

.NET mencakup beberapa skenario, termasuk ASP.NET klasik, aplikasi konsol, Formulir Windows (WinForms), dan banyak lagi.

Prasyarat

• langganan Azure: Buat langganan Azure secara gratis
• Sumber daya Application Insights: Membuat sumber daya Application Insights

ASP.NET Core

• Aplikasi ASP.NET Core menggunakan versi .NET yang didukung secara resmi.

Tips

Jika Anda bermigrasi dari APPLICATION Insights Classic API, lihat dokumentasi migrasi kami.

.NET

• Aplikasi menggunakan versi yang didukung dari .NET atau .NET Framework 4.6.2 dan yang lebih baru.

Tips

Jika Anda bermigrasi dari APPLICATION Insights Classic API, lihat dokumentasi migrasi kami.

Java

• Aplikasi Java menggunakan Java 8+

Java Native

• Aplikasi Java menggunakan GraalVM 17+

Node.js

• Aplikasi yang menggunakan versi yang didukung secara resmi dari runtime Node.js:
  • Runtime yang didukung OpenTelemetry
  • Runtime yang Didukung Azure Monitor OpenTelemetry Exporter

Catatan

Jika Anda tidak mengandalkan properti apa pun yang tercantum dalam tabel tidak didukung, shim ApplicationInsights adalah jalur termudah Anda setelah keluar dari status beta.

Jika Anda mengandalkan salah satu properti tersebut, lanjutkan dengan Azure Monitor OpenTelemetry Distro.

Tips

Jika Anda bermigrasi dari APPLICATION Insights Classic API, lihat dokumentasi migrasi kami.

Python

• Aplikasi Python menggunakan Python 3.8+

Tips

Jika Anda bermigrasi dari OpenCensus, lihat dokumentasi migrasi kami.

Memasang pustaka klien

ASP.NET Core

Instal paket Azure.Monitor.OpenTelemetry.AspNetCoreNuGet terbaru:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

Instal paket Azure.Monitor.OpenTelemetry.ExporterNuGet terbaru:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Unduh file applicationinsights-agent-3.7.8.jar terbaru.

Peringatan

Jika Anda memutakhirkan dari versi 3.x sebelumnya, Anda dapat terpengaruh dengan mengubah default atau sedikit perbedaan dalam data yang kami kumpulkan. Untuk informasi selengkapnya, lihat bagian migrasi di catatan rilis. 3.5.0, 3.4.0, 3.3.0, 3.2.0, dan 3.1.0

Java Native

Untuk aplikasi asli Spring Boot :

• ** Impor Daftar Bahan OpenTelemetry (BOM).
• Tambahkan Spring Cloud Azure Starter Monitor dependensi.
• Ikuti petunjuk ini untuk file Azure SDK JAR (arsip Java).

Untuk aplikasi asli Quarkus :

• Tambahkan dependensi Quarkus OpenTelemetry Exporter untuk Azure.

Catatan

Komunitas Quarkus mendukung dan memelihara ekstensi Quarkus. Untuk bantuan, gunakan saluran dukungan komunitas Quarkus. Microsoft tidak memberikan dukungan teknis untuk integrasi ini.

Node.js

Instal paket terbaru @azure/monitor-opentelemetry :

npm install @azure/monitor-opentelemetry

Paket berikut ini juga digunakan untuk beberapa skenario khusus yang dijelaskan kemudian dalam artikel ini:

• @opentelemetry/api
• @opentelemetry/sdk-metrics
• @opentelemetry/resources
• @opentelemetry/konvensi semantik
• @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

Instal paket PyPI azure-monitor-opentelemetry terbaru:

pip install azure-monitor-opentelemetry

Mengubah aplikasi Anda

ASP.NET Core

Impor namespace Azure.Monitor.OpenTelemetry.AspNetCore, tambahkan OpenTelemetry, dan konfigurasikan untuk menggunakan Azure Monitor di kelas program.cs Anda:

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

Tambahkan pengekspor Azure Monitor ke setiap sinyal OpenTelemetry di kelas 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();
    });
});

Catatan

Untuk informasi selengkapnya, lihat tutorial memulai untuk OpenTelemetry .NET

Java

Autoinstrumentasi diaktifkan melalui perubahan konfigurasi. Tidak diperlukan perubahan kode.

Arahkan Java komputer virtual (JVM) ke file jar dengan menambahkan -javaagent:"path/to/applicationinsights-agent-3.7.8.jar" ke args JVM aplikasi Anda.

Catatan

Pengambilan sampel diaktifkan secara default dengan tarif lima permintaan per detik, membantu manajemen biaya. Data telemetri dapat hilang dalam skenario yang melebihi tingkat ini. Untuk informasi selengkapnya tentang mengubah konfigurasi pengambilan sampel, lihat penggantian pengambilan sampel. Jika Anda melihat biaya tak terduga atau biaya tinggi di Application Insights, panduan ini dapat membantu. Ini mencakup penyebab umum seperti volume telemetri tinggi, lonjakan penyerapan data, dan pengambilan sampel yang salah dikonfigurasi. Ini sangat berguna jika Anda mengatasi masalah yang terkait dengan lonjakan biaya, volume telemetri, pengambilan sampel yang tidak berfungsi, batas data, ingesti tinggi, atau penagihan yang tidak terduga. Untuk memulai, lihat Memecahkan masalah penyerapan data tinggi di Application Insights.

Tips

Untuk panduan khusus skenario, lihat Memulai (Tambahan).

Tips

Jika Anda mengembangkan aplikasi Spring Boot, Anda dapat secara opsional mengganti argumen JVM dengan konfigurasi terprogram. Untuk informasi selengkapnya, lihat Gunakan Azure Monitor Application Insights dengan Spring Boot.

Java Native

Autoinstrumentasi diaktifkan melalui perubahan konfigurasi. Tidak diperlukan perubahan kode.

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

Salin string koneksi dari sumber daya Application Insights Anda

String koneksi yang unik dan menentukan lokasi ke mana Distribusi OpenTelemetry Azure Monitor mengirimkan telemetri yang dikumpulkannya.

Tips

Jika Anda belum memiliki sumber daya Application Insights, buat sumber daya yang mengikuti panduan ini. Sebaiknya buat sumber daya baru daripada menggunakan sumber daya yang sudah ada.

Untuk menyalin string koneksi:

1. Buka panel Gambaran Umum sumber daya Application Insights Anda.
2. Temukan string koneksi.
3. Arahkan mouse ke atas string koneksi dan pilih ikon Copy ke clipboard.

Tempelkan string koneksi di lingkungan sistem Anda

Untuk menempelkan string koneksi Anda, pilih dari opsi berikut:

Penting

Sebaiknya atur string koneksi melalui kode hanya di lingkungan pengembangan dan pengujian lokal.

Untuk produksi, gunakan variabel lingkungan atau file konfigurasi (hanya Java).

• Atur melalui variabel lingkungan - disarankan

  Ganti <Your string koneksi> dalam perintah berikut dengan string koneksi Anda.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Set melalui file konfigurasi - Hanya untuk Java

  Buat file konfigurasi bernama applicationinsights.json, dan letakkan di direktori yang sama seperti applicationinsights-agent-3.7.8.jar dengan konten berikut:

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

  Ganti <Your string koneksi> di JSON sebelumnya dengan string koneksi Anda yang unik.

• Set melalui kode - ASP.NET Core, Node.js, dan Python saja

  Lihat konfigurasi string koneksi untuk contoh pengaturan string koneksi melalui kode.

Catatan

Jika Anda mengatur string koneksi di beberapa tempat, variabel lingkungan diprioritaskan dalam urutan berikut:

1. Kode
2. Variabel lingkungan
3. File konfigurasi

Konfirmasikan bahwa data mengalir

Jalankan aplikasi Anda, lalu buka Application Insights di portal Azure. Mungkin perlu beberapa menit agar data muncul.

Application Insights sekarang diaktifkan untuk aplikasi Anda. Langkah-langkah berikut bersifat opsional dan memungkinkan penyesuaian lebih lanjut.

Catatan

Sebagai bagian dari penggunaan instrumentasi Application Insights, kami mengumpulkan dan mengirim data diagnostik ke Microsoft. Data ini membantu kami menjalankan dan meningkatkan Application Insights. Pelajari lebih lanjut di FAQ Application Insights.

Penting

Jika Anda memiliki dua atau lebih layanan yang memancarkan telemetri ke sumber daya Application Insights yang sama, Anda perlu mengatur Nama Peran Cloud untuk mewakili mereka dengan benar di Peta Aplikasi.

Pemecahan masalah, umpan balik, dan dukungan

Tips

Bagian berikut tersedia di semua artikel Distro OpenTelemetry.

Troubleshooting

ASP.NET Core

Untuk informasi tentang pemecahan masalah, lihat Pemecahan Masalah OpenTelemetry di .NET dan Pemecahan Masalah Telemetri Aplikasi yang Hilang di Azure Monitor Application Insights.

.NET

Untuk informasi tentang pemecahan masalah, lihat Pemecahan Masalah OpenTelemetry di .NET dan Pemecahan Masalah Telemetri Aplikasi yang Hilang di Azure Monitor Application Insights.

Java

Untuk informasi pemecahan masalah, lihat Pemecahan masalah OpenTelemetry di Java dan Pemecahan masalah telemetri aplikasi yang hilang di Azure Monitor Application Insights.

Java Native

Untuk informasi pemecahan masalah, lihat Masalah OpenTelemetry di aplikasi Spring Boot gambar asli dan Telemetri aplikasi yang hilang di Azure Monitor Application Insights.

Node.js

Untuk informasi pemecahan masalah, lihat Pemecahan Masalah OpenTelemetry di Node.js dan Perbaikan masalah hilangnya telemetri aplikasi di Azure Monitor Application Insights.

Python

Untuk informasi pemecahan masalah, lihat Pemecahan Masalah OpenTelemetry di Python dan Pemecahan Masalah Telemetri Aplikasi yang Hilang di Azure Monitor Application Insights.

Umpan Balik OpenTelemetry

Untuk memberikan umpan balik:

• Isi survei umpan balik pelanggan komunitas OpenTelemetry.
• Beri tahu Microsoft tentang diri Anda dengan bergabung dengan OpenTelemetry Early Adopter Community.
• Berinteraksi dengan pengguna Azure Monitor lain di Microsoft Tech Community.
• Buat permintaan fitur di Forum Umpan Balik Azure.

Support

Pilih tab untuk bahasa pilihan Anda untuk menemukan opsi dukungan.

ASP.NET Core

• Untuk masalah Azure support, buka tiket Azure support.
• Untuk masalah OpenTelemetry, hubungi komunitas OpenTelemetry .NET secara langsung.
• Untuk daftar masalah terbuka yang terkait dengan pengekspor Azure Monitor, lihat Halaman Masalah GitHub.

.NET

• Untuk masalah Azure support, buka tiket Azure support.
• Untuk masalah OpenTelemetry, hubungi komunitas OpenTelemetry .NET secara langsung.
• Untuk daftar masalah terbuka yang terkait dengan pengekspor Azure Monitor, lihat Halaman Masalah GitHub.

Java

• Untuk masalah Azure support, buka tiket Azure support.
• Untuk bantuan pemecahan masalah, tinjau langkah-langkah pemecahan masalah.
• Untuk masalah OpenTelemetry, hubungi komunitas OpenTelemetry secara langsung.
• Untuk daftar masalah terbuka yang terkait dengan autoinstrumentasi Azure Monitor Java, lihat Halaman Masalah GitHub.

Java Native

• Untuk masalah Azure support, buka tiket Azure support.
• Untuk masalah OpenTelemetry, hubungi komunitas OpenTelemetry secara langsung.
• Untuk daftar masalah terbuka dengan aplikasi asli Spring Boot, lihat Halaman Masalah GitHub.
• Untuk daftar masalah terbuka dengan aplikasi asli Quarkus, lihat Halaman Masalah GitHub.

Catatan

Komunitas Quarkus mendukung dan memelihara ekstensi Quarkus. Untuk bantuan, gunakan saluran dukungan komunitas Quarkus. Microsoft tidak memberikan dukungan teknis untuk integrasi ini.

Node.js

• Untuk masalah Azure support, buka tiket Azure support.
• Untuk masalah OpenTelemetry, hubungi komunitas OpenTelemetry JavaScript secara langsung.
• Untuk daftar masalah terbuka yang terkait dengan pengekspor Azure Monitor, lihat Halaman Masalah GitHub.

Python

• Untuk masalah Azure support, buka tiket Azure support.
• Untuk masalah OpenTelemetry, hubungi komunitas Python OpenTelemetry secara langsung.
• Untuk daftar masalah terbuka yang terkait dengan Azure Monitor Distro, lihat Halaman Masalah GitHub.

Langkah berikutnya

ASP.NET Core

• Untuk meninjau kode sumber, lihat repositori Azure Monitor ASP.NET Core GitHub.
• Untuk meninjau aplikasi sampel, lihat Azure Monitor OpenTelemetry untuk ASP.NET Core.
• Untuk menginstal paket NuGet, periksa pembaruan, atau lihat catatan rilis, lihat halaman Azure Monitor Paket NuGet AspNetCore.
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, lihat repositori OpenTelemetry .NET GitHub.
• Untuk mengaktifkan pengalaman penggunaan, aktifkan pemantauan pengguna web atau browser.

.NET

• Untuk meninjau kode sumber, lihat repositori GitHub Azure Monitor Exporter.
• Untuk meninjau aplikasi sampel, lihat Azure Monitor OpenTelemetry untuk .NET.
• Untuk menginstal paket NuGet, memeriksa pembaruan, atau melihat catatan rilis, lihat halaman Azure Monitor Exporter Paket NuGet.
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, lihat repositori OpenTelemetry .NET GitHub.
• Untuk mengaktifkan pengalaman penggunaan, aktifkan pemantauan pengguna web atau browser.

Java

• Untuk meninjau opsi konfigurasi, lihat Java Autoinstrumentation Configuration Options.
• Untuk meninjau kode sumber, lihat repositori GitHub Azure Monitor Java autoinstrumentasi.
• Untuk meninjau aplikasi sampel, lihat sampel Java Application Insights.
• Tinjau catatan lease di GitHub.
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, tinjau repositori OpenTelemetry Java GitHub.
• Untuk mengaktifkan pengalaman penggunaan, tinjau Mengaktifkan pemantauan pengguna web atau browser.

Java Native

• Untuk meninjau kode sumber, lihat Azure Monitor OpenTelemetry Distro di aplikasi Java gambar asli Spring Boot dan Quarkus OpenTelemetry Exporter untuk Azure.
• Untuk meninjau aplikasi sampel, lihat Telemetry untuk gambar asli GraalVM.
• Tinjau catatan lease di GitHub.
• Pelajari lebih lanjut fitur untuk aplikasi gambar asli Spring Boot di starter OpenTelemetry SpringBoot
• Pelajari lebih lanjut fitur untuk aplikasi asli Quarkus di Quarkus OpenTelemetry Exporter untuk Azure.
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, tinjau repositori OpenTelemetry Java GitHub.

Node.js

• Untuk meninjau kode sumber, lihat Azure Monitor OpenTelemetry untuk repositori JavaScript.
• Untuk meninjau aplikasi sampel, lihat Azure Monitor OpenTelemetry untuk Node.js.
• Untuk menginstal paket npm dan memeriksa pembaruan, lihat @azure/monitor-opentelemetry halaman Paket npm .
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, lihat repositori OpenTelemetry JavaScript GitHub.
• Untuk mengaktifkan pengalaman penggunaan, aktifkan pemantauan pengguna web atau browser.

Python

• Untuk meninjau kode sumber dan dokumentasi tambahan, lihat repositori Azure Monitor Python GitHub.
• Untuk meninjau aplikasi sampel, lihat Azure Monitor OpenTelemetry untuk Python.
• Untuk menginstal paket PyPI dan memeriksa pembaruan, lihat halaman Azure Monitor Paket PyPI Distro.
• Tinjau catatan lease di GitHub.
• Untuk meninjau instrumentasi dan komponen OpenTelemetry yang tersedia, lihat repositori OpenTelemetry Contributor Python GitHub.
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, tinjau repositori OpenTelemetry Python GitHub.
• Untuk mengaktifkan pengalaman penggunaan, aktifkan pemantauan pengguna web atau browser.