استخدام OpenTelemetry مع Azure Functions

حاليا، لا يوجد دعم OpenTelemetry محسن للعميل لتطبيقات Java.

OpenTelemetry غير مدعوم حاليا لتطبيقات C# قيد المعالجة.

1. قم بتشغيل هذه الأوامر لتثبيت التجميعات المطلوبة في تطبيقك:

   • Application Insights
   • مصدر OTLP

   dotnet add package Microsoft.Azure.Functions.Worker.OpenTelemetry --version 1.0.0-preview1 
   dotnet add package OpenTelemetry.Extensions.Hosting 
   dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore  
   

2. في ملف مشروع Program.cs، أضف هذه using العبارة:

   • Application Insights
   • مصدر OTLP

   using Azure.Monitor.OpenTelemetry.AspNetCore; 
   

3. في ConfigureServices المفوض، أضف تكوين الخدمة هذا:

   • Application Insights
   • مصدر OTLP

   services.AddOpenTelemetry()
   .UseFunctionsWorkerDefaults()
   .UseAzureMonitor();
   

   للتصدير إلى كل من نقطتي نهاية OpenTelemetry، قم باستدعاء كل من UseAzureMonitor و UseOtlpExporter.

تحسينات عامل Java غير متوفرة بعد ل OpenTelemetry، لذلك لا يوجد شيء لتكوينه في تعليمة Java البرمجية الخاصة بك.

1. تثبيت حزم npm هذه في مشروعك:

   • Application Insights
   • مصدر OTLP

   npm install @opentelemetry/api 
   npm install @opentelemetry/auto-instrumentations-node 
   npm install @azure/monitor-opentelemetry-exporter 
   npm install @azure/functions-opentelemetry-instrumentation
   

1. أنشئ ملف تعليمة برمجية في مشروعك، وانسخ التعليمات البرمجية التالية والصقها في هذا الملف الجديد، واحفظ الملف باسم src/index.js:

   • Application Insights
   • مصدر OTLP

   const { AzureFunctionsInstrumentation } = require('@azure/functions-opentelemetry-instrumentation');
   const { AzureMonitorLogExporter, AzureMonitorTraceExporter } = require('@azure/monitor-opentelemetry-exporter');
   const { getNodeAutoInstrumentations, getResourceDetectors } = require('@opentelemetry/auto-instrumentations-node');
   const { registerInstrumentations } = require('@opentelemetry/instrumentation');
   const { detectResourcesSync } = require('@opentelemetry/resources');
   const { LoggerProvider, SimpleLogRecordProcessor } = require('@opentelemetry/sdk-logs');
   const { NodeTracerProvider, SimpleSpanProcessor } = require('@opentelemetry/sdk-trace-node');
   
   const resource = detectResourcesSync({ detectors: getResourceDetectors() });
   
   const tracerProvider = new NodeTracerProvider({ resource });
   tracerProvider.addSpanProcessor(new SimpleSpanProcessor(new AzureMonitorTraceExporter()));
   tracerProvider.register();
   
   const loggerProvider = new LoggerProvider({ resource });
   loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(new AzureMonitorLogExporter()));
   
   registerInstrumentations({
       tracerProvider,
       loggerProvider,
       instrumentations: [getNodeAutoInstrumentations(), new AzureFunctionsInstrumentation()],
   });
   

2. قم بتحديث الحقل في main ملف package.json لتضمين هذا الملف الجديد src/index.js ، والذي قد يبدو كما يلي:

   "main": "src/{index.js,functions/*.js}"
   

1. أنشئ ملف تعليمة برمجية في مشروعك، وانسخ التعليمات البرمجية التالية والصقها في هذا الملف الجديد، واحفظ الملف باسم src/index.ts:

   • Application Insights
   • مصدر OTLP

   import { AzureFunctionsInstrumentation } from '@azure/functions-opentelemetry-instrumentation';
   import { AzureMonitorLogExporter, AzureMonitorTraceExporter } from '@azure/monitor-opentelemetry-exporter';
   import { getNodeAutoInstrumentations, getResourceDetectors } from '@opentelemetry/auto-instrumentations-node';
   import { registerInstrumentations } from '@opentelemetry/instrumentation';
   import { detectResourcesSync } from '@opentelemetry/resources';
   import { LoggerProvider, SimpleLogRecordProcessor } from '@opentelemetry/sdk-logs';
   import { NodeTracerProvider, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-node';
   
   const resource = detectResourcesSync({ detectors: getResourceDetectors() });
   
   const tracerProvider = new NodeTracerProvider({ resource });
   tracerProvider.addSpanProcessor(new SimpleSpanProcessor(new AzureMonitorTraceExporter()));
   tracerProvider.register();
   
   const loggerProvider = new LoggerProvider({ resource });
   loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(new AzureMonitorLogExporter()));
   
   registerInstrumentations({
       tracerProvider,
       loggerProvider,
       instrumentations: [getNodeAutoInstrumentations(), new AzureFunctionsInstrumentation()],
   });
   

2. قم بتحديث الحقل في main ملف package.json لتضمين إخراج هذا الملف الجديد src/index.ts ، والذي قد يبدو كما يلي:

   "main": "dist/src/{index.js,functions/*.js}"
   

تنطبق هذه التعليمات فقط على مصدر OTLP:

1. أضف إعداد تطبيق باسم OTEL_FUNCTIONS_WORKER_ENABLED بقيمة True.

2. إنشاء مجلد على مستوى Modules التطبيق في جذر التطبيق وتشغيل الأمر التالي:

   Save-Module -Name AzureFunctions.PowerShell.OpenTelemetry.SDK
   

   يؤدي ذلك إلى تثبيت الوحدة النمطية المطلوبة AzureFunctions.PowerShell.OpenTelemetry.SDK مباشرة في تطبيقك. لا يمكنك استخدام الملف لتثبيت هذه التبعية requirements.psd1 تلقائيا لأن التبعيات المدارة غير مدعومة حاليا في معاينة خطة Flex Consumption.

3. أضف هذه التعليمة البرمجية إلى ملف profile.ps1 الخاص بك:

   Import-Module AzureFunctions.PowerShell.OpenTelemetry.SDK -Force -ErrorAction Stop 
   Initialize-FunctionsOpenTelemetry 
   

1. أضف هذا الإدخال في الملف:requirements.txt

   • Application Insights
   • مصدر OTLP

   azure.monitor.opentelemetry
   

2. أضف هذه التعليمة البرمجية إلى function_app.py ملف نقطة الإدخال الرئيسي:

   • Application Insights
   • مصدر OTLP

   from azure.monitor.opentelemetry import configure_azure_monitor 
   configure_azure_monitor()