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

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(options =>
    {
        options.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.5.4.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.5.4.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.

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

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.

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.

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.

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.

Tanya jawab umum

Bagian ini menyediakan jawaban atas pertanyaan umum.

Apa itu OpenTelemetry?

Ini adalah standar sumber terbuka baru untuk pengamatan. Pelajari lebih lanjut di OpenTelemetry.

Mengapa Microsoft Azure Monitor berinvestasi di OpenTelemetry?

Microsoft berinvestasi di OpenTelemetry karena alasan berikut:

• Ini netral vendor dan menyediakan API/SDK yang konsisten di seluruh bahasa.
• Seiring waktu, kami percaya OpenTelemetry akan memungkinkan pelanggan Azure Monitor untuk mengamati aplikasi yang ditulis dalam bahasa di luar bahasa yang didukung.
• Ini memperluas jenis data yang dapat Anda kumpulkan melalui serangkaian pustaka instrumentasi yang kaya.
• OpenTelemetry Software Development Kits (SDK) cenderung lebih berkinerja dalam skala besar daripada pendahulunya, SDK Application Insights.
• OpenTelemetry selaras dengan strategi Microsoft untuk merangkul sumber terbuka.

Bagaimana status OpenTelemetry?

Lihat Status OpenTelemetry.

Apa itu Distro OpenTelemetry Azure Monitor?

Anda dapat menganggapnya sebagai pembungkus tipis yang menggabungkan semua komponen OpenTelemetry untuk pengalaman kelas satu di Azure. Pembungkus ini juga disebut distribusi di OpenTelemetry.

Mengapa saya harus menggunakan Distro OpenTelemetry Azure Monitor?

Ada beberapa keuntungan menggunakan Distro OpenTelemetry Azure Monitor daripada OpenTelemetry asli dari komunitas:

• Mengurangi upaya pengaktifan
• Didukung oleh Microsoft
• Membawa fitur khusus Azure seperti:
  • Pengambilan sampel yang kompatibel dengan SDK Application Insights klasik
  • Autentikasi Microsoft Entra
  • Penyimpanan Offline dan Coba Lagi Otomatis
  • Statsbeat
  • Metrik Standar Application Insights
  • Mendeteksi metadata sumber daya untuk mengisi otomatis Nama Peran Cloud dan Instans Peran Cloud di berbagai lingkungan Azure
  • Metrik Langsung

Dalam semangat OpenTelemetry, kami merancang distro agar terbuka dan dapat diperluas. Misalnya, Anda dapat menambahkan:

• Pengekspor OpenTelemetry Protocol (OTLP) dan mengirim ke tujuan kedua secara bersamaan
• Pustaka instrumentasi lain yang tidak termasuk dalam distro

Karena Distro menyediakan distribusi OpenTelemetry, Distro mendukung apa pun yang didukung oleh OpenTelemetry. Misalnya, Anda dapat menambahkan lebih banyak prosesor telemetri, pengekspor, atau pustaka instrumentasi, jika OpenTelemetry mendukungnya.

Catatan

Distro mengatur sampler ke sampler laju tetap kustom untuk Application Insights. Anda dapat mengubah ini ke sampler yang berbeda, tetapi melakukannya mungkin menonaktifkan beberapa kemampuan yang disertakan Distro. Untuk informasi selengkapnya tentang sampler yang didukung, lihat bagian Aktifkan Pengambilan Sampel di Mengonfigurasi Azure Monitor OpenTelemetry.

Untuk bahasa tanpa pengekspor OpenTelemetry mandiri yang didukung, Distro OpenTelemetry Azure Monitor adalah satu-satunya cara yang saat ini didukung untuk menggunakan OpenTelemetry dengan Azure Monitor. Untuk bahasa dengan pengekspor OpenTelemetry mandiri yang didukung, Anda memiliki opsi untuk menggunakan Distro OpenTelemetry Azure Monitor atau pengekspor OpenTelemetry mandiri yang sesuai tergantung pada skenario telemetri Anda. Untuk informasi selengkapnya, lihat Kapan saya harus menggunakan pengekspor OpenTelemetry Azure Monitor?.

Bagaimana cara menguji Distro OpenTelemetry Azure Monitor?

Lihat dokumen pengaktifan kami untuk .NET, Java, JavaScript (Node.js), dan Python.

Haruskah saya menggunakan OpenTelemetry atau Application Insights SDK?

Sebaiknya gunakan Distro OpenTelemetry kecuali Anda memerlukan fitur yang hanya tersedia dengan dukungan formal di Application Insights SDK.

Mengadopsi OpenTelemetry sekarang mencegah harus bermigrasi di kemudian hari.

Kapan saya harus menggunakan pengekspor OpenTelemetry Azure Monitor?

Untuk ASP.NET Core, Java, Node.js, dan Python, sebaiknya gunakan Distro OpenTelemetry Azure Monitor. Ini adalah satu baris kode untuk memulai.

Untuk semua skenario .NET lainnya, termasuk ASP.NET klasik, aplikasi konsol, Formulir Windows (WinForms), dll., sebaiknya gunakan pengekspor OpenTelemetry .NET Azure Monitor: Azure.Monitor.OpenTelemetry.Exporter.

Untuk skenario telemetri Python yang lebih kompleks yang memerlukan konfigurasi tingkat lanjut, sebaiknya gunakan Python Azure Monitor OpenTelemetry Exporter.

Apa status rilis fitur saat ini dalam Distro OpenTelemetry Azure Monitor?

Bagan berikut memecah dukungan fitur OpenTelemetry untuk setiap bahasa.

Fitur	.NET	Node.js	Python	Java
Pelacakan terdistribusi	✅	✅	✅	✅
Metrik kustom	✅	✅	✅	✅
Metrik standar	✅	✅	✅	✅
Pengambilan sampel laju tetap	✅	✅	✅	✅
Penyimpanan offline dan percobaan ulang otomatis	✅	✅	✅	✅
Pelaporan pengecualian	✅	✅	✅	✅
Koleksi log	✅	⚠️	✅	✅
Kejadian Kustom	⚠️	⚠️	⚠️	✅
Autentikasi Microsoft Entra	✅	✅	✅	✅
Metrik langsung	✅	✅	✅	✅
Pemfilteran Metrik Langsung	✅	❌	❌	❌
Mendeteksi Konteks Sumber Daya untuk VM/VMSS dan App Service	✅	❌	✅	✅
Mendeteksi Konteks Sumber Daya untuk Azure Kubernetes Service (AKS) dan Functions	❌	❌	❌	✅
Peristiwa Pengujian Ketersediaan yang dihasilkan menggunakan API Ketersediaan Lacak	❌	❌	❌	✅
Memfilter permintaan, dependensi, log, dan pengecualian berdasarkan ID pengguna anonim dan sumber sintetis	❌	❌	❌	✅
Memfilter dependensi, log, dan pengecualian berdasarkan nama operasi	❌	❌	❌	✅
Pengambilan sampel adaptif	❌	❌	❌	✅
Profiler	❌	❌	❌	⚠️
Snapshot Debugger	❌	❌	❌	❌

Kunci

• ✅ Fitur ini tersedia untuk semua pelanggan dengan dukungan formal.
• ⚠️ Fitur ini tersedia sebagai pratinjau publik. Lihat Ketentuan penggunaan tambahan untuk pratinjau Microsoft Azure.
• ❌ Fitur ini tidak tersedia atau tidak berlaku.

Dapatkah OpenTelemetry digunakan untuk browser web?

Ya, tetapi kami tidak merekomendasikannya dan Azure tidak mendukungnya. OpenTelemetry JavaScript sangat dioptimalkan untuk Node.js. Sebagai gantinya, sebaiknya gunakan Application Insights JavaScript SDK.

Kapan kita dapat mengharapkan OpenTelemetry SDK tersedia untuk digunakan di browser web?

SDK web OpenTelemetry tidak memiliki garis waktu ketersediaan yang ditentukan. Kami kemungkinan beberapa tahun lagi dari SDK browser yang merupakan alternatif yang layak untuk Application Insights JavaScript SDK.

Dapatkah saya menguji OpenTelemetry di browser web hari ini?

Kotak pasir web OpenTelemetry adalah fork yang dirancang untuk membuat OpenTelemetry berfungsi di browser. Belum dimungkinkan untuk mengirim telemetri ke Application Insights. SDK tidak menentukan peristiwa klien umum.

Apakah menjalankan Application Insights bersama agen pesaing seperti AppDynamics, DataDog, dan NewRelic didukung?

Praktik ini bukan sesuatu yang kami rencanakan untuk diuji atau didukung, meskipun Distro kami memungkinkan Anda mengekspor ke titik akhir OTLP bersama Azure Monitor secara bersamaan.

Dapatkah saya menggunakan fitur pratinjau di lingkungan produksi?

Kami tidak merekomendasikannya. Lihat Ketentuan penggunaan tambahan untuk pratinjau Microsoft Azure.

Apa perbedaan antara instrumentasi manual dan otomatis?

Lihat Gambaran Umum OpenTelemetry.

Dapatkah saya menggunakan OpenTelemetry Collector?

Beberapa pelanggan menggunakan OpenTelemetry Collector sebagai alternatif agen, meskipun Microsoft belum secara resmi mendukung pendekatan berbasis agen untuk pemantauan aplikasi. Sementara itu, komunitas sumber terbuka berkontribusi pada Pengumpul OpenTelemetry Azure Monitor Exporter yang digunakan beberapa pelanggan untuk mengirim data ke Azure Monitor Application Insights. Ini tidak didukung oleh Microsoft.

Apa perbedaan antara OpenCensus dan OpenTelemetry?

OpenCensus adalah pendahulu OpenTelemetry. Microsoft membantu menyatukan OpenTracing dan OpenCensus untuk membuat OpenTelemetry, satu standar pengamatan untuk dunia. Python SDK yang direkomendasikan produksi saat ini untuk Azure Monitor didasarkan pada OpenCensus. Microsoft berkomitmen untuk membuat Azure Monitor berdasarkan OpenTelemetry.

Di Grafana, mengapa saya melihat Status: 500. Can't visualize trace events using the trace visualizer?

Anda dapat mencoba memvisualisasikan log teks mentah daripada jejak OpenTelemetry.

Di Application Insights, tabel 'Jejak' menyimpan log teks mentah untuk tujuan diagnostik. Mereka membantu mengidentifikasi dan menghubungkan jejak yang terkait dengan permintaan pengguna, peristiwa lain, dan laporan pengecualian. Namun, tabel 'Jejak' tidak secara langsung berkontribusi pada tampilan transaksi end-to-end (bagan air terjun) dalam alat visualisasi seperti Grafana.

Dengan meningkatnya adopsi praktik cloud-native, ada evolusi dalam pengumpulan dan terminologi telemetri. OpenTelemetry menjadi standar untuk mengumpulkan dan melengkapi data telemetri. Dalam konteks ini, istilah 'Jejak' mengambil arti baru. Daripada log mentah, 'Jejak' di OpenTelemetry mengacu pada bentuk telemetri terstruktur yang lebih kaya yang mencakup rentang, yang mewakili unit kerja individu. Rentang ini sangat penting untuk membangun tampilan transaksi terperinci, memungkinkan pemantauan dan diagnostik aplikasi cloud-native yang lebih baik.

Pemecahan Masalah

Inti ASP.NET

Langkah 1: Aktifkan pembuatan log diagnostik

Pengekspor Azure Monitor menggunakan EventSource untuk pengelogan internalnya. Log pengekspor tersedia untuk EventListener apa pun dengan memilih sumber yang bernama OpenTelemetry-AzureMonitor-Exporter. Untuk langkah-langkah pemecahan masalah, lihat Pemecahan Masalah OpenTelemetry di GitHub.

Langkah 2: Uji konektivitas antara host aplikasi Anda dan layanan penyerapan

Application Insights SDK dan agen mengirim telemetri untuk diserap sebagai panggilan REST di titik akhir penyerapan kami. Untuk menguji konektivitas dari server web atau komputer host aplikasi Anda ke titik akhir layanan penyerapan, gunakan perintah cURL atau permintaan REST mentah dari PowerShell. Untuk informasi selengkapnya, lihat Memecahkan masalah telemetri aplikasi yang hilang di Azure Monitor Application Insights.

Masalah umum

Item berikut ini diketahui masalah untuk Pengekspor OpenTelemetry Azure Monitor:

• Nama operasi hilang dari telemetri dependensi. Nama operasi yang hilang menyebabkan kegagalan dan berdampak buruk pada pengalaman tab performa.

• Model perangkat hilang dari telemetri permintaan dan dependensi. Model perangkat yang hilang berdampak buruk pada analisis kohor perangkat.

.NET

Langkah 1: Aktifkan pembuatan log diagnostik

Pengekspor Azure Monitor menggunakan EventSource untuk pengelogan internalnya. Log pengekspor tersedia untuk EventListener apa pun dengan memilih sumber yang bernama OpenTelemetry-AzureMonitor-Exporter. Untuk langkah-langkah pemecahan masalah, lihat Pemecahan Masalah OpenTelemetry di GitHub.

Langkah 2: Uji konektivitas antara host aplikasi Anda dan layanan penyerapan

Application Insights SDK dan agen mengirim telemetri untuk diserap sebagai panggilan REST di titik akhir penyerapan kami. Untuk menguji konektivitas dari server web atau komputer host aplikasi Anda ke titik akhir layanan penyerapan, gunakan perintah cURL atau permintaan REST mentah dari PowerShell. Untuk informasi selengkapnya, lihat Memecahkan masalah telemetri aplikasi yang hilang di Azure Monitor Application Insights.

Masalah umum

Item berikut ini diketahui masalah untuk Pengekspor OpenTelemetry Azure Monitor:

• Nama operasi hilang dari telemetri dependensi. Nama operasi yang hilang menyebabkan kegagalan dan berdampak buruk pada pengalaman tab performa.

• Model perangkat hilang dari telemetri permintaan dan dependensi. Model perangkat yang hilang berdampak buruk pada analisis kohor perangkat.

Java

Langkah 1: Aktifkan pembuatan log diagnostik

Secara default, pembuatan log diagnostik diaktifkan di Azure Monitor Application Insights. Untuk informasi selengkapnya, lihat Panduan pemecahan masalah: Azure Monitor Application Insights untuk Java.

Langkah 2: Uji konektivitas antara host aplikasi Anda dan layanan penyerapan

Application Insights SDK dan agen mengirim telemetri untuk diserap sebagai panggilan REST di titik akhir penyerapan kami. Untuk menguji konektivitas dari server web atau komputer host aplikasi Anda ke titik akhir layanan penyerapan, gunakan perintah cURL atau permintaan REST mentah dari PowerShell. Untuk informasi selengkapnya, lihat Memecahkan masalah telemetri aplikasi yang hilang di Azure Monitor Application Insights.

Masalah umum

• Jika Anda mengunduh pustaka klien Application Insights untuk penginstalan dari browser, terkadang file JAR yang diunduh rusak dan sekitar setengah ukuran file sumber. Jika Anda mengalami masalah ini, unduh file JAR dengan menjalankan perintah curl atau wget , seperti yang ditunjukkan dalam contoh panggilan perintah berikut:

  curl --location --output applicationinsights-agent-3.4.11.jar https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.11/applicationinsights-agent-3.4.11.jar
  

  wget --output-document=applicationinsights-agent-3.4.11.jar https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.11/applicationinsights-agent-3.4.11.jar
  

  Catatan

  Contoh panggilan perintah berlaku untuk Application Insights untuk Java versi 3.4.11. Untuk menemukan nomor versi dan alamat URL rilis Application Insights untuk Java saat ini, lihat https://github.com/microsoft/ApplicationInsights-Java/releases.

Asli Java

Langkah-langkah berikut berlaku untuk aplikasi asli Spring Boot.

Langkah 1: Verifikasi versi OpenTelemetry

Anda mungkin melihat pesan berikut selama pengaktifan aplikasi:

WARN  c.a.m.a.s.OpenTelemetryVersionCheckRunner - The OpenTelemetry version is not compatible with the spring-cloud-azure-starter-monitor dependency.
The OpenTelemetry version should be <version>

Dalam hal ini, Anda harus mengimpor OpenTelemetry Bills of Materials dengan mengikuti dokumentasi OpenTelemetry di starter Spring Boot.

Langkah 2: Aktifkan diagnostik mandiri

Jika sesuatu tidak berfungsi seperti yang diharapkan, Anda dapat mengaktifkan diagnostik mandiri di DEBUG tingkat untuk mendapatkan beberapa wawasan. Untuk melakukannya, atur tingkat diagnostik mandiri ke ERROR, , WARN, INFODEBUG, atau TRACE dengan menggunakan APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL variabel lingkungan.

Untuk mengaktifkan diagnostik mandiri pada DEBUG tingkat saat menjalankan kontainer docker, jalankan perintah berikut:

docker run -e APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL=DEBUG <image-name>

Catatan

Ganti <image-name> dengan nama gambar docker yang sesuai.

Penafian informasi pihak ketiga

Produk pihak ketiga yang dibahas di artikel ini diproduksi oleh perusahaan yang tidak berafiliasi apa pun dengan Microsoft. Microsoft tidak memberikan jaminan, tersirat atau sebaliknya, tentang performa atau keandalan produk ini.

Node.js

Langkah 1: Aktifkan pembuatan log diagnostik

Pengekspor Azure Monitor menggunakan pencatat API OpenTelemetry untuk log internal. Untuk mengaktifkan pencatat, jalankan cuplikan kode berikut:

const { diag, DiagConsoleLogger, DiagLogLevel } = require("@opentelemetry/api");
const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");

const provider = new NodeTracerProvider();
diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ALL);
provider.register();

Langkah 2: Uji konektivitas antara host aplikasi Anda dan layanan penyerapan

Application Insights SDK dan agen mengirim telemetri untuk diserap sebagai panggilan REST di titik akhir penyerapan kami. Untuk menguji konektivitas dari server web atau komputer host aplikasi Anda ke titik akhir layanan penyerapan, gunakan perintah cURL atau permintaan REST mentah dari PowerShell. Untuk informasi selengkapnya, lihat Memecahkan masalah telemetri aplikasi yang hilang di Azure Monitor Application Insights.

Masalah umum

Item berikut ini diketahui masalah untuk Pengekspor OpenTelemetry Azure Monitor:

• Nama operasi hilang dari telemetri dependensi. Nama operasi yang hilang menyebabkan kegagalan dan berdampak buruk pada pengalaman tab performa.

• Model perangkat hilang dari telemetri permintaan dan dependensi. Model perangkat yang hilang berdampak buruk pada analisis kohor perangkat.

• Nama server database hilang dari nama dependensi. Karena nama server database tidak disertakan, Pengekspor OpenTelemetry salah mengagregasi tabel yang memiliki nama yang sama ke server yang berbeda.

Python

Langkah 1: Aktifkan pembuatan log diagnostik

Pengekspor Microsoft Azure Monitor menggunakan pustaka pengelogan standar Python untuk pengelogan internalnya. Log OpenTelemetry API dan Pengekspor Azure Monitor diberi tingkat WARNING keparahan atau ERROR untuk aktivitas yang tidak teratur. Tingkat INFO keparahan digunakan untuk aktivitas reguler atau berhasil.

Secara default, pustaka pengelogan Python mengatur tingkat keparahan ke WARNING. Oleh karena itu, Anda harus mengubah tingkat keparahan untuk melihat log di bawah pengaturan tingkat keparahan ini. Contoh kode berikut menunjukkan cara menghasilkan log dari semua tingkat keparahan ke konsol dan file:

...
import logging

logging.basicConfig(format = "%(asctime)s:%(levelname)s:%(message)s", level = logging.DEBUG)

logger = logging.getLogger(__name__)
file = logging.FileHandler("example.log")
stream = logging.StreamHandler()
logger.addHandler(file)
logger.addHandler(stream)
...

Langkah 2: Uji konektivitas antara host aplikasi Anda dan layanan penyerapan

Application Insights SDK dan agen mengirim telemetri untuk diserap sebagai panggilan REST di titik akhir penyerapan kami. Untuk menguji konektivitas dari server web atau komputer host aplikasi Anda ke titik akhir layanan penyerapan, gunakan perintah cURL atau permintaan REST mentah dari PowerShell. Untuk informasi selengkapnya, lihat Memecahkan masalah telemetri aplikasi yang hilang di Azure Monitor Application Insights.

Langkah 3: Hindari telemetri duplikat

Telemetri duplikat sering disebabkan jika Anda membuat beberapa instans prosesor atau eksportir. Pastikan Anda hanya menjalankan satu pengekspor dan prosesor sekaligus untuk setiap pilar telemetri (log, metrik, dan pelacakan terdistribusi).

Bagian berikut menjelaskan skenario yang dapat menyebabkan telemetri duplikat.

Menduplikasi log jejak di Azure Functions

Jika Anda melihat sepasang entri untuk setiap log jejak dalam Application Insights, Anda mungkin mengaktifkan jenis instrumentasi pengelogan berikut:

• Instrumentasi pengelogan asli di Azure Functions
• Instrumentasi azure-monitor-opentelemetry pengelogan dalam distribusi

Untuk mencegah duplikasi, Anda dapat menonaktifkan pengelogan distribusi, tetapi membiarkan instrumentasi pengelogan asli di Azure Functions diaktifkan. Untuk melakukan ini, atur OTEL_LOGS_EXPORTER variabel lingkungan ke None.

Menduplikasi telemetri di Azure Functions "Always On"

Jika pengaturan AlwaysOn di Azure Functions diatur ke Aktif, Azure Functions menyimpan beberapa proses yang berjalan di latar belakang setelah setiap eksekusi selesai. Misalnya, Anda memiliki fungsi timer lima menit yang memanggil configure_azure_monitor setiap kali. Setelah 20 menit, Anda mungkin memiliki empat pengekspor metrik yang berjalan secara bersamaan. Situasi ini mungkin menjadi sumber telemetri metrik duplikat Anda.

Dalam situasi ini, atur pengaturan AlwaysOn ke Nonaktif, atau coba matikan penyedia secara manual di antara setiap configure_azure_monitor panggilan. Untuk mematikan setiap penyedia, jalankan panggilan matikan untuk setiap penyedia pengukur, pelacak, dan pencatat saat ini, seperti yang ditunjukkan dalam kode berikut:

get_meter_provider().shutdown()
get_tracer_provider().shutdown()
get_logger_provider().shutdown()

Buku Kerja Azure dan Jupyter Notebooks

Azure Workbooks dan Jupyter Notebooks mungkin menjaga proses pengekspor tetap berjalan di latar belakang. Untuk mencegah telemetri duplikat, kosongkan cache sebelum Anda melakukan lebih banyak panggilan ke configure_azure_monitor.

Langkah 4: Pastikan data permintaan Flask dikumpulkan

Jika Anda menerapkan aplikasi Flask, Anda mungkin menemukan bahwa Anda tidak dapat mengumpulkan data tabel Permintaan dari Application Insights saat Anda menggunakan pustaka klien Azure Monitor OpenTelemetry Distro untuk Python. Masalah ini dapat terjadi jika Anda tidak menyusun deklarasi dengan import benar. Anda mungkin mengimpor flask.Flask kerangka kerja aplikasi web sebelum memanggil configure_azure_monitor fungsi untuk melengkapi pustaka Flask. Misalnya, kode berikut tidak berhasil melengkapi aplikasi Flask:

from azure.monitor.opentelemetry import configure_azure_monitor
from flask import Flask

configure_azure_monitor()

app = Flask(__name__)

Sebagai gantinya flask , kami sarankan Anda mengimpor modul secara keseluruhan, lalu memanggil configure_azure_monitor untuk mengonfigurasi OpenTelemetry untuk menggunakan Azure Monitor sebelum Anda mengakses flask.Flask:

from azure.monitor.opentelemetry import configure_azure_monitor
import flask

configure_azure_monitor()

app = flask.Flask(__name__)

Atau, Anda dapat memanggil configure_azure_monitor sebelum mengimpor flask.Flask:

from azure.monitor.opentelemetry import configure_azure_monitor

configure_azure_monitor()

from flask import Flask

app = Flask(__name__)

Dukungan

Pilih tab untuk bahasa pilihan Anda untuk menemukan opsi dukungan.

Inti ASP.NET

• Untuk masalah dukungan Azure, buka tiket dukungan Azure.
• 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 dukungan Azure, buka tiket dukungan Azure.
• 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 dukungan Azure, buka tiket dukungan Azure.
• Untuk bantuan pemecahan masalah, tinjau langkah-langkah pemecahan masalah.
• Untuk masalah OpenTelemetry, hubungi komunitas OpenTelemetry secara langsung.
• Untuk daftar masalah terbuka yang terkait dengan Azure Monitor Java Autoinstrumentation, lihat Halaman Masalah GitHub.

Asli Java

• Untuk masalah dukungan Azure, buka tiket dukungan Azure.
• 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.

Node.js

• Untuk masalah dukungan Azure, buka tiket dukungan Azure.
• 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 dukungan Azure, buka tiket dukungan Azure.
• Untuk masalah OpenTelemetry, hubungi komunitas OpenTelemetry Python secara langsung.
• Untuk daftar masalah terbuka yang terkait dengan Azure Monitor Distro, lihat Halaman Masalah GitHub.

Umpan balik OpenTelemetry

Untuk memberikan umpan balik:

• Isi survei umpan balik pelanggan komunitas OpenTelemetry.
• Ceritakan kepada Microsoft tentang diri Anda saat bergabung dengan Komunitas Adopter Awal OpenTelemetry.
• Terlibat dengan pengguna Azure Monitor lainnya di Komunitas Microsoft Tech.
• Buat permintaan fitur di Forum Umpan Balik Azure.