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 untuk 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 yang sedang berjalan di lingkungan 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.

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: Membuat langganan Azure secara gratis
• Sumber daya Application Insights: Membuat sumber daya Application Insights

ASP.NET Core

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

Tips

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.

Tips

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

Jawa

• Aplikasi Java menggunakan Java 8+

Native Java

• Aplikasi Java menggunakan GraalVM 17+

Node.js

• Aplikasi menggunakan versi yang didukung secara resmi dari runtime Node.js.
  • Runtime yang didukung OpenTelemetry
  • Runtime yang didukung oleh 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 salah satu properti tersebut, beralih ke Distro OpenTelemetry Azure Monitor. Kami akan segera menyediakan panduan migrasi.

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

Jawa

Unduh file applicationinsights-agent-3.7.1.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

Native Java

Untuk aplikasi asli Spring Boot :

• ** Impor Daftar 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
• @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

Mengimpor namespace Azure.Monitor.OpenTelemetry.AspNetCore, tambahkan OpenTelemetry, dan konfigurasikan agar menggunakan Azure Monitor di kelas Anda program.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 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

Jawa

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.7.1.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 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 Menggunakan Azure Monitor Application Insights dengan Spring Boot.

Native 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 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 sambungan ini unik dan menentukan lokasi pengiriman telemetri yang dikumpulkan oleh Distro OpenTelemetry Azure Monitor.

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

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

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Atur melalui file konfigurasi - Hanya untuk Java

  Buat file konfigurasi bernama applicationinsights.json, dan letakkan di direktori yang sama seperti applicationinsights-agent-3.7.1.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 cara mengatur 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

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.

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 contoh

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

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

Langkah berikutnya

ASP.NET Core

• Untuk detail tentang menambahkan dan memodifikasi Azure Monitor OpenTelemetry, lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry.
• Untuk mengonfigurasi distribusi 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 distribusi OpenTelemetry lebih lanjut, lihat Konfigurasi OpenTelemetry Azure Monitor.
• Untuk meninjau kode sumber, lihat Repositori GitHub Azure Monitor Exporter.
• 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.

Jawa

• Lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry untuk detail tentang menambahkan dan memodifikasi Azure Monitor OpenTelemetry.
• Tinjau opsi konfigurasi autoinstrumentasi Java.
• Tinjau kode sumbernya di repositori GitHub Azure Monitor autoinstrumentasi Java.
• Pelajari selengkapnya tentang OpenTelemetry dan komunitasnya di repositori OpenTelemetry Java GitHub.
• Aktifkan pengalaman penggunaan dengan melihat Aktifkan pemantauan pengguna web atau peramban.
• 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.

Native 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 pada aplikasi Java Spring Boot dengan gambar native 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.
• Berkenalan lebih lanjut dengan Azure Monitor Application Insights dan OpenTelemetry dalam 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.