Örnek: Azure İzleyici ve Application Insights ile OpenTelemetry kullanma

Aralarından seçim yapabileceğiniz birçok ticari Uygulama Performansı Yönetimi (APM) sistemi vardır. Azure'da birincil uygulama izleme ürünü , Azure İzleyici'nin bir parçası olan Application Insights'tır. Tümleşik bir APM ürününün avantajlarından biri, farklı gözlemlenebilirlik veri kaynaklarıyla bağıntı oluşturabilmesidir. Application Insights zengin görünümlere ve analiz özelliklerine sahiptir.

1. Application Insights dağıtımını ekleme

Azure İzleyici ile ASP.NET deneyimini kolaylaştırmak için, OpenTelemetry'yi yapılandırma işleminin büyük bölümünü üstlendiği bir sarmalayıcı paketi (OTel ayrıştırmasında Distro olarak adlandırılır) sağlanır.

Bu örnek OTLP kılavuzunu temel alır. OTLP dışarı aktarmayı kullanarak uygulama kodunu oluşturmak için 1-5 arası adımları izleyin. Bu örnekte, Application Insights'a veri göndermek için kodu genişletirsiniz.

5. Adım'dan aynı projeyi alın ve aşağıdaki NuGet paketini ekleyin:

<ItemGroup>
  <PackageReference Include="Azure.Monitor.OpenTelemetry.AspNetCore" Version="1.3.0-beta.1" />
</ItemGroup>

Not

Sürümü kullanılabilir en son sürümle değiştirin

2. İhracatçıyı ayarlama

Önce aşağıdaki OTel başlatma kodunu builder.Build();ekleyin:

if (!string.IsNullOrEmpty(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]))
{
    otel.UseAzureMonitor();
}

UseAzureMonitor() , Application Insights için ortak enstrümantasyon kitaplıklarını ve dışa aktarıcıları ekleyen büyüdür. Kayda özel Meter ve ActivitySource adlarınızı eklemeniz yeterlidir.

Application Insights ile aynı OTel başlatma işlemi OTLP için de geçerlidir. Fark, hangi ihracatçıları seçtiğinizdir. Her ikisini de aynı uygulamada kullanabilir ve uygun ortam değişkenlerini tanımlayarak bunlar arasında seçim yapabilirsiniz.

3. bağlantı dizesi belirtin

Henüz bir Azure müşterisi değilseniz adresinden https://azure.microsoft.com/free/ücretsiz bir hesap oluşturabilirsiniz. Azure portalında oturum açın ve mevcut bir Application Insights kaynağını seçin veya ile https://ms.portal.azure.com/#create/Microsoft.AppInsightsyeni bir kaynak oluşturun.

Application Insights, portal kullanıcı arabiriminin sağ üst tarafında bulunan bir izleme anahtarı ve bağlantı dizesi aracılığıyla verileri depolamak ve işlemek için kullanılacak örneği tanımlar.

Azure Uygulaması Hizmeti kullanıyorsanız, bu bağlantı dizesi otomatik olarak uygulamaya ortam değişkeni olarak geçirilir. Diğer hizmetler için veya yerel olarak çalışırken ortam değişkenini APPLICATIONINSIGHTS_CONNECTION_STRING veya appsettings.json kullanarak geçirmeniz gerekir. Yerel olarak çalıştırmak için değeri appsettings.development.json eklemek en kolay işlemdir:

"AzureMonitor": {
    "ConnectionString": "InstrumentationKey=12345678-abcd-abcd-abcd-12345678..."
}

Not

değerini örneğinizdeki değerle değiştirin.

4. Uygulamanızı Application Insights'ta inceleme

Uygulamayı çalıştırdığınızda telemetri Application Insights'a gönderilir. Artık uygulamanız için günlükleri, ölçümleri ve dağıtılmış izlemeleri almanız gerekir. Azure portalında Application Insights kaynağını açın.

Günlükler

Ölçümler

Dağıtılmış İzleme