.NET, Node.js ve Python uygulamaları için Azure İzleyici OpenTelemetry Exporter'ı etkinleştirme (önizleme)

Makale
05/02/2022
Okumak için 16 dakika

Bu makalede OpenTelemetry tabanlı Azure İzleyici Önizleme teklifinin nasıl etkinleştirileceği ve yapılandırıldığı açıklanır. Bu makaledeki yönergeleri tamamladıktan sonra, OpenTelemetry izlemelerini Azure İzleyici Uygulaması Analizler gönderebileceksiniz. OpenTelemetry hakkında daha fazla bilgi edinmek için bkz. OpenTelemetry'ye genel bakış veya OpenTelemetry SSS.

Önemli

.NET, Node.js ve Python uygulamaları için Azure İzleyici OpenTelemetry Exporter şu anda önizleme aşamasındadır. Beta veya önizleme aşamasında olan ya da başka bir şekilde henüz genel kullanıma sunulmamış olan Azure özelliklerinde geçerli olan yasal koşullar için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Önizleme sürümünün sınırlamaları

Bu önizlemenin sizin için uygun olup olmadığını dikkatle göz önünde bulundurun. Yalnızca dağıtılmış izlemeyi etkinleştirir ve şunları dışlar:

ÖlçümLER API'si (özel ölçümler ve önceden toplanmış ölçümler gibi)
Canlı Ölçümler
Günlük API'si (konsol günlükleri ve günlük kitaplıkları gibi)
İşlenmeyen özel durumları otomatik olarak yakalama
Profil Oluşturucu
Anlık Görüntü Hata Ayıklayıcı
Çevrimdışı disk depolama ve yeniden deneme mantığı
Azure Active Directory kimlik doğrulaması
Örnekleme
Azure ortamlarında Bulut Rolü Adı ve Bulut Rolü Örneğinin otomatik doldurulmesi
Application Analizler JavaScript SDK'sını kullandığınızda Kullanıcı Kimliği ve Kimliği Doğrulanmış Kullanıcı Kimliğinin otomatik olarak doldurulma
Kullanıcı IP'sini otomatik doldurma (konum özniteliklerini belirlemek için)
İşlem Adını geçersiz kılabilme
Kullanıcı Kimliğini veya Kimliği Doğrulanmış Kullanıcı Kimliğini el ile ayarlama olanağı
İşlem Adını Bağımlılık Telemetrisine Yayma
Azure İşlevleri'de izleme kitaplıkları desteği

Tam özellik deneyimine ihtiyacınız varsa OpenTelemetry tabanlı teklif olgunlaşıncaya kadar mevcut Application Analizler ASP.NET veya ASP.NET Core SDK'sını kullanın.

Başlarken

Uygulamanızı OpenTelemetry ile izlemek için bu bölümdeki adımları izleyin.

Önkoşullar

Azure aboneliği: Ücretsiz bir Azure aboneliği oluşturma
Uygulama Analizler kaynağı: Uygulama Analizler kaynağı oluşturma

En az .NET Framework 4.6.1 olan resmi olarak desteklenen bir .NET Core veya .NET Framework sürümünü kullanan uygulama

İstemci kitaplıklarını yükleme

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

dotnet add package --prerelease Azure.Monitor.OpenTelemetry.Exporter

"Azure.Monitor.OpenTelemetry.Exporter paketi için kullanılabilir sürüm yok" gibi bir hata alırsanız, bunun nedeni büyük olasılıkla NuGet paket kaynaklarının ayarının eksik olmasıdır. Şu seçenekle kaynağı belirtmeyi -s deneyin:

# Install the latest package with the NuGet package source specified.
dotnet add package --prerelease Azure.Monitor.OpenTelemetry.Exporter -s https://api.nuget.org/v3/index.json

Şu paketleri yükleyin:

npm install @opentelemetry/sdk-trace-base
npm install @opentelemetry/sdk-trace-node
npm install @azure/monitor-opentelemetry-exporter

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

npm install @opentelemetry/api
npm install @opentelemetry/resources
npm install @opentelemetry/semantic-conventions
npm install @opentelemetry/instrumentation-http

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

pip install azure-monitor-opentelemetry-exporter

Azure İzleyici Uygulama Analizler etkinleştirme

Bu bölümde OpenTelemetry'nin nasıl etkinleştirileceğine dair yönergeler sağlanır.

OpenTelemetry izleme kodu ekleme

Aşağıdaki kod, OpenTelemetry TracerProvider'ı ayarlayarak bir C# konsol uygulamasında OpenTelemetry'yi etkinleştirmeyi gösterir. Bu kod, uygulama başlangıcında olmalıdır. ASP.NET Core için genellikle uygulama Startup sınıfının yönteminde ConfigureServices yapılır. ASP.NET uygulamalar için genellikle içinde Global.asax.csyapılır.

using System.Diagnostics;
using Azure.Monitor.OpenTelemetry.Exporter;
using OpenTelemetry;
using OpenTelemetry.Trace;

public class Program
{
    private static readonly ActivitySource MyActivitySource = new ActivitySource(
        "OTel.AzureMonitor.Demo");

    public static void Main()
    {
        using var tracerProvider = Sdk.CreateTracerProviderBuilder()
            .AddSource("OTel.AzureMonitor.Demo")
            .AddAzureMonitorTraceExporter(o =>
            {
                o.ConnectionString = "<Your Connection String>";
            })
            .Build();

        using (var activity = MyActivitySource.StartActivity("TestActivity"))
        {
            activity?.SetTag("CustomTag1", "Value1");
            activity?.SetTag("CustomTag2", "Value2");
        }

        System.Console.WriteLine("Press Enter key to exit.");
        System.Console.ReadLine();
    }
}

Not

Activity Ad alanından ve ActivitySource sınıfları System.Diagnostics sırasıyla ve Tracer'nin Span OpenTelemetry kavramlarını temsil ediyor. kullanarak yerine TracerProvideroluşturucusunu kullanarak doğrudan oluşturursunuzActivitySource. Her ActivitySource sınıf kullanılarak AddSource()açıkça bağlanmalıdırTracerProvider. Bunun nedeni OpenTelemetry izleme API'sinin bölümlerinin doğrudan .NET çalışma zamanına dahil edilmiş olmasıdır. Daha fazla bilgi edinmek için bkz. OpenTelemetry .NET İzleme API'sine Giriş.

Aşağıdaki kod, basit bir Node.js uygulamasında OpenTelemetry'nin nasıl etkinleştirileceği gösterilmektedir:

const { AzureMonitorTraceExporter } = require("@azure/monitor-opentelemetry-exporter");
const { BatchSpanProcessor, Span } = require("@opentelemetry/sdk-trace-base");
const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");

const provider = new NodeTracerProvider();
provider.register();

// Create an exporter instance.
const exporter = new AzureMonitorTraceExporter({
  instrumentationKey: "<Your Connection String>"
});

// Add the exporter to the provider.
provider.addSpanProcessor(
  new BatchSpanProcessor(exporter, {
    bufferTimeout: 15000,
    bufferSize: 1000
  })
);
// Create a span. A span must be closed.
const parentSpan = tracer.startSpan("main");
for (let i = 0; i < 10; i += 1) {
   doWork(parentSpan);
}
// Be sure to end the span.
parentSpan.end();

function doWork(parent: Span) {
  // Start another span. In this example, the main method already started a
  // span, so that will be the parent span, and this will be a child span.
  const ctx = opentelemetry.trace.setSpan(opentelemetry.context.active(), parent);
  const span = tracer.startSpan("doWork", undefined, ctx);
  // Simulate some random work.
  for (let i = 0; i <= Math.floor(Math.random() * 40000000); i += 1) {
    // empty
  }
  // Set attributes to the span.
  span.setAttribute("key", "value");
  // Annotate our span to capture metadata about our operation.
  span.addEvent("invoking doWork");
  span.end();
}

Aşağıdaki kodda, basit bir Python uygulamasında OpenTelemetry'nin nasıl etkinleştirileceği gösterilmektedir:

import os
from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor

from azure.monitor.opentelemetry.exporter import AzureMonitorTraceExporter

exporter = AzureMonitorTraceExporter.from_connection_string(
    "<Your Connection String>"
)

trace.set_tracer_provider(TracerProvider())
tracer = trace.get_tracer(__name__)
span_processor = BatchSpanProcessor(exporter)
trace.get_tracer_provider().add_span_processor(span_processor)

with tracer.start_as_current_span("hello"):
    print("Hello, World!")

İpucu

Popüler çerçeveler ve kitaplıklar arasında telemetri verilerini otomatik olarak toplamaya yönelik izleme kitaplıkları ekleyin.

Uygulama Analizler bağlantı dizesini ayarlama

Önceki koddaki yer tutucuyu <Your Connection String> Application Analizler kaynağınızdaki bağlantı dizesiyle değiştirin.

Screenshot of the Application Insights connection string.

Verilerin aktığını onaylayın

Uygulamanızı çalıştırın ve Azure portal Uygulama Analizler Kaynağı sekmesini açın. Verilerin portalda görünmesi birkaç dakika sürebilir.

Not

Uygulamayı çalıştıramıyorsanız veya beklendiği gibi veri almıyorsanız bkz . Sorun giderme.

Screenshot of the Application Insights Overview tab with server requests and server response time highlighted.

Önemli

Aynı Uygulama Analizler 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 Analizler izlemesini kullanmanın bir parçası olarak tanılama verilerini toplar ve Microsoft'a göndeririz. Bu veriler, Uygulama Analizler çalıştırmamıza ve geliştirmemize yardımcı olur. Gereksiz veri toplamayı devre dışı bırakma seçeneğiniz vardır. Daha fazla bilgi edinmek için bkz. Azure Uygulaması Analizler'da statsbeat.

Bulut Rolü Adını ve Bulut Rolü Örneğini Ayarlama

Kaynak öznitelikleri aracılığıyla Bulut Rolü Adı'nı ve Bulut Rolü Örneğini ayarlayabilirsiniz. Bu adım, Bulut Rolü Adı ve Bulut Rolü Örneğini varsayılan değerlerinden ekibiniz için anlamlı bir değere güncelleştirir. Bunlar Uygulama Haritası'nda bir düğümün altında ad olarak görünür. Bulut Rolü Adı, ve özniteliklerini kullanır service.namespaceservice.name, ancak ayarlı değilse service.namespace değerine geri dönerservice.name. Bulut Rolü Örneği öznitelik değerini kullanır service.instance.id .

// Setting role name and role instance
var resourceAttributes = new Dictionary<string, object> {
    { "service.name", "my-service" },
    { "service.namespace", "my-namespace" },
    { "service.instance.id", "my-instance" }};
var resourceBuilder = ResourceBuilder.CreateDefault().AddAttributes(resourceAttributes);
// Done setting role name and role instance

// Set ResourceBuilder on the provider.
using var tracerProvider = Sdk.CreateTracerProviderBuilder()
        .SetResourceBuilder(resourceBuilder)
        .AddSource("OTel.AzureMonitor.Demo")
        .AddAzureMonitorTraceExporter(o =>
        {
            o.ConnectionString = "<Your Connection String>";
        })
        .Build();

...
import { NodeTracerProvider, NodeTracerConfig } from "@opentelemetry/sdk-trace-node";
import { Resource } from "@opentelemetry/resources";
import { SemanticResourceAttributes } from "@opentelemetry/semantic-conventions";

// ----------------------------------------
// Setting role name and role instance
// ----------------------------------------
const config: NodeTracerConfig = {
        resource: new Resource({
            [SemanticResourceAttributes.SERVICE_NAME]: "my-helloworld-service",
            [SemanticResourceAttributes.SERVICE_NAMESPACE]: "my-namespace",
            [SemanticResourceAttributes.SERVICE_INSTANCE_ID]: "my-instance",
        }),
    };
// ----------------------------------------
// Done setting role name and role instance
// ----------------------------------------
const provider = new NodeTracerProvider(config);
...

...
from opentelemetry.sdk.resources import SERVICE_NAME, SERVICE_NAMESPACE, SERVICE_INSTANCE_ID, Resource
trace.set_tracer_provider(
    TracerProvider(
        resource=Resource.create(
            {
                SERVICE_NAME: "my-helloworld-service",
# ----------------------------------------
# Setting role name and role instance
# ----------------------------------------
                SERVICE_NAMESPACE: "my-namespace",
                SERVICE_INSTANCE_ID: "my-instance",
# ----------------------------------------------
# Done setting role name and role instance
# ----------------------------------------------
            }
        )
    )
)
...

Kaynakların standart öznitelikleri hakkında bilgi için bkz. Kaynak Anlam Kuralları.

Örnekleme

Örnekleme OpenTelemetry'de desteklenir, ancak şu anda Azure İzleyici OpenTelemetry Exporter'da desteklenmez.

Uyarı

OpenTelemetry'de örneklemenin etkinleştirilmesi standart ve günlük tabanlı ölçümleri son derece yanlış hale getirir ve bu da tüm Uygulama Analizler deneyimlerini olumsuz etkiler. Ayrıca, mevcut Uygulama Analizler SDK'ları ile birlikte örneklemenin etkinleştirilmesi, bozuk izlemelere neden olur.

İzleme kitaplıkları

Aşağıdaki kitaplıklar önizleme sürümüyle çalışacak şekilde doğrulanmıştır.

Uyarı

İzleme kitaplıkları deneysel OpenTelemetry belirtimlerini temel alır. Microsoft'un önizleme desteği taahhüdü, aşağıdaki kitaplıkların Verileri Azure İzleyici Uygulaması Analizler yaymasını sağlamaktır, ancak hataya neden olan değişikliklerin veya deneysel eşlemenin bazı veri öğelerini engellemesi mümkündür.

HTTP

Veritabanı

SQL istemci sürümü: 1.0.0-rc7

Not

Önizleme teklifi yalnızca HTTP ve veritabanı isteklerini işleyen izlemeleri içerir. Daha fazla bilgi edinmek için bkz. OpenTelemetry Semantic Conventions.

Telemetriyi değiştirme

Bu bölümde telemetrinin nasıl değiştirileceği açıklanmaktadır.

Span öznitelikleri ekleme

Span öznitelikleri eklemek için aşağıdaki iki yoldan birini kullanın:

İzleme kitaplıkları tarafından sağlanan seçenekleri kullanın.
Özel bir span işlemcisi ekleyin.

Bu öznitelikler telemetrinize özel özellik eklemeyi içerebilir. Uygulama Analizler şemasında İstemci IP'leri gibi isteğe bağlı alanlar ayarlamak için öznitelikleri de kullanabilirsiniz.

İpucu

İzleme kitaplıkları tarafından sağlanan seçenekleri kullanmanın avantajı, kullanılabilir olduğunda bağlamın tamamının kullanılabilir olmasıdır. Sonuç olarak, kullanıcılar daha fazla öznitelik eklemeyi veya filtrelemeyi seçebilir. Örneğin, HttpClient izleme kitaplığındaki zenginleştirme seçeneği, kullanıcılara httpRequestMessage'ın kendisine erişim verir. Öğeden herhangi bir şey seçebilir ve bir öznitelik olarak depolayabilirler.

Özel özellik ekleme

Spans'a eklediğiniz tüm öznitelikler özel özellikler olarak dışarı aktarılır. İsteklerdeki customDimensions alanını veya Application Analizler'daki bağımlılıklar tablolarını doldurur.

Birçok izleme kitaplığı zenginleştirme seçeneği sunar. Yönergeler için tek tek izleme kitaplıklarının benioku dosyalarına bakın:
Özel işlemci kullanın:

İpucu

Burada gösterilen işlemciyi Azure İzleyici Dışarı Vereni'nin önüne ekleyin.

using var tracerProvider = Sdk.CreateTracerProviderBuilder()
        .AddSource("OTel.AzureMonitor.Demo")
        .AddProcessor(new ActivityEnrichingProcessor())
        .AddAzureMonitorTraceExporter(o =>
        {
                o.ConnectionString = "<Your Connection String>"
        })
        .Build();

Aşağıdaki kodla projenize ekleyin ActivityEnrichingProcessor.cs :

using System.Diagnostics;
using OpenTelemetry;
using OpenTelemetry.Trace;

public class ActivityEnrichingProcessor : BaseProcessor<Activity>
{
    public override void OnEnd(Activity activity)
    {
        // The updated activity will be available to all processors which are called after this processor.
        activity.DisplayName = "Updated-" + activity.DisplayName;
        activity.SetTag("CustomDimension1", "Value1");
        activity.SetTag("CustomDimension2", "Value2");
    }
}

Özel işlemci kullanın:

İpucu

Burada gösterilen işlemciyi Azure İzleyici DışarıYılıcısı'nın önüne ekleyin.

import { AzureMonitorTraceExporter } from "@azure/monitor-opentelemetry-exporter";
import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import { ReadableSpan, SimpleSpanProcessor, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";

class SpanEnrichingProcessor implements SpanProcessor{
    forceFlush(): Promise<void>{
        return Promise.resolve();
    }
    shutdown(): Promise<void>{
        return Promise.resolve();
    }
    onStart(_span: Span): void{}
    onEnd(span: ReadableSpan){
        span.attributes["CustomDimension1"] = "value1";
        span.attributes["CustomDimension2"] = "value2";
    }
}

const provider = new NodeTracerProvider();
const azureExporter = new AzureMonitorTraceExporter();
provider.addSpanProcessor(new SpanEnrichingProcessor());
provider.addSpanProcessor(new SimpleSpanProcessor(azureExporter));

Özel işlemci kullanın:

İpucu

Burada gösterilen işlemciyi Azure İzleyici DışarıYılıcısı'nın önüne ekleyin.

...
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor

trace.set_tracer_provider(TracerProvider())
span_processor = BatchSpanProcessor(exporter)
span_enrich_processor = SpanEnrichingProcessor()
trace.get_tracer_provider().add_span_processor(span_enrich_processor)
trace.get_tracer_provider().add_span_processor(span_processor)
...

Aşağıdaki kodla projenize ekleyin SpanEnrichingProcessor.py :

from opentelemetry.sdk.trace import SpanProcessor

class SpanEnrichingProcessor(SpanProcessor):

    def on_end(self, span):
        span._name = "Updated-" + span.name
        span._attributes["CustomDimension1"] = "Value1"
        span._attributes["CustomDimension2"] = "Value2"

Kullanıcı IP'sini ayarlama

özniteliğini span üzerinde ayarlayarak http.client_ip istekler için client_IP alanını doldurabilirsiniz. Uygulama Analizler kullanıcı konumu özniteliklerini oluşturmak için IP adresini kullanır ve varsayılan olarak atar.

Özel özellik ekleme örneğini kullanın, ancak içindeki ActivityEnrichingProcessor.csaşağıdaki kod satırlarını değiştirin:

// only applicable in case of activity.Kind == Server
activity.SetTag("http.client_ip", "<IP Address>");

Özel özellik ekleme örneğini kullanın, ancak aşağıdaki kod satırlarını değiştirin:

...
import { SemanticAttributes } from "@opentelemetry/semantic-conventions";

class SpanEnrichingProcessor implements SpanProcessor{
    ...

    onEnd(span: ReadableSpan){
        span.attributes[SemanticAttributes.HTTP_CLIENT_IP] = "<IP Address>";
    }
}

Özel özellik ekleme örneğini kullanın, ancak içindeki SpanEnrichingProcessor.pyaşağıdaki kod satırlarını değiştirin:

span._attributes["http.client_ip"] = "<IP Address>"

Telemetri filtreleme

Telemetriyi uygulamanızdan çıkmadan önce filtrelemek için aşağıdaki yöntemleri kullanabilirsiniz.

Birçok izleme kitaplığı bir filtre seçeneği sağlar. Yönergeler için tek tek izleme kitaplıklarının benioku dosyalarına bakın:

Özel işlemci kullanın:

using var tracerProvider = Sdk.CreateTracerProviderBuilder()
        .AddSource("OTel.AzureMonitor.Demo")
        .AddProcessor(new ActivityFilteringProcessor())
        .AddAzureMonitorTraceExporter(o =>
        {
                o.ConnectionString = "<Your Connection String>"
        })
        .Build();

Aşağıdaki kodla projenize ekleyin ActivityFilteringProcessor.cs :

using System.Diagnostics;
using OpenTelemetry;
using OpenTelemetry.Trace;

public class ActivityFilteringProcessor : BaseProcessor<Activity>
{
    public override void OnStart(Activity activity)
    {
        // prevents all exporters from exporting internal activities
        if (activity.Kind == ActivityKind.Internal)
        {
            activity.IsAllDataRequested = false;
        }
    }
}

Belirli bir kaynak kullanılarak AddSource("ActivitySourceName")açıkça eklenmezse, bu kaynak kullanılarak oluşturulan etkinliklerin hiçbiri dışarı aktarılamaz.

Birçok HTTP izleme kitaplığı tarafından sağlanan URL seçeneğini hariç tutun.

Aşağıdaki örnekte, BELIRLI bir URL'nin HTTP/HTTPS izleme kitaplığı kullanılarak izlenmesini nasıl hariç tutulduğu gösterilmektedir:

...
import { HttpInstrumentation, HttpInstrumentationConfig } from "@opentelemetry/instrumentation-http";

...
const httpInstrumentationConfig: HttpInstrumentationConfig = {
    ignoreIncomingPaths: [new RegExp(/dc.services.visualstudio.com/i)]
};
const httpInstrumentation = new HttpInstrumentation(httpInstrumentationConfig);
provider.register();
registerInstrumentations({
    instrumentations: [
        httpInstrumentation,
    ]
});

Özel işlemci kullanın. Belirli aralıkların dışarı aktarılmasını dışlamak için özel bir span işlemcisi kullanabilirsiniz. Yayılmaları dışarı aktarılmayacak şekilde işaretlemek için olarak ayarlayın TraceFlagDEFAULT. Özel özellik ekleme örneğini kullanın, ancak aşağıdaki kod satırlarını değiştirin:
```
...
import { SpanKind, TraceFlags } from "@opentelemetry/api";

class SpanEnrichingProcessor implements SpanProcessor{
    ...

    onEnd(span: ReadableSpan) {
        if(span.kind == SpanKind.INTERNAL){
            span.spanContext().traceFlags = TraceFlags.NONE;
        }
    }
}
```

Birçok HTTP izleme kitaplığı tarafından sağlanan URL seçeneğini hariç tutun.

Aşağıdaki örnekte Flask izlemesi kullanılarak belirli bir URL'nin izlenmesini nasıl hariç tutulduğu gösterilmektedir:

...
import flask

from opentelemetry.instrumentation.flask import FlaskInstrumentor

# You might also populate OTEL_PYTHON_FLASK_EXCLUDED_URLS env variable
# List will consist of comma delimited regexes representing which URLs to exclude
excluded_urls = "client/.*/info,healthcheck"

FlaskInstrumentor().instrument(excluded_urls=excluded_urls) # Do this before flask.Flask
app = flask.Flask(__name__)
...

Özel işlemci kullanın. Belirli aralıkların dışarı aktarılmasını dışlamak için özel bir span işlemcisi kullanabilirsiniz. Yayılmaları dışarı aktarılmayacak şekilde işaretlemek için olarak ayarlayın TraceFlagDEFAULT.

...
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor

trace.set_tracer_provider(TracerProvider())
span_processor = BatchSpanProcessor(exporter)
span_filter_processor = SpanFilteringProcessor()
trace.get_tracer_provider().add_span_processor(span_filter_processor)
trace.get_tracer_provider().add_span_processor(span_processor)
...

Aşağıdaki kodla projenize ekleyin SpanFilteringProcessor.py :

from opentelemetry.trace import SpanContext, SpanKind, TraceFlags
from opentelemetry.sdk.trace import SpanProcessor

class SpanFilteringProcessor(SpanProcessor):

    # prevents exporting spans from internal activities
    def on_start(self, span):
        if span._kind is SpanKind.INTERNAL:
            span._context = SpanContext(
                span.context.trace_id,
                span.context.span_id,
                span.context.is_remote,
                TraceFlags.DEFAULT,
                span.context.trace_state,
            )

OTLP DışarıYırıcısını Etkinleştirme

Telemetrinizi iki konuma göndermek için Azure İzleyici Exporter ile birlikte OpenTelemetry Protocol (OTLP) Exporter'ı etkinleştirmek isteyebilirsiniz.

Not

OTLP İhracatçısı yalnızca kolaylık sağlamak için gösterilir. OTLP İhracatçısı'nı veya herhangi bir bileşeni ya da üçüncü taraf deneyimleri aşağı akışını resmi olarak desteklemiyoruz. Azure desteği sınırı dışındaki OpenTelemetry için OpenTelemetry-Collector sorunlarıyla ilgili bir sorun açmanızı öneririz.

OpenTelemetry.Exporter.OpenTelemetryProtocol paketini ve Azure.Monitor.OpenTelemetry.Exporter'ı projenize yükleyin.

Aşağıdaki kod parçacığını ekleyin. Bu örnekte, OTLP alıcısı çalışan bir OpenTelemetry Toplayıcınız olduğu varsayılır. Ayrıntılar için GitHub örneğine bakın.

// Sends data to Application Insights as well as OTLP
using var tracerProvider = Sdk.CreateTracerProviderBuilder()
        .AddSource("OTel.AzureMonitor.Demo")
        .AddAzureMonitorTraceExporter(o =>
        {
            o.ConnectionString = "<Your Connection String>"
        })
        .AddOtlpExporter()
        .Build();

Projenize Azure İzleyici OpenTelemetry Exporter ile birlikte OpenTelemetry Collector Exporter paketini yükleyin.
```
    npm install @opentelemetry/exporter-otlp-http
    npm install @azure/monitor-opentelemetry-exporter
```

Aşağıdaki kod parçacığını ekleyin. Bu örnekte, OTLP alıcısı çalışan bir OpenTelemetry Toplayıcınız olduğu varsayılır. Ayrıntılar için GitHub örneğine bakın.

const { BasicTracerProvider, SimpleSpanProcessor } = require('@opentelemetry/sdk-trace-base');
const { OTLPTraceExporter } = require('@opentelemetry/exporter-otlp-http');

const provider = new BasicTracerProvider();
const azureMonitorExporter = new AzureMonitorTraceExporter({
  instrumentationKey: os.environ["APPLICATIONINSIGHTS_CONNECTION_STRING"]
});
const otlpExporter = new OTLPTraceExporter();
provider.addSpanProcessor(new SimpleSpanProcessor(azureMonitorExporter));
provider.addSpanProcessor(new SimpleSpanProcessor(otlpExporter));
provider.register();

azure-monitor-opentelemetry-exporter ve opentelemetry-exporter-otlp paketlerini yükleyin.

Aşağıdaki kod parçacığını ekleyin. Bu örnekte, OTLP alıcısı çalışan bir OpenTelemetry Toplayıcınız olduğu varsayılır. Ayrıntılar için bu BENİOKU'ya bakın.

from opentelemetry import trace 

from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor

from azure.monitor.opentelemetry.exporter import AzureMonitorTraceExporter

trace.set_tracer_provider(TracerProvider())
tracer = trace.get_tracer(__name__) 

exporter = AzureMonitorTraceExporter.from_connection_string(
    "<Your Connection String>"
)
otlp_exporter = OTLPSpanExporter(endpoint="http://localhost:4317")
span_processor = BatchSpanProcessor(otlp_exporter) 
trace.get_tracer_provider().add_span_processor(span_processor)

with tracer.start_as_current_span("test"):
    print("Hello world!")

Sorun giderme

Bu bölümde sorun giderme konusunda yardım sağlanır.

Tanılama günlüğünü etkinleştirme

Azure İzleyici DışarıYılıcısı kendi iç günlüğü için EventSource kullanır. Dışarı aktarıcı günlükleri, OpenTelemetry-AzureMonitor-Exporter adlı kaynağı kabul ederek herhangi bir EventListener tarafından kullanılabilir. Sorun giderme adımları için bkz. OpenTelemetry Sorun Giderme.

Azure İzleyici Dışarı Aktarma, iç günlükler için OpenTelemetry API Günlükçüsünü kullanır. Etkinleştirmek için aşağıdaki kodu kullanın:

const { diag, DiagConsoleLogger, DiagLogLevel } = require("@opentelemetry/api");
const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");

const provider = new NodeTracerProvider();
diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ALL);
provider.register();

Azure İzleyici Dışarı Aktarıcısı kendi iç günlüğü için Python standart günlük kitaplığını kullanır. OpenTelemetry API ve Azure İzleyici Dışarı Aktarma günlükleri genellikle düzensiz etkinlikler için UYARI veya HATA önem düzeyinde günlüğe kaydedilir. BİlGİ önem düzeyi, normal veya başarılı etkinlik için kullanılır. Varsayılan olarak, Python günlük kitaplığı önem düzeyini UYARI olarak ayarlar, bu nedenle bu önem derecesi ayarı altında günlükleri görmek için önem düzeyini değiştirmeniz gerekir. Aşağıdaki örnekte , tüm önem derecelerindeki günlüklerin konsola ve bir dosyaya nasıl çıkışının yapılacağını gösterilmektedir:

...
import logging

logging.basicConfig(format="%(asctime)s:%(levelname)s:%(message)s", level=logging.DEBUG)

logger = logging.getLogger(__name__)
file = logging.FileHandler("example.log")
stream = logging.StreamHandler()
logger.addHandler(file)
logger.addHandler(stream)
...

Bilinen sorunlar

Azure İzleyici OpenTelemetry Exporters ile ilgili bilinen sorunlar şunlardır:

Bağımlılık telemetrisinde işlem adı eksik, bu da hataları ve performans sekmesi deneyimini olumsuz etkiler.
İstekte ve bağımlılık telemetrisinde cihaz modeli eksiktir ve bu durum cihaz kohort analizini olumsuz etkiler.
Veritabanı sunucu adı bağımlılık adından çıkarılır ve bu da farklı sunucularda aynı ada sahip tabloları yanlış bir şekilde toplar.

Destek

Destek almak için:

Bu makaledeki sorun giderme adımlarını gözden geçirin.
Azure desteği sorunlar için bir Azure desteği bileti açın.

OpenTelemetry sorunları için doğrudan OpenTelemetry .NET topluluğuna başvurun.

OpenTelemetry geri bildirimi

Geri bildirim sağlamak için:

OpenTelemetry topluluğunun müşteri geri bildirim anketini doldurun.
OpenTelemetry Early Adopter Community katılarak Microsoft'a kendinizi anlatın.
Microsoft Tech Community'nde diğer Azure İzleyici kullanıcılarıyla etkileşime geçin.
Azure Geri Bildirim Forumu'nda bir özellik isteği gönderin.

Sonraki adımlar

Kaynak kodu gözden geçirmek için bkz. Azure İzleyici Dışarı Aktarma GitHub deposu.
NuGet paketini yüklemek, güncelleştirmeleri denetlemek veya sürüm notlarını görüntülemek için Azure İzleyici Dışarı Aktarma NuGet Paketi sayfasına bakın.
Azure İzleyici Uygulaması Analizler 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.

.NET, Node.js ve Python uygulamaları için Azure İzleyici OpenTelemetry Exporter'ı etkinleştirme (önizleme)

Bu sayfayı yararlı buluyor musunuz?

Önizleme sürümünün sınırlamaları

Başlarken

Önkoşullar

İstemci kitaplıklarını yükleme

Azure İzleyici Uygulama Analizler etkinleştirme

OpenTelemetry izleme kodu ekleme

Uygulama Analizler bağlantı dizesini ayarlama

Verilerin aktığını onaylayın

Bulut Rolü Adını ve Bulut Rolü Örneğini Ayarlama

Örnekleme

İzleme kitaplıkları

HTTP

Veritabanı

Telemetriyi değiştirme

Span öznitelikleri ekleme

Özel özellik ekleme

Kullanıcı IP'sini ayarlama

Telemetri filtreleme

OTLP DışarıYırıcısını Etkinleştirme

Sorun giderme

Tanılama günlüğünü etkinleştirme

Bilinen sorunlar

Destek

OpenTelemetry geri bildirimi

Sonraki adımlar