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

Bu makalede, Application Insights'ta OpenTelemetry tabanlı veri toplamanın nasıl etkinleştirileceği ve yapılandırıldığı 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.

Application Insights ile OpenTelemetry'yi etkinleştirme

Uygulamanızı OpenTelemetry ile izlemek için bu bölümdeki adımları izleyin. Langauge'a ö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

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

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

Python

• 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.AspNetCore NuGet paketini yükleyin:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

En son Azure.Monitor.OpenTelemetry.Exporter NuGet paketini yükleyin:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

applicationinsights-agent-3.6.0.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 Ürün Reçetelerini (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:

• Azure bağımlılığı için Quarkus OpenTelemetry Exporter öğesini ekleyin.

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 ölçümleri
• @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

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

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

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

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ı dizesi 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şkeniyle - ayarlama önerilir

  Aşağıdaki komutta değerini bağlantı dizesi ile değiştirin<Your connection string>.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Yalnızca Java yapılandırma dosyası - aracılığıyla ayarlama

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

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

  Önceki JSON değerini benzersiz bağlantı dizesi ile değiştirin<Your connection string>.

• Yalnızca Kod - ASP.NET Core, Node.js ve Python aracılığıyla ayarlama

  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 Uygulaması lication 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 bkz . Azure İzleyici Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi.

.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 bkz . Azure İzleyici Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi.

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 yetkisiz erişim yapılandırma seçeneklerini gözden geçirin.
• Azure İzleyici Java otomatik yetkisiz erişim 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 bkz . Azure İzleyici Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi.

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 İzleyici OpenTelemetry Distro 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 bkz . Azure İzleyici Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi.

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 kodu gözden geçirmek için bkz . Azure İzleyici OpenTelemetry GitHub deposu.
• npm paketini yüklemek ve güncelleştirmeleri denetlemek için npm Paketi sayfasına bakın.@azure/monitor-opentelemetry
• Azure İzleyici Application Insights 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 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 . Azure İzleyici Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi.

Python

• 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.
• Bkz. Azure İzleyici Dağıtımı örneklerinde ek örnekler ve kullanım örnekleri.
• 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 İzleyici Örnek Uygulamasında Azure İzleyici Application Insights ve OpenTelemetry hakkında daha fazla bilgi edinin.
• 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 bkz . Azure İzleyici Application Insights için OpenTelemetry yardımı, desteği ve geri bildirimi.