.NET, Node.js, Python ve Java uygulamaları için Azure Monitor OpenTelemetry'yi etkinleştirme

Bu makalede, Azure Monitor Application Insights içinde OpenTelemetry tabanlı veri toplamanın nasıl etkinleştirileceği ve yapılandırıldığı açıklanır. Azure Monitor OpenTelemetry Dağıtımı:

• OpenTelemetry dağıtımı sağlar ve Azure Monitor özgü özellikler için destek içerir.
• İzlemeleri, ölçümleri, günlükleri ve özel durumları toplamak için OpenTelemetry izleme kitaplıklarını ekleyerek otomatik telemetriyi etkinleştirir.
• Özel telemetrinin toplanmasına izin verir.
• Canlı, üretim içi web uygulamalarından telemetriyi izlemek ve toplamak için Canlı Ölçümleri destekler.

Azure Monitor OpenTelemetry Distro kullanmanın avantajları hakkında daha fazla bilgi için bkz. Azure Monitor OpenTelemetry Distro’yu neden kullanmalıyım?.

OpenTelemetry kullanarak veri toplama hakkında daha fazla bilgi edinmek için Application Insights deneyimleri için OpenTelemetry (OTel) toplama kılavuzuna veya OpenTelemetry SSS bölümüne bakın.

OpenTelemetry yayın durumu

openTelemetry teklifleri .NET, Node.js, Python ve Java uygulamaları için kullanılabilir. Özelliğe göre yayın durumu için bkz. SSS.

Not

Azure İşlev Uygulamaları için bkz. Azure Functions ile OpenTelemetry kullanma.

Application Insights ile OpenTelemetry'yi etkinleştirme

Uygulamanızı OpenTelemetry ile araçlandırmak için bu bölümdeki adımları izleyin. Dile özgü yönergeler için bir sekme seçin.

Not

.NET; klasik ASP.NET, konsol uygulamaları, Windows Forms (WinForms) ve daha fazlası dahil olmak üzere birden çok senaryoya yöneliktir.

Önkoşullar

• Azure aboneliği: Ücretsiz Azure aboneliği oluşturma
• Application Insights kaynağı: Application Insights kaynağı oluşturma

ASP.NET Core

• resmi olarak desteklenen bir .NET sürümünü kullanarak ASP.NET Core Uygulaması

İpucu

Application Insights Klasik API'sinden geçiş gerçekleştiriyorsanız geçiş belgelerimize bakın.

.NET

• Uygulama, desteklenen bir sürüm olan .NET veya .NET Framework 4.6.2 ve sonraki sürümleri kullanır.

İpucu

Application Insights Klasik API'sinden geçiş gerçekleştiriyorsanız geçiş belgelerimize bakın.

Java

• Java 8+ kullanan bir Java uygulaması

Java native

• GraalVM 17+ kullanan bir Java uygulaması

Node.js

• Node.js çalışma zamanının resmi olarak desteklenen bir sürümünü kullanan uygulama:
  • OpenTelemetry tarafından desteklenen çalışma zamanları
  • Azure Monitor OpenTelemetry Exporter desteklenen çalışma zamanları

Not

Desteklenmeyen tabloda listelenen herhangi bir özelliğe güvenmiyorsanız , ApplicationInsights şimi beta sürümünden çıktığınızda en kolay yol olarak kullanabilirsiniz.

Azure Monitor OpenTelemetry Distro'yu kullanmaya devam edin, eğer bu özelliklerden herhangi birine güveniyorsanız.

İpucu

Application Insights Klasik API'sinden geçiş gerçekleştiriyorsanız geçiş belgelerimize bakın.

Python

• Python 3.8+ kullanarak Python uygulaması

İpucu

OpenCensus'tan geçiş gerçekleştiriyorsanız geçiş belgelerimize bakın.

İstemci kitaplığını yükleme

ASP.NET Core

En son Azure.Monitor.OpenTelemetry.AspNetCoreNuGet paketini yükleyin:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

En son Azure.Monitor.OpenTelemetry.ExporterNuGet paketini yükleyin:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

En son applicationinsights-agent-3.7.4.jar dosyasını indirin.

Uyarı

Önceki bir 3.x sürümünden yükseltme yapıyorsanız, topladığımız verilerdeki varsayılan değerleri veya küçük farkları değiştirdiğinizde etkilenebilirsiniz. Daha fazla bilgi için sürüm notlarındaki geçiş bölümüne bakın. 3.5.0, 3.4.0, 3.3.0, 3.2.0 ve 3.1.0

Java native

Spring Boot yerel uygulamaları için:

• OpenTelemetry Malzeme Listelerini (BOM) içeri aktarın.
• Spring Cloud Azure Starter İzleyici bağımlılığını ekleyin.
• Azure SDK JAR (Java Archive) dosyaları için <> yönergelerini izleyin.

Quarkus yerel uygulamaları için:

• Quarkus OpenTelemetry Exporter for Azure bağımlılığını ekleyin.

Not

Quarkus topluluğu, Quarkus uzantılarını destekler ve korur. Yardım için Quarkus topluluk destek kanallarını kullanın. Microsoft bu tümleştirme için teknik destek sağlamaz.

Node.js

En son @azure/monitor-opentelemetry paketi yükleyin:

npm install @azure/monitor-opentelemetry

Aşağıdaki paketler, bu makalenin devamında açıklanan bazı belirli senaryolar için de kullanılır:

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

En son azure-monitor-opentelemetry PyPI paketini yükleyin:

pip install azure-monitor-opentelemetry

Uygulamanızı değiştirme

ASP.NET Core

Azure.Monitor.OpenTelemetry.AspNetCore ad alanını içeri aktarın, OpenTelemetry ekleyin ve program.cs sınıfınızda Azure Monitor kullanacak şekilde yapılandırın:

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

program.cs sınıfındaki her OpenTelemetry sinyaline Azure Monitor İhracatçısını ekleyin.

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

Not

Daha fazla bilgi için OpenTelemetry .NET ile ilgili başlangıç kılavuzuna bakın.

Java

Otomatik enstrümantasyon, yapılandırma değişiklikleriyle etkinleştirilir. Kod değişikliği gerekmez.

Uygulamanızın JVM args'sine -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" ekleyerek Java sanal makinesini (JVM) jar dosyasına işaret edin.

Not

Örnekleme varsayılan olarak saniyede beş istek hızında etkinleştirilir ve maliyet yönetimine yardımcı olur. Bu oranı aşan senaryolarda telemetri verileri eksik olabilir. Örnekleme yapılandırmasını değiştirme hakkında daha fazla bilgi için bkz. Örnekleme geçersiz kılmaları. Application Insights'ta beklenmeyen ücretler veya yüksek maliyetler görüyorsanız bu kılavuz yardımcı olabilir. Yüksek telemetri hacmi, veri alımı ani artışları ve yanlış yapılandırılmış örnekleme gibi yaygın nedenleri kapsar. Özellikle maliyet artışları, telemetri hacmi, örneklemenin çalışmaması, veri üst sınırı, yüksek veri alımı veya beklenmeyen faturalama ile ilgili sorunları gideriyorsanız kullanışlıdır. Başlamak için bkz. Application Insights'ta yüksek veri alımı sorunlarını giderme.

İpucu

Senaryoya özgü yönergeler için bkz. Başlarken (Ek).

İpucu

Spring Boot uygulaması geliştirirseniz, isteğe bağlı olarak JVM bağımsız değişkenini programlı bir yapılandırmayla değiştirebilirsiniz. Daha fazla bilgi için bkz. Azure Monitor Application Insights'i Spring Boot ile Kullanma.

Java native

Otomatik enstrümantasyon, yapılandırma değişiklikleriyle etkinleştirilir. Kod değişikliği gerekmez.

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.

Application Insights kaynağınızdan bağlantı dizesini kopyalayın.

connection string benzersizdir ve Azure Monitor OpenTelemetry Distro'sunun topladığı telemetriyi nereye gönderdiğini belirtir.

İpucu

Henüz bir Application Insights kaynağınız yoksa , bu kılavuzu izleyerek bir tane oluşturun. Mevcut bir kaynağı kullanmak yerine yeni bir kaynak oluşturmanızı öneririz.

connection string kopyalamak için:

1. Application Insights kaynağınızın Genel Bakış bölmesine gidin.
2. Bağlantı dizesini bulun.
3. Bağlantı dizesinin üzerine gelin ve Panoya kopyala simgesini seçin.

Ekran görüntüsü, 'Application Insights' genel bakışını ve bağlantı dizesini gösteriyor.

Ortamınıza bağlantı dizgesini yapıştırın.

connection string yapıştırmak için aşağıdaki seçeneklerden birini belirleyin:

Önemli

connection string yalnızca yerel geliştirme ve test ortamlarında kod aracılığıyla ayarlamanızı öneririz.

Üretim için bir ortam değişkeni veya yapılandırma dosyası kullanın (yalnızca Java).

• Ortam değişkeni - aracılığıyla ayarlamaÖnerilen

  Aşağıdaki komuttaki <Your connection string> yerine connection string yazın.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Yapılandırma dosyası aracılığıyla ayarlanır - Sadece Java

  adlı applicationinsights.jsonbir yapılandırma dosyası oluşturun ve aşağıdaki içerikle aynı dizine applicationinsights-agent-3.7.5.jar yerleştirin:

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

  Önceki JSON'daki <Your connection string> değerini your benzersiz connection string ile değiştirin.

• Kod aracılığıyla ayarla - Yalnızca ASP.NET Core, Node.js ve Python için

  Kod aracılığıyla connection string ayarlama örneği için bkz. connection string configuration.

Not

connection string birden çok yerde ayarlarsanız ortam değişkeninin önceliği aşağıdaki sırayla olur:

1. Kod
2. Ortam değişkeni
3. Yapılandırma dosyası

Verilerin aktığını onaylayın

Uygulamanızı çalıştırın, ardından Azure portalında Application Insights'ı açın. Verilerin gösterilmesi birkaç dakika sürebilir.

Application Insights artık uygulamanız için etkinleştirilmiştir. Aşağıdaki adımlar isteğe bağlıdır ve daha fazla özelleştirmeye olanak sağlar.

Önemli

Aynı Application Insights kaynağına telemetri yayan iki veya daha fazla hizmetiniz varsa, Bunları Uygulama Haritası'nda düzgün bir şekilde göstermek için Bulut Rolü Adları'nı ayarlamanız gerekir.

Not

Application Insights izlemesini kullanmanın bir parçası olarak tanılama verilerini toplar ve Microsoft'a göndeririz. Bu veriler Application Insights'ı çalıştırmamıza ve geliştirmemize yardımcı olur. Application Insights Sık Sorulan Sorular bölümünde hakkında daha fazla bilgi için.

Örnek uygulamalar

Azure Monitor OpenTelemetry örnek uygulamaları desteklenen tüm diller için kullanılabilir:

• ASP.NET Core örnek uygulaması
• NET örnek uygulaması
• Java örnek uygulamalar
• Java GraalVM yerel örnek uygulamaları
• Node.js örnek uygulaması
• Python örnek uygulamalar

Sonraki adımlar

ASP.NET Core

• Azure Monitor OpenTelemetry'yi eklemek ve değiştirmek hakkında ayrıntılı bilgi için bkz. Azure Monitor OpenTelemetry Ekleme ve Değiştirme.
• OpenTelemetry dağıtımını daha fazla yapılandırmak için bkz. Azure Monitor OpenTelemetry yapılandırması.
• Kaynak kodu gözden geçirmek için Azure Monitor AspNetCore GitHub deposuna bakın.
• NuGet paketini yüklemek, güncelleştirmeleri denetlemek veya sürüm notlarını görüntülemek için Azure Monitor AspNetCore NuGet Package sayfasına bakın.
• Azure Monitor ve OpenTelemetry hakkında daha fazla bilgi edinmek için bkz. Azure Monitor Örnek Uygulaması.
• OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinmek için bkz. OpenTelemetry .NET GitHub deposu.
• Kullanım deneyimlerini etkinleştirmek için web veya tarayıcı kullanıcı izlemeyi etkinleştirin.
• Sık sorulan soruları, sorun giderme adımlarını, destek seçeneklerini gözden geçirmek veya OpenTelemetry geri bildirimi sağlamak için bkz. OpenTelemetry yardımı, desteği ve Azure Monitor Application Insights için geri bildirim.

.NET

• Azure Monitor OpenTelemetry'yi eklemek ve değiştirmek hakkında ayrıntılı bilgi için bkz. Azure Monitor OpenTelemetry Ekleme ve Değiştirme.
• OpenTelemetry dağıtımını daha fazla yapılandırmak için bkz. Azure Monitor OpenTelemetry yapılandırması.
• Kaynak kodu gözden geçirmek için bkz. Azure Monitor Exporter GitHub deposu.
• NuGet paketini yüklemek, güncelleştirmeleri denetlemek veya sürüm notlarını görüntülemek için Azure Monitor Exporter NuGet Package sayfasına bakın.
• Azure Monitor ve OpenTelemetry hakkında daha fazla bilgi edinmek için bkz. Azure Monitor Örnek Uygulaması.
• OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinmek için bkz. OpenTelemetry .NET GitHub deposu.
• Kullanım deneyimlerini etkinleştirmek için web veya tarayıcı kullanıcı izlemeyi etkinleştirin.
• Sık sorulan soruları, sorun giderme adımlarını, destek seçeneklerini gözden geçirmek veya OpenTelemetry geri bildirimi sağlamak için bkz. OpenTelemetry yardımı, desteği ve Azure Monitor Application Insights için geri bildirim.

Java

• Azure Monitor OpenTelemetry ekleme ve değiştirmeyle ilgili ayrıntılı bilgi için bkz. Azure Monitor OpenTelemetry ekleme ve değiştirme.
• Java otomatik araçlandırma yapılandırma seçeneklerini gözden geçirin.
• Azure Monitor Java autoinstrumentation GitHub deposundaki kaynak kodu gözden geçirin.
• OpenTelemetry Java GitHub deposundaki OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinin.
• Web veya tarayıcı kullanıcı izlemeyi etkinleştirme bölümüne bakarak kullanım deneyimlerini etkinleştirme.
• GitHub'daki release notes gözden geçirin.
• Sık sorulan soruları, sorun giderme adımlarını, destek seçeneklerini gözden geçirmek veya OpenTelemetry geri bildirimi sağlamak için bkz. OpenTelemetry yardımı, desteği ve Azure Monitor Application Insights için geri bildirim.

Java native

• Azure Monitor OpenTelemetry ekleme ve değiştirmeyle ilgili ayrıntılı bilgi için bkz. Azure Monitor OpenTelemetry ekleme ve değiştirme.
• Azure Monitor OpenTelemetry Distro in Spring Boot yerel görüntü Java uygulamasında ve Quarkus OpenTelemetry Exporter for Azure kaynak kodunu gözden geçirin.
• OpenTelemetry Java GitHub deposundaki OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinin.
• OpenTelemetry SpringBoot starter'da Spring Boot yerel görüntü uygulamaları için daha fazla özellik öğrenin
• Quarkus OpenTelemetry Exporter for Azure içindeki Quarkus yerel uygulamaları için daha fazla özellik öğrenin.
• GitHub'daki release notes gözden geçirin.
• Sık sorulan soruları, sorun giderme adımlarını, destek seçeneklerini gözden geçirmek veya OpenTelemetry geri bildirimi sağlamak için bkz. OpenTelemetry yardımı, desteği ve Azure Monitor Application Insights için geri bildirim.

Not

Quarkus topluluğu, Quarkus uzantılarını destekler ve korur. Yardım için Quarkus topluluk destek kanallarını kullanın. Microsoft bu tümleştirme için teknik destek sağlamaz.

Node.js

• Azure Monitor OpenTelemetry'yi eklemek ve değiştirmek hakkında ayrıntılı bilgi için bkz. Azure Monitor OpenTelemetry Ekleme ve Değiştirme.
• Kaynak kodu gözden geçirmek için bkz. Azure Monitor OpenTelemetry GitHub deposu.
• npm paketini yüklemek ve güncelleştirmeleri denetlemek için npm Paketi sayfasına bakın@azure/monitor-opentelemetry.
• Azure Monitor Application Insights ve OpenTelemetry hakkında daha fazla bilgi edinmek için bkz. Azure Monitor Örnek Uygulaması.
• OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinmek için bkz. OpenTelemetry JavaScript GitHub deposu.
• Kullanım deneyimlerini etkinleştirmek için web veya tarayıcı kullanıcı izlemeyi etkinleştirin.
• Sık sorulan soruları, sorun giderme adımlarını, destek seçeneklerini gözden geçirmek veya OpenTelemetry geri bildirimi sağlamak için bkz. OpenTelemetry yardımı, desteği ve Azure Monitor Application Insights için geri bildirim.

Python

• Azure Monitor OpenTelemetry ekleme ve değiştirmeyle ilgili ayrıntılı bilgi için bkz. Azure Monitor OpenTelemetry ekleme ve değiştirme.
• Azure Monitor Distro GitHub deposunda kaynak kodunu ve ek belgeleri gözden geçirin.
• Ek örnekler ve kullanım durumları için Azure Monitor Distro örnekleri'ne bakın.
• Değişiklik günlüğünü GitHub'da gözden geçirin.
• PyPI paketini yükleyin, güncelleştirmeleri denetleyin veya Azure Monitor Distro PyPI Paketi sayfasında sürüm notlarını görüntüleyin.
• Azure Monitor Örnek Uygulaması Azure Monitor Application Insights ve OpenTelemetry hakkında daha fazla bilgi edinin.
• OpenTelemetry Python GitHub deposundaki OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinin.
• OpenTelemetry Contributor Python GitHub deposundaki kullanılabilir OpenTelemetry araçlarına ve bileşenlerine bakın.
• Web veya tarayıcı kullanıcı izlemesini etkinleştirerek kullanım deneyimlerini etkinleştirin.
• Sık sorulan soruları, sorun giderme adımlarını, destek seçeneklerini gözden geçirmek veya OpenTelemetry geri bildirimi sağlamak için bkz. OpenTelemetry yardımı, desteği ve Azure Monitor Application Insights için geri bildirim.