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

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

• OpenTelemetry dağıtımı sağlar ve Azure İzleyici ö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 telemetri telemetrisini 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.

OpenTelemetry Distro Azure İzleyici kullanmanın avantajları hakkında daha fazla bilgi için bkz. Azure İzleyici 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 İşlevleri 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

• >.NET veya .NET Framework 4.6.2 ve sonraki sürümlerin 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 native

• GraalVM 17+ kullanan bir Java uygulaması

Node.js

• Resmi olarak desteklenen bir Node.js çalışma zamanı sürümünü kullanan uygulama:
  • OpenTelemetry tarafından desteklenen çalışma zamanları
  • Azure İzleyici 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.

Bu özelliklerden herhangi birine güveniyorsanız, Azure İzleyici OpenTelemetry Distro ile devam edin.

İpucu

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

Python

• Python 3.8+ kullanarak yazılmış 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 İzleyici 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 İzleyici Exporter 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 için başlangıç kılavuzu'na 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. Spring Boot ile Azure İzleyici Application Insights kullanımı.

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.

Uygulama İçgörüleriniz kaynağından bağlantı dizesini kopyalayın

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ı dizesinizi bulun.
3. Bağlantı dizesi üzerine gelin ve Panoya kopyala ikonunu seçin.

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

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 komuttaki <Your bağlantı dizesi> yerine bağlantı dizesi yazın.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Yapılandırma dosyası aracılığıyla ayarlayın - 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 bağlantı dizesi> değerini your benzersiz bağlantı dizesi ile değiştirin.

• Kod ile ayarla - Sadece ASP.NET Core, Node.js ve Python

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

Not

bağlantı dizesi 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.

Not

Application Insights instrumentasyonunu kullanmanın bir parçası olarak tanılama verilerini toplayıp 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.

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

Sorun giderme, geri bildirim ve destek

İpucu

Aşağıdaki bölümler tüm OpenTelemetry Distro makalelerinde kullanılabilir.

Sorun giderme

ASP.NET Core

Sorun giderme bilgileri için bkz. .NET'te OpenTelemetry sorunlarını giderme ve Azure İzleyici Application Insights'ta eksik uygulama telemetrisini giderme.

.NET

Sorun giderme bilgileri için bkz. .NET'te OpenTelemetry sorunlarını giderme ve Azure İzleyici Application Insights'ta eksik uygulama telemetrisini giderme.

Java

Sorun giderme bilgileri için bkz. Java'da OpenTelemetry sorunlarını giderme ve Azure İzleyici Application Insights'da eksik uygulama telemetrisini giderme.

Java native

Sorun giderme bilgileri için bkz. Spring Boot yerel imaj uygulamalarında OpenTelemetry sorunlarını giderme ve Azure İzleyici Application Insights içinde eksik uygulama telemetrisini giderme.

Node.js

Sorun giderme bilgileri için bakınız: Node.js'de OpenTelemetry sorunlarını giderme ve Azure İzleyici Application Insights'ta eksik uygulama telemetrisini giderme.

Python

Sorun giderme bilgileri için bkz. Python'da OpenTelemetry sorunlarını giderme ve Azure İzleyici Application Insights'te eksik uygulama telemetrisini giderme.

OpenTelemetry Geri Bildirimi

Geri bildirim sağlamak için:

• OpenTelemetry topluluğunun müşteri geri bildirim anketini doldurun.
• OpenTelemetry Early Adopter Community'na katılarak kendiniz hakkında Microsoft'a bilgi verin.
• Microsoft Tech Community içindeki diğer Azure İzleyici kullanıcılarıyla etkileşime geçin.
• Azure Geri Bildirim Forumu'nda özellik isteğinde bulunabilirsiniz.

Support

Destek seçeneklerini keşfetmek için istediğiniz dil için bir sekme seçin.

ASP.NET Core

• Azure destek sorunları için bir Azure destek talebi açın.
• OpenTelemetry sorunları için doğrudan OpenTelemetry .NET topluluğuna başvurun.
• Azure İzleyici İhracatçısı ile ilgili açık konuların listesi için GitHub Sorunları Sayfasına bakın.

.NET

• Azure destek sorunları için bir Azure destek talebi açın.
• OpenTelemetry sorunları için doğrudan OpenTelemetry .NET topluluğuna başvurun.
• Azure İzleyici İhracatçısı ile ilgili açık konuların listesi için GitHub Sorunları Sayfasına bakın.

Java

• Azure destek sorunları için bir Azure destek talebi açın.
• Sorun giderme konusunda yardım için sorun giderme adımlarını gözden geçirin.
• OpenTelemetry sorunları için doğrudan OpenTelemetry topluluğuna başvurun.
• Azure İzleyici Java Otomatik Enstrümantasyon ile ilgili açık sorunların listesi için GitHub Sorunlar Sayfası'na bakın.

Java native

• Azure destek sorunları için bir Azure destek talebi açın.
• OpenTelemetry sorunları için doğrudan OpenTelemetry topluluğuna başvurun.
• Spring Boot yerel uygulamalarıyla ilgili açık sorunların listesi için bkz. GitHub Sorunlar Sayfası.
• Quarkus yerel uygulamalarıyla ilgili açık sorunların listesi için bkz. GitHub Sorunlar Sayfası.

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 destek sorunları için bir Azure destek talebi açın.
• OpenTelemetry sorunları için doğrudan OpenTelemetry JavaScript topluluğuna başvurun.
• Azure İzleyici İhracatçısı ile ilgili açık konuların listesi için GitHub Sorunları Sayfasına bakın.

Python

• Azure destek sorunları için bir Azure destek talebi açın.
• OpenTelemetry sorunları için doğrudan OpenTelemetry Python topluluğuna başvurun.
• Azure İzleyici Dağıtımı ile ilgili açık sorunların listesi için bkz. GitHub Sorunlar Sayfası.

Sonraki adımlar

ASP.NET Core

• Kaynak kodu gözden geçirmek için bkz. Azure İzleyici ASP.NET Core GitHub deposu.
• Örnek bir uygulamayı gözden geçirmek için bkz. Azure İzleyici OpenTelemetry for ASP.NET Core.
• NuGet paketini yüklemek, güncelleştirmeleri denetlemek veya sürüm notlarını görüntülemek için Azure İzleyici AspNetCore NuGet Package sayfasına bakın.
• 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.

.NET

• Kaynak kodu gözden geçirmek için bkz. Azure İzleyici Exporter GitHub deposu.
• Örnek uygulamayı gözden geçirmek için bkz: Azure İzleyici için OpenTelemetry .NET.
• NuGet paketini yüklemek, güncelleştirmeleri denetlemek veya sürüm notlarını görüntülemek için Azure İzleyici Exporter NuGet Package sayfasına bakın.
• 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.

Java

• Yapılandırma seçeneklerini gözden geçirmek için bkz. Java otomatik araç yapılandırma seçenekleri.
• Kaynak kodu gözden geçirmek için bkz. Azure İzleyici Java autoinstrumentation GitHub deposu.
• Örnek uygulamaları gözden geçirmek için bkz. Application Insights Java Samples.
• GitHub’da release notes’i gözden geçirin.
• OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinmek için OpenTelemetry Java GitHub deposunu gözden geçirin.
• Kullanım deneyimlerini etkinleştirmek için Web veya tarayıcı kullanıcı izlemeyi etkinleştirme bölümünü gözden geçirin.

Java native

• Kaynak kodu gözden geçirmek için bkz. Azure İzleyici OpenTelemetry Distro in Spring Boot native image Java application and Quarkus OpenTelemetry Exporter for Azure.
• Örnek bir uygulamayı gözden geçirmek için GraalVM yerel görüntüleri için Telemetry bölümüne bakın.
• GitHub’da release notes’i gözden geçirin.
• 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.
• OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinmek için OpenTelemetry Java GitHub deposunu gözden geçirin.

Node.js

• Kaynak kodu gözden geçirmek için Azure İzleyici OpenTelemetry for JavaScript deposuna bakın.
• Örnek uygulamayı gözden geçirmek için bkz.: Node.js için Azure İzleyici OpenTelemetry.
• npm paketini yüklemek ve güncelleştirmeleri denetlemek için npm Paketi sayfasına bakın@azure/monitor-opentelemetry.
• 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.

Python

• Kaynak kodu ve ek belgeleri gözden geçirmek için Azure İzleyici Python GitHub deposuna bakın.
• Örnek uygulamaları gözden geçirmek için Azure İzleyici OpenTelemetry for Python bağlantısına bakın.
• PyPI paketini yüklemek ve güncelleştirmeleri denetlemek için Azure İzleyici Distro PyPI Paketi sayfasına bakın.
• GitHub’da release notes’i gözden geçirin.
• Kullanılabilir OpenTelemetry araçlarını ve bileşenlerini gözden geçirmek amacıyla bakınız OpenTelemetry Contributor Python GitHub deposu.
• OpenTelemetry ve topluluğu hakkında daha fazla bilgi edinmek için OpenTelemetry Python GitHub deposunu gözden geçirin.
• Kullanım deneyimlerini etkinleştirmek için web veya tarayıcı kullanıcı izlemeyi etkinleştirin.