EDOT Kubernetes: النشر باستخدام OpenTelemetry Operator

EDOT Kubernetes خطوة بخطوة: ثبّت OpenTelemetry Operator عبر Helm، وافهم daemon وcluster وgateway، وفعّل الأدوات التلقائية (auto-instrumentation).
EDOT Kubernetes : déployer avec l'OpenTelemetry Operator

EDOT Kubernetes هو نشر توزيعة OpenTelemetry من Elastic (المعروفة بـ EDOT) على عنقود (cluster) تديره أداة OpenTelemetry Operator. بحسب وثائق Elastic، يتم التثبيت عبر مخطط Helm باسم opentelemetry-kube-stack وملف قيم منشور في المستودع elastic/elastic-agent. يتبع هذا الدرس هذا الإجراء، ثم يشرح ما تنشره الأداة نيابةً عنك وما تتركه على عاتقك.

المشكلة من جهة مهندس SRE أو فريق المنصة: تزويد عشرين خدمة بالأدوات يدويًا، حزمة SDK واحدة في كل مرة، لا يصمد. الهدف هنا الحصول، بأوامر قليلة، على مجمّعات (collectors) في كل عقدة وعلى أدوات تلقائية (auto-instrumentation) تُفعَّل بتعليق توضيحي (annotation). يخص هذا المحتوى Elastic؛ فهو لا يعتمد على Dynatrace SaaS ولا على Dynatrace Managed، لكن منطق Operator هو نفسه في دليلنا حول OpenTelemetry Operator والأدوات التلقائية.

باختصار

  • يتلخص التثبيت في أربعة أوامر: مستودع Helm، وnamespace، وsecret، ثم helm install.
  • يعلن ملف القيم من Elastic ثلاثة مجمّعات: daemon (من نوع DaemonSet) وcluster وgateway.
  • تعتمد الأدوات التلقائية على مورد Instrumentation باسم elastic-instrumentation وعلى تعليق توضيحي على مستوى namespace.
  • لا يختار Operator مواردك ولا حصصك ولا استراتيجية أخذ العينات: تبقى هذه الإعدادات من مسؤوليتك.

المتطلبات المسبقة لنشر EDOT Kubernetes

وفقًا لصفحة البدء السريع من Elastic لـ Kubernetes المُدار ذاتيًا، يلزم Helm بالإصدار 3.9 أو أحدث، حتى الإصدار 4.3.0 ضمنًا. لا تذكر الصفحة متطلبات أخرى. جهّز أيضًا وصول kubectl إلى العنقود، وعنوان URL لنقطة نهاية Elasticsearch، ومفتاح API من Elastic. توضع هاتان القيمتان في secret: لا تكتبهما أبدًا في ملف خاضع للتحكم في الإصدارات.

الإصدارات التي ذكرتها الوثائق وقت القراءة: المخطط opentelemetry-kube-stack بالإصدار 0.16.0، وملف القيم من الوسم v9.5.5 الخاص بـ Elastic Agent. تحقق من الصفحة قبل التثبيت: هذه الأرقام تتغير.

تثبيت OpenTelemetry Operator عبر مخطط Helm

هذا هو التسلسل الوارد في وثائق Elastic، مع قيم تجريبية عليك استبدالها.

أوامر helm repo add وkubectl create namespace وkubectl create secret وhelm install لمخطط opentelemetry-kube-stack بالإصدار 0.16.0
  1. أضف مستودع Helm الخاص بـ OpenTelemetry بالأمر helm repo add.
  2. أنشئ الـ namespace المسمى opentelemetry-operator-system.
  3. أنشئ الـ secret المسمى elastic-secret-otel بالمفتاحين elastic_endpoint وelastic_api_key. يقرأ ملف القيم هذين المفتاحين عبر secretKeyRef.
  4. شغّل helm install مع --values يشير إلى ملف Elastic و--version 0.16.0.

على OpenShift، تشير الصفحة إلى إضافة ملف قيم ثانٍ بعد الأول. لا أتناول هذه الحالة هنا: اقرأ قسم «Deploy on OpenShift» في الوثائق.

الخطوة الأخيرة من جهة Elastic: تثبيت تكاملَي «Kubernetes OpenTelemetry Assets» و«System OpenTelemetry Assets» في Kibana، ثم فتح لوحات المعلومات. هذا هو التحقق الوحيد الذي تصفه الصفحة.

ما ينشره Operator: daemon وcluster وgateway

يفعّل ملف القيم (المقروء في مستودع Elastic على GitHub) تعريفات CRD الخاصة بـ Operator، ويعطّل Target Allocator، ويعرّف ثلاثة مجمّعات مبنية على الصورة docker.elastic.co/elastic-agent/elastic-agent. تصف وثائق أنماط النشر مخططًا من مستويين.

المجمّع الشكل الدور بحسب وثائق Elastic
daemon DaemonSet، pod واحد لكل عقدة سجلات ومقاييس العقدة، واستقبال OTLP من التطبيقات، والإثراء، والإرسال إلى gateway
cluster Deployment أحداث ومقاييس على مستوى العنقود عبر واجهة Kubernetes API
gateway Deployment، نسختان (replicas) في الملف يستقبل كل شيء بصيغة OTLP، ويعالجه ويصدّره إلى Elasticsearch

تحدد صفحة الإعداد الافتراضي المستقبِلات (receivers): filelog وhostmetrics وkubeletstats وOTLP لـ daemon، وk8s_cluster وk8sobjects لمجمّع العنقود. في ملف القيم، يفعّل daemon جمع السجلات وhostNetwork، ويعمل بصلاحيات root لجمع المقاييس. راجع هذا القيد مع فريق الأمان لديك.

من جهة الإخراج، يستخدم gateway المُصدِّر elasticsearch/otel بنمط التعيين otel. وتمر التتبعات (traces) كذلك عبر المعالج والموصل elasticapm.

مقتطف من ملف values.yaml: مجمّع gateway مع المُصدِّر elasticsearch/otel والتعيين otel وخط معالجة التتبعات مع elasticapm

لفهم كل مكوّن، تصلح مقالتنا حول مكونات Collector contrib مرجعًا. وإذا كانت وجهتك Dynatrace بدل Elasticsearch، فبنية الوكيل ثم gateway تبقى صالحة؛ راجع دليلنا حول Collector على Kubernetes.

تفعيل الأدوات التلقائية بالتعليق التوضيحي

ينشئ الملف موردًا من نوع Instrumentation باسم elastic-instrumentation. يشير مُصدِّره إلى خدمة مجمّع daemon على المنفذ 4318 (OTLP HTTP). يتضمن المُمرِّر (propagator) الافتراضي tracecontext وbaggage وb3، وقد ضُبط أخذ العينات parentbased_traceidratio على 1.0، أي 100 % من التتبعات.

قسم instrumentation في ملف values.yaml: الاسم elastic-instrumentation ونقطة نهاية مجمّع daemon وصور وكلاء Java وNode.js و.NET وPython وGo

الصور المشار إليها هي وكلاء EDOT للغات Java وNode.js و.NET وPython، ووكيل الأدوات التلقائية من OpenTelemetry للغة Go. لتفعيل namespace، تعطي وثائق Elastic هذا الأمر، حيث تساوي <LANGUAGE> إحدى القيم nodejs أو java أو python أو dotnet أو go:

kubectl annotate namespace MON_NAMESPACE \
  instrumentation.opentelemetry.io/inject-<LANGUAGE>="opentelemetry-operator-system/elastic-instrumentation"

ثم يجب إعادة تشغيل الـ deployment. لا تذكر صفحة Elastic الأمر؛ وتشرح وثائق OpenTelemetry السبب: يُقيَّم الحقن عند بدء تشغيل الـ pod، ولذلك يجب إعادة إنشاء الـ pods الموجودة. يكفي kubectl rollout restart deployment/mon-app. ويجب أن يوجد المورد Instrumentation قبل الـ pod، وإلا لن يُنشأ الـ init container المسمى opentelemetry-auto-instrumentation.

حالة Go الخاصة

بحسب وثائق OpenTelemetry، تمر لغة Go عبر sidecar يعتمد eBPF، خلف الـ feature gate المسمى enable-go-instrumentation، ويعمل في الوضع المميّز (privileged). يفعّل ملف Elastic هذا الخيار في وسائط manager. زِن هذا القرار قبل تفعيله في بيئة الإنتاج.

كيف تتحقق من أن كل شيء يعمل

  1. kubectl get pods -n opentelemetry-operator-system: يجب أن تكون أداة Operator وdaemon ومجمّع العنقود وgateway قيد التشغيل. هذه أوامر Kubernetes قياسية، وليست خطوة من صفحة Elastic.
  2. بعد إعادة تشغيل تطبيق عليه التعليق التوضيحي، يجب أن يُظهر kubectl describe pod الـ init container الخاص بالأدوات التلقائية. وإذا غاب، فتحقق من التعليق التوضيحي واللغة ووجود المورد.
  3. في Kibana، يجب أن تمتلئ لوحات معلومات التكاملات.

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

أفضل الممارسات

  • لا تحتفظ بأخذ عينات بنسبة 100 % بدافع العادة في الإنتاج: الملف يضبطه على 1.0، وهذه نقطة انطلاق. يساعدك دليلنا حول tail sampling على اتخاذ القرار.
  • ضع قيمك تحت التحكم في الإصدارات وثبّت إصدار المخطط ووسم الملف.
  • حدّد حجم gateway: يتوقع الملف نسختين، وحدًّا للمعالج قدره 1500m وذاكرة 1500Mi. هذه قيم تجريبية من Elastic وليست توصيات لحمل عملك.
  • فعّل cert-manager في الإنتاج: يوصي الملف بذلك في تعليق، بدل الشهادة المولَّدة ذاتيًا.
  • أضف التعليق التوضيحي لكل namespace، بالتدريج، بدءًا بخدمة قليلة الحساسية.

الأسئلة الشائعة

ما هو EDOT Kubernetes؟

هو المجموعة المكوّنة من EDOT Collector من Elastic، منشورًا على هيئة daemon وcluster وgateway، ووكلاء EDOT للأدوات التلقائية، وكل ذلك مثبَّت بواسطة OpenTelemetry Operator. تنطلق البيانات بصيغة OTLP نحو Elasticsearch.

هل يتولى Operator تزويد جميع تطبيقاتي بالأدوات؟

لا. فهو يحقن الأدوات فقط في الـ pods التي عليها التعليق التوضيحي، وللغات المدعومة: Java وNode.js و.NET وPython وGo. أما اللغات الأخرى فتحيل وثائق Elastic إلى الإعداد اليدوي لحزم EDOT SDK.

هل يمكنني إرسال هذه البيانات إلى وجهة غير Elastic؟

يضبط ملف Elastic مُصدِّر Elasticsearch. تغيير الوجهة يستلزم تعديل إعداد gateway؛ ولا توثّق Elastic هذا البديل في الصفحات التي قُرئت، لذلك فهو غير متحقَّق منه هنا. راجع مقالاتنا حول الاختيار بين APM Server وEDOT Collector.

الخلاصة

يختزل Operator نشر EDOT Kubernetes في أمر helm install وتعليق توضيحي واحد، لكنه لا يحل محل قراراتك: أخذ العينات، والموارد، والأمان، ووجهة البيانات. جرّب على namespace تجريبي، وتحقق من الـ init containers ولوحات المعلومات، ثم وسّع النطاق.

المصادر

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لشركة Elastic N.V. Dynatrace علامة تجارية لشركة Dynatrace LLC. Elastic وElasticsearch وKibana علامات تجارية لأصحابها؛ المقتطفات مأخوذة من الوثائق والمستودع الرسميين، والقيم بين الأقواس المعقوفة تجريبية. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Composite monitor Datadog : combiner des monitors sans les dupliquer

composite monitor Datadog: دمج المراقبات دون تكرارها

Next Post
Elasticsearch frozen tier : coût réel des snapshots consultables

Elasticsearch frozen tier: الكلفة الفعلية للقطات القابلة للبحث

Related Posts