ترحيل SDKs من Elastic

يوفّر Elastic Stack نوعين من حِزم SDK الخاصة بلغات البرمجة لإضافة أدوات الرصد إلى التطبيقات:

Elastic Official APM agents – صُمِّمت هذه خصيصًا للاستخدام مع Elastic Stack. لا يتوفر حاليًا مسار ترحيل مباشر لهذه الحِزم. وستحتاج التطبيقات التي تستخدمها إلى إعادة تزويدها بأدوات الرصد باستخدام ClickStack SDKs المناسبة.
Elastic Distributions of OpenTelemetry (EDOT SDKs) – هذه هي توزيعات Elastic من OpenTelemetry SDKs القياسية، وهي متاحة لـ .NET وJava وNode.js وPHP وبايثون. إذا كان تطبيقك يستخدم بالفعل إحدى حِزم EDOT SDK، فلن تحتاج إلى إعادة تزويد الشيفرة بأدوات الرصد. بدلًا من ذلك، يمكنك ببساطة إعادة تهيئة الـ SDK لتصدير بيانات القياس عن بُعد إلى OTLP Collector المضمَّن في ClickStack. راجع “ترحيل EDOT SDKs” لمزيد من التفاصيل.

استخدم ClickStack SDKs كلما أمكنرغم أن OpenTelemetry SDKs القياسية مدعومة، فإننا نوصي بشدة باستخدام ClickStack-distributed SDKs لكل لغة. تتضمن هذه التوزيعات أدوات رصد إضافية، وإعدادات افتراضية محسّنة، وامتدادات مخصّصة صُمِّمت للعمل بسلاسة مع pipeline وواجهة المستخدم في ClickStack. ومن خلال استخدام ClickStack SDKs، يمكنك الاستفادة من ميزات متقدمة مثل stack traces الخاصة بالاستثناءات، وهي ميزات لا تتوفر في OpenTelemetry أو EDOT SDKs القياسية.

ترحيل EDOT SDKs

على غرار SDKs المستندة إلى OpenTelemetry في ClickStack، تُعدّ Elastic Distributions of the OpenTelemetry SDKs ‏(EDOT SDKs) إصدارات مخصّصة من OpenTelemetry SDKs الرسمية. فعلى سبيل المثال، تُعدّ EDOT بايثون SDK توزيعة مخصّصة من المورّد لـ OpenTelemetry بايثون SDK، ومصمّمة للعمل بسلاسة مع Elastic Observability. ونظرًا إلى أن هذه SDKs تستند إلى مكتبات OpenTelemetry القياسية، فإن الترحيل إلى ClickStack عملية مباشرة، ولا يتطلّب الأمر إعادة أدوات الرصد. وكل ما تحتاج إليه هو تعديل الإعدادات لتوجيه بيانات القياس عن بُعد إلى ClickStack OpenTelemetry Collector. تتّبع configuration آليات OpenTelemetry القياسية. وفي بايثون، يتم ذلك عادةً عبر متغيرات البيئة، كما هو موضّح في وثائق OpenTelemetry Zero-Code Instrumentation. قد تبدو configuration نموذجية لـ EDOT SDK كما يلي:

export OTEL_RESOURCE_ATTRIBUTES=service.name=<app-name>
export OTEL_EXPORTER_OTLP_ENDPOINT=https://my-deployment.ingest.us-west1.gcp.cloud.es.io
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=ApiKey P....l"

للترحيل إلى ClickStack، حدِّث نقطة النهاية لتشير إلى OTLP Collector المحلي، وغيِّر ترويسة Authorization:

export OTEL_RESOURCE_ATTRIBUTES=service.name=<app-name>
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
export OTEL_EXPORTER_OTLP_HEADERS="authorization=<YOUR_INGESTION_API_KEY>"

يتم إنشاء مفتاح API للإدخال بواسطة تطبيق HyperDX، ويمكن العثور عليه ضمن Team Settings → API Keys.

بدء الاستخدام

الميزات

إدارة ClickStack

أدلة إرشادية

شركاء التكامل

ترحيل EDOT SDKs

​ترحيل EDOT SDKs

ترحيل EDOT SDKs