.NET, Node.js, Python ve Java uygulamaları için Azure İzleyici 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ılacağı açıklanır. Azure İzleyici OpenTelemetry Dağıtımı:

• Azure İzleyici'ye özgü özellikler için destek içeren bir OpenTelemetry dağıtımı sağlar.
• İ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 daha fazla telemetri izlemek ve toplamak için Canlı Ölçümleri destekler.

Azure İzleyici OpenTelemetry Distro kullanmanın avantajları hakkında daha fazla bilgi için bkz. Neden Azure İzleyici OpenTelemetry Distro kullanmalıyım?

OpenTelemetry kullanarak veri toplama hakkında daha fazla bilgi edinmek için Veri Toplama temel bilgileri veya OpenTelemetry SSS bölümüne bakın.

OpenTelemetry yayın durumu

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

Not

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

Application Insights ile OpenTelemetry'yi etkinleştirme

Uygulamanızı OpenTelemetry ile izlemek 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 bir Azure aboneliği oluşturma
• Application Insights kaynağı: Application Insights kaynağı oluşturma

ASP.NET Core

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

İpucu

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

.NET

• Desteklenen bir .NET veya .NET Framework 4.6.2 ve üzeri sürümünü kullanan uygulama.

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

• 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 İzleyici OpenTelemetry Exporter tarafından desteklenen çalışma zamanları

Not

Desteklenmeyen tabloda listelenen özelliklere güvenmezseniz, ApplicationInsights dolgusu beta sürümünden bir kez ileriye doğru en kolay yolunuz olacaktır.

Bu özelliklerden herhangi birine güveniyorsanız Azure İzleyici OpenTelemetry Distro ile devam edin. Yakında bir geçiş kılavuzu sağlayacağız.

İpucu

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

Piton

• Python 3.8+ kullanan 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 yerel

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 Arşivi) dosyaları için bu yönergeleri 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 paketini 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

Piton

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

pip install azure-monitor-opentelemetry

Uygulamanızı değiştirme

ASP.NET Core

Ad alanını içeri aktarın Azure.Monitor.OpenTelemetry.AspNetCore , OpenTelemetry ekleyin ve sınıfınızda program.cs Azure İzleyici'yi 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

Sınıfındaki her OpenTelemetry sinyaline Azure İzleyici Verme Aracı'nı program.cs 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 bkz. OpenTelemetry .NET için kullanmaya başlama öğreticisi

Java

Otomatik yetkisiz erişim, yapılandırma değişiklikleriyle etkinleştirilir. Kod değişikliği gerekmez.

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

Not

Örnekleme varsayılan olarak saniyede 5 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. Spring Boot ile Azure İzleyici Application Insights'ı kullanma.

Java yerel

Otomatik yetkisiz erişim, 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();

Piton

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ı dizesi kopyalama

bağlantı dizesi benzersizdir ve Azure İzleyici 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.

bağlantı dizesi kopyalamak için:

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

bağlantı dizesi ortamınıza yapıştırma

bağlantı dizesi yapıştırmak için aşağıdaki seçeneklerden birini belirleyin:

Önemli

bağlantı dizesi 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 komutta değerini bağlantı dizesi ile değiştirin<Your connection string>.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Yapılandırma dosyası - aracılığıyla ayarlamaYalnızca 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 değerini benzersiz bağlantı dizesi ile <Your connection string> değiştirin.

• Kod - aracılığıyla ayarlamaYalnızca ASP.NET Core, Node.jsve Python

  Kod aracılığıyla bağlantı dizesi ayarlama örneği için bkz. bağlantı dizesi yapılandırması.

Not

bağlantı dizesi birden çok yerde ayarlarsanız ortam değişkenine aşağıdaki sırayla öncelik verilecektir:

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.

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. Daha fazla bilgi edinmek için bkz. Azure Application Insights'ta statsbeat.

Örnek uygulamalar

Azure İzleyici 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 uygulama
• Python örnek uygulamaları

Sonraki adımlar

ASP.NET Core

• Azure İzleyici OpenTelemetry ekleme ve değiştirme hakkında ayrıntılı bilgi için bkz. Azure İzleyici OpenTelemetry ekleme ve değiştirme.
• OpenTelemetry dağıtımını daha fazla yapılandırmak için bkz. Azure İzleyici OpenTelemetry yapılandırması.
• Kaynak kodu gözden geçirmek için bkz. Azure İzleyici AspNetCore GitHub deposu.
• NuGet paketini yüklemek, güncelleştirmeleri denetlemek veya sürüm notlarını görüntülemek için Azure İzleyici AspNetCore NuGet Paketi sayfasına bakın.
• Azure İzleyici ve OpenTelemetry hakkında daha fazla bilgi edinmek için bkz. Azure İzleyici Ö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 Azure Monitor Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi bölümüne bakın.

.NET

• Azure İzleyici OpenTelemetry ekleme ve değiştirme hakkında ayrıntılı bilgi için bkz. Azure İzleyici OpenTelemetry ekleme ve değiştirme.
• OpenTelemetry dağıtımını daha fazla yapılandırmak için bkz. Azure İzleyici OpenTelemetry yapılandırması.
• Kaynak kodu gözden geçirmek için bkz. Azure İzleyici Exporter GitHub deposu.
• NuGet paketini yüklemek, güncelleştirmeleri denetlemek veya sürüm notlarını görüntülemek için Azure İzleyici Exporter NuGet Paketi sayfasına bakın.
• Azure İzleyici ve OpenTelemetry hakkında daha fazla bilgi edinmek için bkz. Azure İzleyici Ö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 Azure Monitor Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi bölümüne bakın.

Java

• Azure İzleyici OpenTelemetry ekleme ve değiştirme hakkında ayrıntılı bilgi için bkz. Azure İzleyici OpenTelemetry ekleme ve değiştirme.
• Java otomatik enstrümantasyon yapılandırma seçeneklerini gözden geçirin.
• Azure İzleyici Java otomatik enstrümantasyon GitHub deposundaki kaynak kodu gözden geçirin.
• OpenTelemetry Java GitHub deposunda 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'da sürüm notlarını 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 Azure Monitor Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi bölümüne bakın.

Java yerel

• Azure İzleyici OpenTelemetry ekleme ve değiştirme hakkında ayrıntılı bilgi için bkz. Azure İzleyici OpenTelemetry ekleme ve değiştirme.
• Spring Boot yerel görüntüsü Java uygulamasında Azure Monitor OpenTelemetry Dağıtımı ve Azure için Quarkus OpenTelemetry Exporter kaynak kodunu gözden geçirin.
• OpenTelemetry Java GitHub deposunda 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
• Azure için Quarkus OpenTelemetry Exporter içindeki Quarkus yerel uygulamaları için daha fazla özellik öğrenin.
• GitHub'da sürüm notlarını 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 Azure Monitor Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi bölümüne bakın.

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 İzleyici OpenTelemetry ekleme ve değiştirme hakkında ayrıntılı bilgi için bkz. Azure İzleyici OpenTelemetry ekleme ve değiştirme.
• Kaynak kodunu gözden geçirmek için Azure Monitor OpenTelemetry GitHub deposuna bakın.
• npm paketini yüklemek ve güncelleştirmeleri denetlemek için npm Paketi sayfasına bakın@azure/monitor-opentelemetry.
• Azure İzleyici Uygulama İçgörüleri ve OpenTelemetry hakkında daha fazla bilgi edinmek için Azure İzleyici Örnek Uygulaması'na bakın.
• 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 Azure Monitor Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi bölümüne bakın.

Piton

• Azure İzleyici OpenTelemetry ekleme ve değiştirme hakkında ayrıntılı bilgi için bkz. Azure İzleyici OpenTelemetry ekleme ve değiştirme.
• Azure İzleyici Distro GitHub deposundaki kaynak kodu ve ek belgeleri gözden geçirin.
• Azure Monitor Distro örneklerinde ek örnekler ve kullanım durumlarını görebilirsiniz.
• GitHub'da değişiklik günlüğü'ne göz atın.
• PyPI paketini yükleyin, güncelleştirmeleri denetleyin veya Azure İzleyici Distro PyPI Paketi sayfasında sürüm notlarını görüntüleyin.
• Azure Monitor Örnek Uygulamasında Azure Monitor Application Insights ve OpenTelemetry ile daha iyi tanışın.
• OpenTelemetry Python GitHub deposunda OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinin.
• OpenTelemetry Katılımcısı Python GitHub deposundaki kullanılabilir OpenTelemetry izlemeleri 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 Azure Monitor Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi bölümüne bakın.