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

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

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

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

Untuk mempelajari selengkapnya tentang mengumpulkan data menggunakan OpenTelemetry, lihat Dasar-Dasar Pengumpulan Data 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.

Mengaktifkan OpenTelemetry dengan Application Insights

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

Catatan

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

Prasyarat

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

Inti ASP.NET

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

Tip

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

.NET

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

Tip

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

Java

• Aplikasi Java menggunakan Java 8+

Asli Java

• Aplikasi Java menggunakan GraalVM 17+

Node.js

• Aplikasi menggunakan versi yang didukung secara resmi dari runtime bahasa umum 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 yang tidak didukung, shim ApplicationInsights akan menjadi jalur term mudah Anda ke depannya setelah keluar dari beta.

Jika Anda mengandalkan properti tersebut, lanjutkan dengan Distro OpenTelemetry Azure Monitor. Kami akan segera menyediakan panduan migrasi.

Tip

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

Python

• Aplikasi Python menggunakan Python 3.8+

Tip

Jika Anda bermigrasi dari OpenCensus, lihat dokumentasi migrasi kami.

Memasang pustaka klien

Inti ASP.NET

Instal paket NuGet terbaru:Azure.Monitor.OpenTelemetry.AspNetCore

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

Instal paket NuGet terbaru:Azure.Monitor.OpenTelemetry.Exporter

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Unduh file applicationinsights-agent-3.6.2.jar terbaru.

Peringatan

Jika Anda meningkatkan dari versi 3.x sebelumnya, Anda mungkin 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

Asli Java

Untuk aplikasi asli Spring Boot :

• Impor Tagihan Bahan OpenTelemetry (BOM).
• Tambahkan dependensi Spring Cloud Azure Starter Monitor.
• Ikuti instruksi ini untuk file Azure SDK JAR (Java Archive).

Untuk aplikasi asli Quarkus :

• Tambahkan Quarkus OpenTelemetry Exporter untuk dependensi Azure.

Node.js

Instal paket @azure/monitor-opentelemetry terbaru:

npm install @azure/monitor-opentelemetry

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

• @opentelemetry/api
• metrik @opentelemetry/sdk
• @opentelemetry/resources
• @opentelemetry/semantic-conventions
• @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

Inti ASP.NET

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

// 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 program.cs kelas :

// 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 komputer virtual Java (JVM) ke file jar dengan menambahkan -javaagent:"path/to/applicationinsights-agent-3.6.2.jar" ke args JVM aplikasi Anda.

Catatan

Pengambilan sampel diaktifkan secara default dengan tarif 5 permintaan per detik, membantu manajemen biaya. Data telemetri mungkin hilang dalam skenario yang melebihi tingkat ini. Untuk informasi selengkapnya tentang mengubah konfigurasi pengambilan sampel, lihat penimpaan pengambilan sampel.

Tip

Untuk panduan khusus skenario, lihat Memulai (Tambahan).

Tip

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

Asli Java

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

Salin string koneksi dari sumber daya Application Insights Anda

string koneksi unik dan menentukan di mana Distro OpenTelemetry Azure Monitor mengirim telemetri yang dikumpulkannya.

Tip

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 Anda.
3. Arahkan mouse ke atas string koneksi dan pilih ikon Salin ke clipboard.

Tempelkan string koneksi di lingkungan 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 yang - direkomendasikan

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

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Atur melalui file - konfigurasi java saja

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

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

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

• Atur 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 akan diprioritaskan dalam urutan berikut:

1. Kode
2. Variabel lingkungan
3. File konfigurasi

Mengonfirmasi data sedang 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.

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.

Sebagai bagian dari penggunaan instrumentasi Application Insights, kami mengumpulkan dan mengirim data diagnostik ke Microsoft. Data ini membantu kami menjalankan dan meningkatkan Application Insights. Untuk mempelajari selengkapnya, lihat Statsbeat di Azure Application Insights.

Aplikasi sampel

Aplikasi sampel OpenTelemetry Azure Monitor tersedia untuk semua bahasa yang didukung:

• aplikasi sampel ASP.NET Core
• Aplikasi sampel NET
• Aplikasi sampel Java
• Aplikasi sampel asli Java GraalVM
• aplikasi sampel Node.js
• Aplikasi sampel Python

Langkah berikutnya

Inti ASP.NET

• Untuk detail tentang menambahkan dan memodifikasi Azure Monitor OpenTelemetry, lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry.
• Untuk mengonfigurasi distro OpenTelemetry lebih lanjut, lihat Konfigurasi OpenTelemetry Azure Monitor.
• Untuk meninjau kode sumber, lihat repositori GitHub AspNetCore Azure Monitor.
• Untuk menginstal paket NuGet, periksa pembaruan, atau lihat catatan rilis, lihat halaman Paket NuGet AspNetCore Azure Monitor.
• Untuk lebih terbiasa dengan Azure Monitor dan OpenTelemetry, lihat Aplikasi Contoh Azure Monitor.
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, lihat Repositori GitHub .NET OpenTelemetry.
• Untuk mengaktifkan pengalaman penggunaan, aktifkan pemantauan pengguna web atau browser.
• Untuk meninjau pertanyaan yang sering diajukan, langkah-langkah pemecahan masalah, opsi dukungan, atau untuk memberikan umpan balik OpenTelemetry, lihat Bantuan, dukungan, dan umpan balik OpenTelemetry untuk Azure Monitor Application Insights.

.NET

• Untuk detail tentang menambahkan dan memodifikasi Azure Monitor OpenTelemetry, lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry.
• Untuk mengonfigurasi distro OpenTelemetry lebih lanjut, lihat Konfigurasi OpenTelemetry Azure Monitor.
• Untuk meninjau kode sumber, lihat Repositori GitHub Pengekspor Azure Monitor.
• Untuk memasang paket NuGet, periksa pembaruan, atau lihat catatan rilis, kunjungi halaman Paket NuGet Pengekspor Azure Monitor.
• Untuk lebih terbiasa dengan Azure Monitor dan OpenTelemetry, lihat Aplikasi Contoh Azure Monitor.
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, lihat Repositori GitHub .NET OpenTelemetry.
• Untuk mengaktifkan pengalaman penggunaan, aktifkan pemantauan pengguna web atau browser.
• Untuk meninjau pertanyaan yang sering diajukan, langkah-langkah pemecahan masalah, opsi dukungan, atau untuk memberikan umpan balik OpenTelemetry, lihat Bantuan, dukungan, dan umpan balik OpenTelemetry untuk Azure Monitor Application Insights.

Java

• Lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry untuk detail tentang menambahkan dan memodifikasi Azure Monitor OpenTelemetry.
• Tinjau opsi konfigurasi autoinstrumentasi Java.
• Tinjau kode sumber di repositori GitHub autoinstrumentasi Java Azure Monitor.
• Pelajari selengkapnya tentang OpenTelemetry dan komunitasnya di repositori OpenTelemetry Java GitHub.
• Aktifkan pengalaman penggunaan dengan melihat Mengaktifkan pemantauan pengguna web atau browser.
• Tinjau catatan rilis di GitHub.
• Untuk meninjau pertanyaan yang sering diajukan, langkah-langkah pemecahan masalah, opsi dukungan, atau untuk memberikan umpan balik OpenTelemetry, lihat Bantuan, dukungan, dan umpan balik OpenTelemetry untuk Azure Monitor Application Insights.

Asli Java

• Lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry untuk detail tentang menambahkan dan memodifikasi Azure Monitor OpenTelemetry.
• Tinjau kode sumber di Azure Monitor OpenTelemetry Distro di aplikasi Java gambar asli Spring Boot dan Quarkus OpenTelemetry Exporter untuk Azure.
• Pelajari selengkapnya tentang OpenTelemetry dan komunitasnya di repositori OpenTelemetry Java 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.
• Tinjau catatan rilis di GitHub.
• Untuk meninjau pertanyaan yang sering diajukan, langkah-langkah pemecahan masalah, opsi dukungan, atau untuk memberikan umpan balik OpenTelemetry, lihat Bantuan, dukungan, dan umpan balik OpenTelemetry untuk Azure Monitor Application Insights.

Node.js

• Untuk detail tentang menambahkan dan memodifikasi Azure Monitor OpenTelemetry, lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry.
• Untuk meninjau kode sumber, lihat repositori GitHub OpenTelemetry Azure Monitor.
• Untuk menginstal paket npm dan memeriksa pembaruan, lihat @azure/monitor-opentelemetry halaman Paket npm.
• Untuk mengenal lebih jauh tentang Azure Monitor Application Insights dan OpenTelemetry, lihatAplikasi Contoh Azure Monitor.
• Untuk mempelajari selengkapnya tentang OpenTelemetry dan komunitasnya, lihat Repositori GitHub JavaScript OpenTelemetry.
• Untuk mengaktifkan pengalaman penggunaan, aktifkan pemantauan pengguna web atau browser.
• Untuk meninjau pertanyaan yang sering diajukan, langkah-langkah pemecahan masalah, opsi dukungan, atau untuk memberikan umpan balik OpenTelemetry, lihat Bantuan, dukungan, dan umpan balik OpenTelemetry untuk Azure Monitor Application Insights.

Python

• Lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry untuk detail tentang menambahkan dan memodifikasi Azure Monitor OpenTelemetry.
• Tinjau kode sumber dan dokumentasi tambahan di repositori GitHub Distro Azure Monitor.
• Lihat sampel tambahan dan kasus penggunaan dalam sampel Azure Monitor Distro.
• Tinjau changelog di GitHub.
• Instal paket PyPI, periksa pembaruan, atau lihat catatan rilis di halaman Paket PyPI Distro Azure Monitor.
• Menjadi lebih terbiasa dengan Azure Monitor Application Insights dan OpenTelemetry di Aplikasi Contoh Azure Monitor.
• Pelajari selengkapnya tentang OpenTelemetry dan komunitasnya di repositori OpenTelemetry Python GitHub.
• Lihat instrumentasi dan komponen OpenTelemetry yang tersedia di repositori GitHub Kontributor OpenTelemetry Python.
• Aktifkan pengalaman penggunaan dengan mengaktifkan pemantauan pengguna web atau browser.
• Untuk meninjau pertanyaan yang sering diajukan, langkah-langkah pemecahan masalah, opsi dukungan, atau untuk memberikan umpan balik OpenTelemetry, lihat Bantuan, dukungan, dan umpan balik OpenTelemetry untuk Azure Monitor Application Insights.