تمكين Azure Monitor OpenTelemetry Exporter لتطبيقات .NET و Node.js و Python (معاينة)

مقالة
05/02/2022
قراءة خلال 17 دقائق

توضح هذه المقالة كيفية تمكين وتكوين عرض معاينة Azure Monitor المستند إلى OpenTelemetry. بعد الانتهاء من الإرشادات الواردة في هذه المقالة، ستتمكن من إرسال آثار OpenTelemetry إلى تطبيق Azure Monitor Insights. لمعرفة المزيد حول OpenTelemetry، راجع نظرة عامة على OpenTelemetry أو الأسئلة المتداولة حول OpenTelemetry.

هام

Azure Monitor OpenTelemetry Exporter لتطبيقات .NET و Node.js و Python قيد المعاينة حاليا. للحصول على الشروط القانونية التي تنطبق على ميزات Azure الموجودة في الإصدار التجريبي، أو المعاينة، أو التي لم يتم إصدارها بعد في التوفر العام، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.

قيود إصدار المعاينة

فكر بعناية فيما إذا كانت هذه المعاينة مناسبة لك. وهو يتيح التتبع الموزع فقطويستثني:

واجهة برمجة تطبيقات المقاييس (مثل المقاييس المخصصة والمقاييس المجمعة مسبقا)
القياسات المباشرة
تسجيل واجهة برمجة التطبيقات (مثل سجلات وحدة التحكم ومكتبات التسجيل)
الالتقاط التلقائي للاستثناءات غير المعالجة
Profiler
Snapshot Debugger
تخزين القرص دون اتصال ومنطق إعادة المحاولة
Azure Active Directory authentication
أخذ نماذج
التجميع التلقائي لاسم دور السحابة ومثيل دور السحابة في بيئات Azure
التعداد التلقائي لمعرف المستخدم ومعرف المستخدم المصادق عليه عند استخدام التطبيق Insights JavaScript SDK
التعداد التلقائي لعنوان IP للمستخدم (لتحديد سمات الموقع)
القدرة على تجاوز اسم العملية
القدرة على تعيين معرف المستخدم أو معرف المستخدم المصادق عليه يدويا
نشر اسم العملية إلى القياس عن بعد التبعية
دعم مكتبات الأجهزة على وظائف Azure

إذا كنت بحاجة إلى تجربة كاملة الميزات، فاستخدم Insights التطبيقات الموجودة ASP.NET أو ASP.NET Core SDK حتى ينضج العرض المستند إلى OpenTelemetry.

الشروع في العمل

اتبع الخطوات الواردة في هذا القسم لتصحيح طلبك باستخدام OpenTelemetry.

المتطلبات الأساسية

اشتراك Azure: إنشاء اشتراك Azure مجانا
مورد Insights التطبيق: إنشاء مورد Insights تطبيق

تطبيق باستخدام إصدار مدعوم رسميا من .NET Core أو .NET Framework لا يقل عن .NET Framework 4.6.1

قم بتثبيت مكتبات العميل

تثبيت أحدث حزمة Azure.Monitor.OpenTelemetry.المصدر NuGet:

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

إذا تلقيت خطأ مثل "لا توجد إصدارات متوفرة للحزمة Azure.Monitor.OpenTelemetry.Exporter" ، فمن المحتمل أن يكون ذلك بسبب أن إعداد مصادر حزمة NuGet مفقود. حاول تحديد المصدر باستخدام الخيار -s :

# 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

تثبيت هذه الحزم:

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

يتم استخدام الحزم التالية أيضا لبعض السيناريوهات المحددة الموضحة لاحقا في هذه المقالة:

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

قم بتثبيت أحدث حزمة PyPI من Azure-monitor-opentelemetry-exporter :

pip install azure-monitor-opentelemetry-exporter

مكّن Azure Monitor Application Insights

يوفر هذا القسم إرشادات توضح كيفية تمكين OpenTelemetry.

أضف تعليمة برمجية لتقرير عن حالة النظام OpenTelemetry

توضح التعليمة البرمجية التالية كيفية تمكين OpenTelemetry في تطبيق وحدة تحكم C # عن طريق إعداد OpenTelemetry TracerProvider. يجب أن يكون هذا الرمز في بدء تشغيل التطبيق. بالنسبة ASP.NET Core ، يتم ذلك عادة في ConfigureServices طريقة فئة التطبيقStartup. بالنسبة ASP.NET التطبيقات ، يتم ذلك عادة في Global.asax.cs.

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

ملاحظة

Activity تمثل الفئات والفئات ActivitySource من System.Diagnostics مساحة الاسم مفاهيم Span OpenTelemetry و Tracer، على التوالي. يمكنك إنشاء ActivitySource مباشرة باستخدام منشئه بدلا من استخدام TracerProvider. يجب أن تكون كل ActivitySource فئة متصلة بشكل TracerProvider صريح باستخدام AddSource(). وذلك لأن أجزاء من واجهة برمجة تطبيقات تتبع OpenTelemetry يتم دمجها مباشرة في وقت تشغيل .NET. لمعرفة المزيد، راجع مقدمة حول واجهة برمجة تطبيقات OpenTelemetry .NET Ttrace.

توضح التعليمة البرمجية التالية كيفية تمكين OpenTelemetry في تطبيق Node.js بسيط:

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

توضح التعليمة البرمجية التالية كيفية تمكين OpenTelemetry في تطبيق Python بسيط:

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!")

تلميح

أضف مكتبات الأجهزة إلى التجميع التلقائي للقياس عن بعد عبر الأطر والمكتبات الشائعة.

تعيين سلسلة اتصال Insights التطبيق

استبدل العنصر النائب <Your Connection String> في التعليمة البرمجية السابقة بسلسلة الاتصال من التطبيق Insights المورد.

Screenshot of the Application Insights connection string.

تأكيد أن البيانات تتدفق

قم بتشغيل التطبيق الخاص بك وافتح علامة التبويب "مورد Insights التطبيق" في مدخل Azure. قد يستغرق ظهور البيانات في البوابة الإلكترونية بضع دقائق.

ملاحظة

إذا لم تتمكن من تشغيل التطبيق أو كنت لا تحصل على البيانات كما هو متوقع، فراجع استكشاف الأخطاء وإصلاحها.

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

هام

إذا كان لديك خدمتان أو أكثر تنبعثان من القياس عن بعد إلى نفس التطبيق Insights المورد، فسيطلب منك تعيين أسماء أدوار السحابة لتمثيلها بشكل صحيح على خريطة التطبيق.

كجزء من استخدام أجهزة تطبيق رؤى، نقوم بجمع وإرسال بيانات التشخيص إلى Microsoft. تساعدنا هذه البيانات على تشغيل وتحسين تطبيق رؤى. لديك خيار تعطيل جمع البيانات غير الأساسية. لمعرفة المزيد، راجع Statsbeat في تطبيق Azure Insights.

تعيين اسم دور السحابة ومثيل دور السحابة

يمكنك تعيين اسم دور السحابة ومثيل دور السحابة عبر سمات الموارد . تقوم هذه الخطوة بتحديث اسم دور السحابة ومثيل دور السحابة من قيمهما الافتراضية إلى شيء منطقي لفريقك. ستظهر على خريطة التطبيق كاسم أسفل عقدة. يستخدم service.namespace اسم دور السحابة وسماته service.name ، على الرغم من أنه يعود إلى service.name ما إذا service.namespace لم يتم تعيينه. يستخدم مثيل دور مجموعة النظراء 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
# ----------------------------------------------
            }
        )
    )
)
...

للحصول على معلومات حول السمات القياسية للموارد، راجع الاتفاقيات الدلالية للموارد.

أخذ نماذج

يتم دعم أخذ العينات في OpenTelemetry، ولكنه غير مدعوم في مصدر OpenTelemetry لمراقبة Azure في الوقت الحالي.

تحذير

يؤدي تمكين أخذ العينات في OpenTelemetry إلى جعل المقاييس القياسية والمستندة إلى السجل غير دقيقة للغاية ، مما يؤثر سلبا على جميع تجارب Insights التطبيق. أيضا ، يؤدي تمكين أخذ العينات إلى جانب التطبيق الحالي Insights SDKs إلى آثار مكسورة.

مكتبات الأجهزة

يتم التحقق من صحة المكتبات التالية للعمل مع إصدار المعاينة.

تحذير

تعتمد مكتبات الأجهزة على مواصفات القياس المفتوح التجريبية. يتمثل التزام Microsoft بدعم المعاينة في التأكد من أن المكتبات التالية تصدر بيانات إلى تطبيق Azure Monitor Insights، ولكن من الممكن أن يؤدي كسر التغييرات أو التعيين التجريبي إلى حظر بعض عناصر البيانات.

HTTP

قاعدة البيانات

إصدار عميل SQL: 1.0.0-rc7

ملاحظة

يتضمن عرض المعاينة فقط الأجهزة التي تتعامل مع طلبات HTTP وقاعدة البيانات. لمعرفة المزيد، راجع الاتفاقيات الدلالية للقياس عن بعد المفتوح.

تعديل القياس عن بُعد

يشرح هذا القسم كيفية تعديل القياس عن بعد.

إضافة سمات النطاق

لإضافة سمات النطاق، استخدم إحدى الطريقتين التاليتين:

استخدم الخيارات التي توفرها مكتبات الأجهزة.
إضافة معالج امتداد مخصص.

قد تتضمن هذه السمات إضافة خاصية مخصصة إلى القياس عن بعد. يمكنك أيضا استخدام السمات لتعيين حقول اختيارية في مخطط Insights التطبيق، مثل عنوان IP الخاص بالعميل.

تلميح

تتمثل ميزة استخدام الخيارات التي توفرها مكتبات الأجهزة ، عندما تكون متاحة ، في توفر السياق بأكمله. ونتيجة لذلك، يمكن للمستخدمين تحديد إضافة المزيد من السمات أو تصفيتها. على سبيل المثال، يتيح خيار الإثراء في مكتبة أجهزة HttpClient للمستخدمين الوصول إلى httpRequestMessage نفسه. يمكنهم تحديد أي شيء منه وتخزينه كسمة.

إضافة خاصية مخصصة

يتم تصدير أي سمات تضيفها إلى النطاقات كخصائص مخصصة. تقوم بتعبئة الحقل customDimensions في جداول الطلبات أو التبعيات في Insights التطبيق.

توفر العديد من مكتبات الأجهزة خيارا تثري. للحصول على إرشادات، راجع الملفات التمهيدية لمكتبات الأجهزة الفردية:
استخدام معالج مخصص:

تلميح

أضف المعالج الموضح هنا قبل مصدر شاشة Azure.

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

أضف 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");
    }
}

استخدام معالج مخصص:

تلميح

أضف المعالج الموضح هنا قبل مصدر شاشة Azure.

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

استخدام معالج مخصص:

تلميح

أضف المعالج الموضح هنا قبل مصدر شاشة Azure.

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

أضف 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"

تعيين عنوان IP للمستخدم

يمكنك ملء حقل client_IP للطلبات عن طريق تعيين السمة http.client_ip على النطاق. يستخدم التطبيق Insights عنوان IP لإنشاء سمات موقع المستخدم ثم يتجاهله بشكل افتراضي.

استخدم مثال إضافة خاصية مخصصة، ولكن استبدل الأسطر التالية من التعليمات البرمجية في ActivityEnrichingProcessor.cs:

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

استخدم مثال إضافة خاصية مخصصة، ولكن استبدل الأسطر التالية من التعليمات البرمجية:

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

class SpanEnrichingProcessor implements SpanProcessor{
    ...

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

استخدم مثال إضافة خاصية مخصصة، ولكن استبدل الأسطر التالية من التعليمات البرمجية في SpanEnrichingProcessor.py:

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

تصفية التتبع

يمكنك استخدام الطرق التالية لتصفية القياس عن بعد قبل أن يغادر التطبيق الخاص بك.

توفر العديد من مكتبات الأجهزة خيارا تثري. للحصول على إرشادات، راجع الملفات التمهيدية لمكتبات الأجهزة الفردية:

استخدام معالج مخصص:

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

أضف 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;
        }
    }
}

إذا لم تتم إضافة مصدر معين بشكل صريح باستخدام AddSource("ActivitySourceName")، فلن يتم تصدير أي من الأنشطة التي تم إنشاؤها باستخدام هذا المصدر.

استبعاد خيار عنوان URL الذي توفره العديد من مكتبات أجهزة HTTP.

يوضح المثال التالي كيفية استبعاد عنوان URL معين من التتبع باستخدام مكتبة أجهزة HTTP/HTTPS:

...
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,
    ]
});

استخدم معالجا مخصصا. يمكنك استخدام معالج نطاق مخصص لاستبعاد امتدادات معينة من تصديرها. لوضع علامة على النطاقات التي لا يمكن تصديرها، قم بالتعيين TraceFlag إلى DEFAULT. استخدم مثال إضافة خاصية مخصصة، ولكن استبدل الأسطر التالية من التعليمات البرمجية:
```
...
import { SpanKind, TraceFlags } from "@opentelemetry/api";

class SpanEnrichingProcessor implements SpanProcessor{
    ...

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

استبعاد خيار عنوان URL الذي توفره العديد من مكتبات أجهزة HTTP.

يوضح المثال التالي كيفية استبعاد عنوان URL معين من التتبع باستخدام أجهزة Flask:

...
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__)
...

استخدم معالجا مخصصا. يمكنك استخدام معالج نطاق مخصص لاستبعاد امتدادات معينة من تصديرها. لوضع علامة على النطاقات التي لا يمكن تصديرها، قم بالتعيين TraceFlag إلى DEFAULT.

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

أضف 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

قد ترغب في تمكين مصدر بروتوكول OpenTelemetry (OTLP) إلى جانب مصدر شاشة Azure من إرسال القياس عن بعد إلى موقعين.

ملاحظة

يتم عرض مصدر OTLP للراحة فقط. نحن لا ندعم رسميا مصدر OTLP أو أي مكونات أو تجارب طرف ثالث في اتجاه مجرى النهر. نقترح عليك فتح مشكلة مع OpenTelemetry-Collector لمشكلات OpenTelemetry خارج حدود دعم Azure.

قم بتثبيت حزمة OpenTelemetry.Exporter.OpenTelemetryProtocol مع Azure.Monitor.OpenTelemetry.Exporter في مشروعك.

أضف مقتطف التعليمات البرمجية التالي. يفترض هذا المثال أن لديك جامع OpenTelemetry مع تشغيل جهاز استقبال OTLP. للحصول على التفاصيل، راجع المثال على GitHub.

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

قم بتثبيت حزمة مصدر جامع OpenTelemetry جنبا إلى جنب مع مصدر OpenTelemetry لمراقبة Azure في مشروعك.
```
    npm install @opentelemetry/exporter-otlp-http
    npm install @azure/monitor-opentelemetry-exporter
```

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

تثبيت اللازوردية رصد opentelemetry المصدرة وopentelemetry المصدر otlp الحزم.

أضف مقتطف التعليمات البرمجية التالي. يفترض هذا المثال أن لديك جامع OpenTelemetry مع تشغيل جهاز استقبال OTLP. للحصول على التفاصيل، راجع هذا الملف التمهيدي.

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!")

استكشاف الأخطاء وإصلاحها

يوفر هذا القسم تعليمات حول استكشاف الأخطاء وإصلاحها.

تمكين التسجيل التشخيصي

يستخدم مصدر مراقبة Azure EventSource لتسجيل الدخول الداخلي الخاص به. تتوفر سجلات المصدر لأي EventListener عن طريق الاشتراك في المصدر المسمى OpenTelemetry-AzureMonitor-Exporter. للحصول على خطوات استكشاف الأخطاء وإصلاحها، راجع استكشاف أخطاء OpenTelemetry وإصلاحها.

يستخدم Azure Monitor Exporter مسجل واجهة برمجة تطبيقات OpenTelemetry للسجلات الداخلية. لتمكينه، استخدم التعليمة البرمجية التالية:

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 Monitor Exporter مكتبة التسجيل القياسية Python للتسجيل الداخلي الخاص به. عادة ما يتم تسجيل سجلات OpenTelemetry API و Azure Monitor Exporter على مستوى خطورة WARNING أو ERROR للنشاط غير المنتظم. يتم استخدام مستوى خطورة INFO للنشاط المنتظم أو الناجح. بشكل افتراضي، تقوم مكتبة تسجيل Python بتعيين مستوى الخطورة إلى تحذير، لذلك يجب تغيير مستوى الخطورة لرؤية السجلات ضمن إعداد الخطورة هذا. يوضح المثال التالي كيفية إخراج سجلات كافة مستويات الخطورة إلى وحدة التحكم وملف :

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

المشكلات المعروفة

تتضمن المشكلات المعروفة لمصدري القياس المفتوح لمراقبة Azure ما يلي:

اسم العملية مفقود في القياس عن بعد للتبعية، مما يؤثر سلبا على حالات الفشل وتجربة علامة تبويب الأداء.
طراز الجهاز مفقود عند الطلب والقياس عن بعد للتبعية ، مما يؤثر سلبا على تحليل مجموعة الأجهزة.
يتم ترك اسم خادم قاعدة البيانات خارج اسم التبعية، والذي يقوم بتجميع الجداول التي تحمل الاسم نفسه بشكل غير صحيح على خوادم مختلفة.

الدعم

للحصول على الدعم:

راجع خطوات استكشاف الأخطاء وإصلاحها في هذه المقالة.
بالنسبة إلى مشكلات دعم Azure، افتح تذكرة دعم Azure.

بالنسبة إلى مشكلات القياس عن بُعد المفتوح، اتصل بمجتمع القياس عن بُعد المفتوح مباشرة.

ردود فعل القياس عن بُعد المفتوح

لتقديم ملاحظات:

املأ استطلاع آراء العملاءفي مجتمع القياس عن بُعد المفتوح.
أخبر Microsoft عن نفسك من خلال الانضمام إلى مجتمع المتبنين المبكرين في OpenTelemetry.
تفاعل مع مستخدمي Azure Monitor الآخرين في مجتمع Microsoft التقني.
قم بتقديم طلب ميزة في منتدى ملاحظات Azure.

الخطوات التالية

لمراجعة التعليمات البرمجية المصدر، راجع مستودع Azure Monitor Exporter GitHub.
لتثبيت حزمة NuGet أو التحقق من وجود تحديثات أو عرض ملاحظات الإصدار، راجع صفحة حزمة NuGet الخاصة بمصدر مراقبة Azure .
للتعرف أكثر على تطبيق Azure Monitor Insights وOpenTelemetry، راجع تطبيق مثال شاشة Azure.
لمعرفة المزيد حول OpenTelemetry ومجتمعه، راجع مستودع OpenTelemetry .NET GitHub.
لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المتصفح.

تمكين Azure Monitor OpenTelemetry Exporter لتطبيقات .NET و Node.js و Python (معاينة)

هل هذه الصفحة مفيدة؟

قيود إصدار المعاينة

الشروع في العمل

المتطلبات الأساسية

قم بتثبيت مكتبات العميل

مكّن Azure Monitor Application Insights

أضف تعليمة برمجية لتقرير عن حالة النظام OpenTelemetry

تعيين سلسلة اتصال Insights التطبيق

تأكيد أن البيانات تتدفق

تعيين اسم دور السحابة ومثيل دور السحابة

أخذ نماذج

مكتبات الأجهزة

HTTP

قاعدة البيانات

تعديل القياس عن بُعد

إضافة سمات النطاق

إضافة خاصية مخصصة

تعيين عنوان IP للمستخدم

تصفية التتبع

تمكين مصدر OTLP

استكشاف الأخطاء وإصلاحها

تمكين التسجيل التشخيصي

المشكلات المعروفة

الدعم

ردود فعل القياس عن بُعد المفتوح

الخطوات التالية