تكوين Azure Monitor OpenTelemetry

استخدم إحدى الطرق الثلاث التالية لتكوين سلسلة الاتصال:

• إضافة UseAzureMonitor() إلى الملف:program.cs

  var builder = WebApplication.CreateBuilder(args);
  
  // Add the OpenTelemetry telemetry service to the application.
  // This service will collect and send telemetry data to Azure Monitor.
  builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
      options.ConnectionString = "<Your Connection String>";
  });
  
  var app = builder.Build();
  
  app.Run();
  

• تعيين متغير بيئة.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

• أضف القسم التالي إلى ملف التكوين.appsettings.json

  {
    "AzureMonitor": {
        "ConnectionString": "<Your Connection String>"
    }
  }
  

استخدم إحدى الطريقتين التاليتين لتكوين سلسلة الاتصال:

• أضف مصدر Azure Monitor إلى كل إشارة OpenTelemetry في بدء تشغيل التطبيق.

  // Create a new OpenTelemetry tracer provider.
  // It is important to keep the TracerProvider instance active throughout the process lifetime.
  var tracerProvider = Sdk.CreateTracerProviderBuilder()
      .AddAzureMonitorTraceExporter(options =>
      {
          options.ConnectionString = "<Your Connection String>";
      })
      .Build();
  
  // Create a new OpenTelemetry meter provider.
  // It is important to keep the MetricsProvider instance active throughout the process lifetime.
  var metricsProvider = Sdk.CreateMeterProviderBuilder()
      .AddAzureMonitorMetricExporter(options =>
      {
          options.ConnectionString = "<Your Connection String>";
      })
      .Build();
  
  // Create a new logger factory.
  // It is important to keep the LoggerFactory instance active throughout the process lifetime.
  var loggerFactory = LoggerFactory.Create(builder =>
  {
      builder.AddOpenTelemetry(logging =>
      {
          logging.AddAzureMonitorLogExporter(options =>
          {
              options.ConnectionString = "<Your Connection String>";
          });
      });
  });
  

• تعيين متغير بيئة.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

لتعيين سلسلة الاتصال، راجع سلسلة الاتصال.

استخدم إحدى الطريقتين التاليتين لتكوين سلسلة الاتصال:

• تعيين متغير بيئة.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

• تعيين خاصية.

  applicationinsights.connection.string=<Your Connection String>
  

استخدم إحدى الطريقتين التاليتين لتكوين سلسلة الاتصال:

• تعيين متغير بيئة.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

• استخدم كائن تكوين.

  // Import the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions class from the @azure/monitor-opentelemetry package.
  const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");
  
  // Create a new AzureMonitorOpenTelemetryOptions object.
  const options: AzureMonitorOpenTelemetryOptions = {
    azureMonitorExporterOptions: {
      connectionString: "<your connection string>"
    }
  };
  
  // Enable Azure Monitor integration using the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions object.
  useAzureMonitor(options);
  

استخدم إحدى الطريقتين التاليتين لتكوين سلسلة الاتصال:

• تعيين متغير بيئة.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

• استخدام الدالة configure_azure_monitor.

# 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 specified connection string.
# Replace `<your-connection-string>` with the connection string of your Azure Monitor Application Insights resource.
configure_azure_monitor(
    connection_string="<your-connection-string>",
)

قم بتعيين اسم دور السحابة ومثيل دور السحابة عبر سمات المورد . يستخدم اسم دور مجموعة النظراء السمات service.namespace وservice.name، على الرغم من أنه يقع مرة أخرى إلى service.name إذا لم يتم تعيين service.namespace. يستخدم مثيل دور مجموعة النظراء service.instance.id قيمة السمة. للحصول على معلومات حول السمات القياسية للموارد، راجع اصطلاحات القياس الدلالي OpenTelemetry.

// Setting role name and role instance

// Create a dictionary of resource attributes.
var resourceAttributes = new Dictionary<string, object> {
    { "service.name", "my-service" },
    { "service.namespace", "my-namespace" },
    { "service.instance.id", "my-instance" }};

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry()
    .UseAzureMonitor()
    // Configure the ResourceBuilder to add the custom resource attributes to all signals.
    // Custom resource attributes should be added AFTER AzureMonitor to override the default ResourceDetectors.
    .ConfigureResource(resourceBuilder => resourceBuilder.AddAttributes(_testResourceAttributes));

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

قم بتعيين اسم دور السحابة ومثيل دور السحابة عبر سمات المورد . يستخدم اسم دور مجموعة النظراء السمات service.namespace وservice.name، على الرغم من أنه يقع مرة أخرى إلى service.name إذا لم يتم تعيين service.namespace. يستخدم مثيل دور مجموعة النظراء service.instance.id قيمة السمة. للحصول على معلومات حول السمات القياسية للموارد، راجع اصطلاحات القياس الدلالي OpenTelemetry.

// Setting role name and role instance

// Create a dictionary of resource attributes.
var resourceAttributes = new Dictionary<string, object> {
    { "service.name", "my-service" },
    { "service.namespace", "my-namespace" },
    { "service.instance.id", "my-instance" }};

// Create a resource builder.
var resourceBuilder = ResourceBuilder.CreateDefault().AddAttributes(resourceAttributes);

// Create a new OpenTelemetry tracer provider and set the resource builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    // Set ResourceBuilder on the TracerProvider.
    .SetResourceBuilder(resourceBuilder)
    .AddAzureMonitorTraceExporter()
    .Build();

// Create a new OpenTelemetry meter provider and set the resource builder.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    // Set ResourceBuilder on the MeterProvider.
    .SetResourceBuilder(resourceBuilder)
    .AddAzureMonitorMetricExporter()
    .Build();

// Create a new logger factory and add the OpenTelemetry logger provider with the resource builder.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        // Set ResourceBuilder on the Logging config.
        logging.SetResourceBuilder(resourceBuilder);
        logging.AddAzureMonitorLogExporter();
    });
});

لتعيين اسم دور السحابة، راجع اسم دور السحابة.

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

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

• استخدم لتطبيقات الصور الأصلية spring.application.name ل Spring Boot
• استخدم لتطبيقات الصور الأصلية quarkus.application.name في Quarkus

قم بتعيين اسم دور السحابة ومثيل دور السحابة عبر سمات المورد . يستخدم اسم دور مجموعة النظراء السمات service.namespace وservice.name، على الرغم من أنه يقع مرة أخرى إلى service.name إذا لم يتم تعيين service.namespace. يستخدم مثيل دور مجموعة النظراء service.instance.id قيمة السمة. للحصول على معلومات حول السمات القياسية للموارد، راجع اصطلاحات القياس الدلالي OpenTelemetry.

// Import the useAzureMonitor function, the AzureMonitorOpenTelemetryOptions class, the Resource class, and the SemanticResourceAttributes class from the @azure/monitor-opentelemetry, @opentelemetry/resources, and @opentelemetry/semantic-conventions packages, respectively.
const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");
const { Resource } = require("@opentelemetry/resources");
const { SemanticResourceAttributes } = require("@opentelemetry/semantic-conventions");

// Create a new Resource object with the following custom resource attributes:
//
// * service_name: my-service
// * service_namespace: my-namespace
// * service_instance_id: my-instance
const customResource = new Resource({
  [SemanticResourceAttributes.SERVICE_NAME]: "my-service",
  [SemanticResourceAttributes.SERVICE_NAMESPACE]: "my-namespace",
  [SemanticResourceAttributes.SERVICE_INSTANCE_ID]: "my-instance",
});

// Create a new AzureMonitorOpenTelemetryOptions object and set the resource property to the customResource object.
const options: AzureMonitorOpenTelemetryOptions = {
  resource: customResource
};

// Enable Azure Monitor integration using the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions object.
useAzureMonitor(options);

قم بتعيين اسم دور السحابة ومثيل دور السحابة عبر سمات المورد . يستخدم اسم دور مجموعة النظراء السمات service.namespace وservice.name، على الرغم من أنه يقع مرة أخرى إلى service.name إذا لم يتم تعيين service.namespace. يستخدم مثيل دور مجموعة النظراء service.instance.id قيمة السمة. للحصول على معلومات حول السمات القياسية للموارد، راجع اصطلاحات القياس الدلالي OpenTelemetry.

تعيين سمات الموارد باستخدام OTEL_RESOURCE_ATTRIBUTES و/أو OTEL_SERVICE_NAME متغيرات البيئة. OTEL_RESOURCE_ATTRIBUTES يأخذ سلسلة من أزواج قيم المفاتيح المفصولة بفواصل. على سبيل المثال، لتعيين اسم دور السحابة إلى my-namespace.my-helloworld-service وتعيين مثيل دور السحابة إلى my-instance، يمكنك تعيين OTEL_RESOURCE_ATTRIBUTES وعلى OTEL_SERVICE_NAME هذا النحو:

export OTEL_RESOURCE_ATTRIBUTES="service.namespace=my-namespace,service.instance.id=my-instance"
export OTEL_SERVICE_NAME="my-helloworld-service"

إذا لم تقم بتعيين سمة service.namespace المورد، يمكنك بدلا من ذلك تعيين اسم دور السحابة مع متغير البيئة OTEL_SERVICE_NAME فقط أو سمة service.name المورد. على سبيل المثال، لتعيين اسم دور السحابة إلى my-helloworld-service وتعيين مثيل دور السحابة إلى my-instance، يمكنك تعيين OTEL_RESOURCE_ATTRIBUTES وعلى OTEL_SERVICE_NAME هذا النحو:

export OTEL_RESOURCE_ATTRIBUTES="service.instance.id=my-instance"
export OTEL_SERVICE_NAME="my-helloworld-service"

يتوقع العينة معدل عينة يتراوح بين 0 و1 ضمنا. معدل 0.1 يعني أن حوالي 10٪ من آثارك يتم إرسالها.

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor(options =>
{
    // Set the sampling ratio to 10%. This means that 10% of all traces will be sampled and sent to Azure Monitor.
    options.SamplingRatio = 0.1F;
});

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

يتوقع العينة معدل عينة يتراوح بين 0 و1 ضمنا. معدل 0.1 يعني أن حوالي 10٪ من آثارك يتم إرسالها.

// Create a new OpenTelemetry tracer provider.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter(options =>
    {   
        // Set the sampling ratio to 10%. This means that 10% of all traces will be sampled and sent to Azure Monitor.
        options.SamplingRatio = 0.1F;
    })
    .Build();

بدءا من 3.4.0، يتوفر أخذ العينات محدودة المعدل وهو الآن الافتراضي. لمزيد من المعلومات حول أخذ العينات، راجع أخذ عينات Java.

بالنسبة لتطبيقات Spring Boot الأصلية، تنطبق تكوينات أخذ العينات ل OpenTelemetry Java SDK.

بالنسبة لتطبيقات Quarkus الأصلية، راجع وثائق Quarkus OpenTelemetry.

يتوقع العينة معدل عينة يتراوح بين 0 و1 ضمنا. معدل 0.1 يعني أن حوالي 10٪ من آثارك يتم إرسالها.

// Import the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions class from the @azure/monitor-opentelemetry package.
const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");

// Create a new AzureMonitorOpenTelemetryOptions object and set the samplingRatio property to 0.1.
const options: AzureMonitorOpenTelemetryOptions = {
  samplingRatio: 0.1
};

// Enable Azure Monitor integration using the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions object.
useAzureMonitor(options);

configure_azure_monitor() تستخدم الدالة تلقائيا ApplicationInsightsSampler للتوافق مع Application Insights SDKs ولعينة بيانات تتبع الاستخدام الخاصة بك. OTEL_TRACES_SAMPLER_ARG يمكن استخدام متغير البيئة لتحديد معدل أخذ العينات، مع نطاق صالح من 0 إلى 1، حيث 0 هو 0٪ و1 هو 100٪. على سبيل المثال، تعني قيمة 0.1 أن 10٪ من آثارك يتم إرسالها.

export OTEL_TRACES_SAMPLER_ARG=0.1

يتم تمكين هذه الميزة بشكل افتراضي.

يمكن للمستخدمين تعطيل Live Metrics عند تكوين Distro.

builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
	// Disable the Live Metrics feature.
    options.EnableLiveMetrics = false;
});

هذه الميزة غير متوفرة في Azure Monitor .NET Exporter.

يتم تمكين تجربة المقاييس المباشرة بشكل افتراضي.

لمزيد من المعلومات حول تكوين Java، راجع خيارات التكوين: Azure Monitor Application Insights ل Java.

لا تتوفر المقاييس المباشرة اليوم لتطبيقات GraalVM الأصلية.

يمكن للمستخدمين تمكين/تعطيل Live Metrics عند تكوين Distro باستخدام الخاصية enableLiveMetrics .

const options: AzureMonitorOpenTelemetryOptions = {
    azureMonitorExporterOptions: {
        connectionString:
            process.env["APPLICATIONINSIGHTS_CONNECTION_STRING"] || "<your connection string>",
    },
    enableLiveMetrics: false
};

useAzureMonitor(options);

يمكنك تمكين المقاييس المباشرة باستخدام Azure monitor OpenTelemetry Distro ل Python كما يلي:

...
configure_azure_monitor(
	enable_live_metrics=True
)
...

للحصول على معلومات حول تكوين مصادقة معرف Entra، راجع مصادقة Microsoft Entra ل Application Insights

للحصول على معلومات حول تكوين مصادقة معرف Entra، راجع مصادقة Microsoft Entra ل Application Insights

للحصول على معلومات حول تكوين مصادقة معرف Entra، راجع مصادقة Microsoft Entra ل Application Insights

لا تتوفر مصادقة معرف Microsoft Entra لتطبيقات GraalVM الأصلية.

للحصول على معلومات حول تكوين مصادقة معرف Entra، راجع مصادقة Microsoft Entra ل Application Insights

للحصول على معلومات حول تكوين مصادقة معرف Entra، راجع مصادقة Microsoft Entra ل Application Insights

تتضمن حزمة Distro AzureMonitorExporter، الذي يستخدم بشكل افتراضي أحد المواقع التالية للتخزين دون اتصال (مدرج بترتيب الأسبقية):

• Windows
  • ٪LOCALAPPDATA٪\Microsoft\AzureMonitor
  • ٪TEMP٪\Microsoft\AzureMonitor
• غير Windows
  • ٪TMPDIR٪/Microsoft/AzureMonitor
  • /var/tmp/Microsoft/AzureMonitor
  • /tmp/Microsoft/AzureMonitor

لتجاوز الدليل الافتراضي، يجب عليك تعيين AzureMonitorOptions.StorageDirectory.

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor(options =>
{
    // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
    // This is the directory where the OpenTelemetry SDK will store any telemetry data that cannot be sent to Azure Monitor immediately.
    options.StorageDirectory = "C:\\SomeDirectory";
});

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

لتعطيل هذه الميزة، يجب تعيين AzureMonitorOptions.DisableOfflineStorage = true.

بشكل افتراضي، يستخدم AzureMonitorExporter أحد المواقع التالية للتخزين دون اتصال (مدرج بترتيب الأسبقية):

• Windows
  • ٪LOCALAPPDATA٪\Microsoft\AzureMonitor
  • ٪TEMP٪\Microsoft\AzureMonitor
• غير Windows
  • ٪TMPDIR٪/Microsoft/AzureMonitor
  • /var/tmp/Microsoft/AzureMonitor
  • /tmp/Microsoft/AzureMonitor

لتجاوز الدليل الافتراضي، يجب عليك تعيين AzureMonitorExporterOptions.StorageDirectory.

// Create a new OpenTelemetry tracer provider and set the storage directory.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter(options =>
    {
        // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
        // This is the directory where the OpenTelemetry SDK will store any trace data that cannot be sent to Azure Monitor immediately.
        options.StorageDirectory = "C:\\SomeDirectory";
        })
        .Build();

// Create a new OpenTelemetry meter provider and set the storage directory.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddAzureMonitorMetricExporter(options =>
    {
        // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
        // This is the directory where the OpenTelemetry SDK will store any metric data that cannot be sent to Azure Monitor immediately.
        options.StorageDirectory = "C:\\SomeDirectory";
        })
        .Build();

// Create a new logger factory and add the OpenTelemetry logger provider with the storage directory.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        logging.AddAzureMonitorLogExporter(options =>
        {
            // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
            // This is the directory where the OpenTelemetry SDK will store any log data that cannot be sent to Azure Monitor immediately.
            options.StorageDirectory = "C:\\SomeDirectory";
        });
    });
});

لتعطيل هذه الميزة، يجب تعيين AzureMonitorExporterOptions.DisableOfflineStorage = true.

لا يتوفر تكوين التخزين دون اتصال وإعادة المحاولة التلقائية في Java.

للحصول على قائمة كاملة بالتكوينات المتوفرة، راجع خيارات التكوين.

لا يتوفر تكوين التخزين دون اتصال وإعادة المحاولة التلقائية في تطبيقات الصور الأصلية ل Java.

بشكل افتراضي، يستخدم AzureMonitorExporter أحد المواقع التالية للتخزين دون اتصال.

• Windows
  • ٪TEMP٪\Microsoft\AzureMonitor
• غير Windows
  • ٪TMPDIR٪/Microsoft/AzureMonitor
  • /var/tmp/Microsoft/AzureMonitor

لتجاوز الدليل الافتراضي، يجب عليك تعيين storageDirectory.

على سبيل المثال:

// Import the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions class from the @azure/monitor-opentelemetry package.
const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");

// Create a new AzureMonitorOpenTelemetryOptions object and set the azureMonitorExporterOptions property to an object with the following properties:
//
// * connectionString: The connection string for your Azure Monitor Application Insights resource.
// * storageDirectory: The directory where the Azure Monitor OpenTelemetry exporter will store telemetry data when it is offline.
// * disableOfflineStorage: A boolean value that specifies whether to disable offline storage.
const options: AzureMonitorOpenTelemetryOptions = {
  azureMonitorExporterOptions: {
    connectionString: "<Your Connection String>",
    storageDirectory: "C:\\SomeDirectory",
    disableOfflineStorage: false
  }
};

// Enable Azure Monitor integration using the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions object.
useAzureMonitor(options);

لتعطيل هذه الميزة، يجب تعيين disableOfflineStorage = true.

بشكل افتراضي، يستخدم مصدرو Azure Monitor المسار التالي:

<tempfile.gettempdir()>/Microsoft/AzureMonitor/opentelemetry-python-<your-instrumentation-key>

لتجاوز الدليل الافتراضي، يجب تعيين storage_directory إلى الدليل الذي تريده.

على سبيل المثال:

...
# Configure OpenTelemetry to use Azure Monitor with the specified connection string and storage directory.
# Replace `your-connection-string` with the connection string to your Azure Monitor Application Insights resource.
# Replace `C:\\SomeDirectory` with the directory where you want to store the telemetry data before it is sent to Azure Monitor.
configure_azure_monitor(
    connection_string="your-connection-string",
    storage_directory="C:\\SomeDirectory",
)
...

لتعطيل هذه الميزة، يجب تعيين disable_offline_storage إلى True. الإعدادات الافتراضية لـ False.

على سبيل المثال:

...
# Configure OpenTelemetry to use Azure Monitor with the specified connection string and disable offline storage.
# Replace `your-connection-string` with the connection string to your Azure Monitor Application Insights resource.
configure_azure_monitor(
    connection_string="your-connection-string",
    disable_offline_storage=True,
)
...

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

   dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol
   

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

   // Create a new ASP.NET Core web application builder.
   var builder = WebApplication.CreateBuilder(args);
   
   // Add the OpenTelemetry telemetry service to the application.
   // This service will collect and send telemetry data to Azure Monitor.
   builder.Services.AddOpenTelemetry().UseAzureMonitor();
   
   // Add the OpenTelemetry OTLP exporter to the application.
   // This exporter will send telemetry data to an OTLP receiver, such as Prometheus
   builder.Services.AddOpenTelemetry().WithTracing(builder => builder.AddOtlpExporter());
   builder.Services.AddOpenTelemetry().WithMetrics(builder => builder.AddOtlpExporter());
   
   // Build the ASP.NET Core web application.
   var app = builder.Build();
   
   // Start the ASP.NET Core web application.
   app.Run();
   

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

   dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol
   

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

   // Create a new OpenTelemetry tracer provider and add the Azure Monitor trace exporter and the OTLP trace exporter.
   // It is important to keep the TracerProvider instance active throughout the process lifetime.
   var tracerProvider = Sdk.CreateTracerProviderBuilder()
       .AddAzureMonitorTraceExporter()
       .AddOtlpExporter()
       .Build();
   
   // Create a new OpenTelemetry meter provider and add the Azure Monitor metric exporter and the OTLP metric exporter.
   // It is important to keep the MetricsProvider instance active throughout the process lifetime.
   var metricsProvider = Sdk.CreateMeterProviderBuilder()
       .AddAzureMonitorMetricExporter()
       .AddOtlpExporter()
       .Build();
   

لمزيد من المعلومات حول Java، راجع وثائق Java التكميلية.

لا يمكنك تمكين مصدر بروتوكول القياس المفتوح (OTLP) جنبا إلى جنب مع مصدر Azure Monitor لإرسال بيانات تتبع الاستخدام إلى موقعين.

1. قم بتثبيت OpenTelemetry Collector Trace Exporter وحزم OpenTelemetry الأخرى في مشروعك.

       npm install @opentelemetry/api
       npm install @opentelemetry/exporter-trace-otlp-http
       npm install @opentelemetry/sdk-trace-base
       npm install @opentelemetry/sdk-trace-node
   

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

   // Import the useAzureMonitor function, the AzureMonitorOpenTelemetryOptions class, the trace module, the ProxyTracerProvider class, the BatchSpanProcessor class, the NodeTracerProvider class, and the OTLPTraceExporter class from the @azure/monitor-opentelemetry, @opentelemetry/api, @opentelemetry/sdk-trace-base, @opentelemetry/sdk-trace-node, and @opentelemetry/exporter-trace-otlp-http packages, respectively.
   const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");
   const { BatchSpanProcessor } = require('@opentelemetry/sdk-trace-base');
   const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-http');
   
   // Create a new OTLPTraceExporter object.
   const otlpExporter = new OTLPTraceExporter();
   
   // Enable Azure Monitor integration.
   const options: AzureMonitorOpenTelemetryOptions = {
       // Add the SpanEnrichingProcessor
       spanProcessors: [new BatchSpanProcessor(otlpExporter)] 
   }
   useAzureMonitor(options);
   

1. تثبيت حزمة opentelemetry-exporter-otlp .

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

   # Import the `configure_azure_monitor()`, `trace`, `OTLPSpanExporter`, and `BatchSpanProcessor` classes from the appropriate packages.    
   from azure.monitor.opentelemetry import configure_azure_monitor
   from opentelemetry import trace
   from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter
   from opentelemetry.sdk.trace.export import BatchSpanProcessor
   
   # Configure OpenTelemetry to use Azure Monitor with the specified connection string.
   # Replace `<your-connection-string>` with the connection string to your Azure Monitor Application Insights resource.
   configure_azure_monitor(
       connection_string="<your-connection-string>",
   )
   
   # Get the tracer for the current module.
   tracer = trace.get_tracer(__name__) 
   
   # Create an OTLP span exporter that sends spans to the specified endpoint.
   # Replace `http://localhost:4317` with the endpoint of your OTLP collector.
   otlp_exporter = OTLPSpanExporter(endpoint="http://localhost:4317")
   
   # Create a batch span processor that uses the OTLP span exporter.
   span_processor = BatchSpanProcessor(otlp_exporter)
   
   # Add the batch span processor to the tracer provider.
   trace.get_tracer_provider().add_span_processor(span_processor)
   
   # Start a new span with the name "test".
   with tracer.start_as_current_span("test"):
       print("Hello world!")
   

لمزيد من المعلومات حول Java، راجع وثائق Java التكميلية.

بالنسبة لتطبيقات Spring Boot الأصلية ، تتوفر تكوينات OpenTelemetry Java SDK.

بالنسبة لتطبيقات Quarkus الأصلية، راجع وثائق Quarkus OpenTelemetry.

لمزيد من المعلومات حول تكوين OpenTelemetry SDK، راجع وثائق OpenTelemetry.

لمزيد من المعلومات حول تكوين OpenTelemetry SDK، راجع وثائق OpenTelemetry واستخدام Distro لمراقبة Azure.

عند استخدام حزمة توزيع Azure.Monitor.OpenTelemetry.AspNetCore، يتم تضمين مكتبتي ASP.NET Core وHttpClient Instrumentation. تقوم حزمة distro الخاصة بنا بإيقاف تشغيل Query String Redaction بشكل افتراضي.

لتغيير هذا السلوك، يجب تعيين متغير بيئة إلى أو true false.

• ASP.NET Core Instrumentation: OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_DISABLE_URL_QUERY_REDACTION يتم تعطيل Query String Redaction بشكل افتراضي. للتمكين، قم بتعيين متغير البيئة هذا إلى false.
• Http Client Instrumentation: OTEL_DOTNET_EXPERIMENTAL_HTTPCLIENT_DISABLE_URL_QUERY_REDACTION يتم تعطيل Query String Redaction بشكل افتراضي. للتمكين، قم بتعيين متغير البيئة هذا إلى false.

عند استخدام Azure.Monitor.OpenTelemetry.Exporter، يجب تضمين مكتبات ASP.NET Core أو HttpClient Instrumentation يدويا في تكوين OpenTelemetry. تحتوي مكتبات الأجهزة هذه على QueryString Redaction ممكن بشكل افتراضي.

لتغيير هذا السلوك، يجب تعيين متغير بيئة إلى أو true false.

• ASP.NET Core Instrumentation: OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_DISABLE_URL_QUERY_REDACTION يتم تمكين Query String Redaction بشكل افتراضي. لتعطيل، قم بتعيين متغير البيئة هذا إلى true.
• Http Client Instrumentation: OTEL_DOTNET_EXPERIMENTAL_HTTPCLIENT_DISABLE_URL_QUERY_REDACTION يتم تمكين Query String Redaction بشكل افتراضي. لتعطيل، قم بتعيين متغير البيئة هذا إلى true.

أضف ما يلي إلى applicationinsights.json ملف التكوين:

{
  "preview": {
    "processors": [
      {
        "type": "attribute",
        "actions": [
          {
            "key": "url.query",
            "pattern": "^.*$",
            "replace": "REDACTED",
            "action": "mask"
          }
        ]
      },
      {
        "type": "attribute",
        "actions": [
          {
            "key": "url.full",
            "pattern": "[?].*$",
            "replace": "?REDACTED",
            "action": "mask"
          }
        ]
      }
    ]
  }
}

نحن نعمل بنشاط في مجتمع OpenTelemetry لدعم Redaction.

عند استخدام حزمة توزيع بيانات تتبع استخدام Azure Monitor OpenTelemetry، يمكن تنقيح سلاسل الاستعلام عن طريق إنشاء معالج امتداد وتطبيقه على تكوين distro.

import { useAzureMonitor, AzureMonitorOpenTelemetryOptions } from "@azure/monitor-opentelemetry";
import { Context } from "@opentelemetry/api";
import { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
import { SEMATTRS_HTTP_ROUTE, SEMATTRS_HTTP_TARGET, SEMATTRS_HTTP_URL } from "@opentelemetry/semantic-conventions";

class RedactQueryStringProcessor implements SpanProcessor {
  forceFlush(): Promise<void> {
	return Promise.resolve();
  }
  onStart(span: Span, parentContext: Context): void {
    return;
  }
  shutdown(): Promise<void> {
	return Promise.resolve();
  }
  onEnd(span: ReadableSpan) {
    const httpRouteIndex: number = String(span.attributes[SEMATTRS_HTTP_ROUTE]).indexOf('?');
    const httpUrlIndex: number = String(span.attributes[SEMATTRS_HTTP_URL]).indexOf('?');
    const httpTargetIndex: number = String(span.attributes[SEMATTRS_HTTP_TARGET]).indexOf('?');
    if (httpRouteIndex !== -1) {
      span.attributes[SEMATTRS_HTTP_ROUTE] = String(span.attributes[SEMATTRS_HTTP_ROUTE]).substring(0, httpRouteIndex);
    }
    if (httpUrlIndex !== -1) {
      span.attributes[SEMATTRS_HTTP_URL] = String(span.attributes[SEMATTRS_HTTP_URL]).substring(0, httpUrlIndex);
    }
    if (httpTargetIndex !== -1) {
      span.attributes[SEMATTRS_HTTP_TARGET] = String(span.attributes[SEMATTRS_HTTP_TARGET]).substring(0, httpTargetIndex);
    }
  }
}

const options: AzureMonitorOpenTelemetryOptions = {
  azureMonitorExporterOptions: {
      connectionString: <YOUR_CONNECTION_STRING>,
  },
  spanProcessors: [new RedactQueryStringProcessor()]
};

useAzureMonitor(options);

نحن نعمل بنشاط في مجتمع OpenTelemetry لدعم Redaction.