يعمل عنقود Kubernetes لديك مع Istio: يمر كل طلب عبر وكيل (proxy) من نوع Envoy يعرف زمن استجابته ورمز ردّه ووجهته. ومع ذلك، أثناء حادثة، يفتح الفريق Dynatrace فلا يرى إلا جزءًا من المسار. ويستحق الثنائي Istio Dynatrace أفضل من ذلك: هذه البيانات موجودة أصلًا داخل الـ mesh، ويكفي أن توصلها.
كثيرًا ما تكون شبكة الخدمات (service mesh) أول مكان يظهر فيه التدهور: إعادات محاولة متتالية، ورفض mTLS، وانتهاء مهلة sidecar. وبدون تتبعاتها ومقاييسها يقوم التشخيص على التخمين ويطول زمن الاستعادة (MTTR).
هدف هذا الدرس التطبيقي إرسال spans الخاصة بوكلاء Envoy عبر OTLP إلى Dynatrace من خلال OpenTelemetry Collector، وجمع المقاييس القياسية لـ Istio، ثم التحقق من كل ذلك بـ DQL. المحتوى صالح لـ Dynatrace SaaS وDynatrace Managed (استيعاب OTLP في Managed بحسب إصدارك؛ أما استعلامات DQL فتفترض Grail، أي SaaS).
Istio Dynatrace: ما الذي يمكن أن تقدمه شبكة الخدمات
| الإشارة | المصدر في Istio | المسار إلى Dynatrace |
|---|---|---|
| التتبعات (spans الخاصة بالوكيل) | Envoy، عبر مزوّد OpenTelemetry معلَن في إعداد الـ mesh | OTLP إلى Collector، ثم إلى واجهة OTLP في Dynatrace |
| المقاييس | نقطة Prometheus في الـ sidecars (istio_requests_total وistio_request_duration_milliseconds …) |
جمع بواسطة Collector أو Dynatrace Operator (عبر annotations) |
| سجلات الوصول | سجلات الوصول (access logs) في Envoy | جمع السجلات المعتاد (OneAgent أو Fluent Bit) |
تذكير مهم: لا تكفي spans الوكلاء لإعادة بناء تتبع كامل. يجب أن ينقل كل تطبيق ترويسات السياق (traceparent) من الطلب الوارد إلى استدعاءاته الصادرة، وإلا صارت كل قفزة تتبعًا منعزلًا.
المتطلبات المسبقة
- Istio مثبّت بالأداة
istioctl(واجهةtelemetry.istio.io/v1متاحة في الإصدارات الحديثة). - OpenTelemetry Collector في الـ namespace المسمى
observability، يعرض OTLP gRPC على المنفذ 4317، كما في نشر Collector على Kubernetes. - رمز API مميّز (API token) في Dynatrace بالنطاقين
openTelemetryTrace.ingestوmetrics.ingest، محفوظ في سرّ (secret). - تطبيقات تنقل سياق W3C (قياس برمجي بـ OpenTelemetry أو OneAgent).
الخطوة 1: إعلان Collector مزوّدًا للتتبعات
أضف مزوّد امتداد OpenTelemetry في إعداد الـ mesh:
cat <<EOF | istioctl install -y -f -
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
meshConfig:
enableTracing: true
extensionProviders:
- name: otel-tracing
opentelemetry:
port: 4317
service: otel-collector.observability.svc.cluster.local
EOF
الاسم otel-tracing اختياري، وسيُشار إليه في الخطوة التالية. ويجب أن يطابق الحقل service اسم DNS لخدمة Collector تمامًا.
الخطوة 2: تفعيل التتبع بواجهة Telemetry
يفعّل المورد Telemetry في الـ namespace الجذر لـ Istio المزوّد على الـ mesh كله:
apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
name: mesh-tracing
namespace: istio-system
spec:
tracing:
- providers:
- name: otel-tracing
randomSamplingPercentage: 10
يحدد randomSamplingPercentage نسبة الطلبات التي يتتبعها الوكيل. ابدأ بنسبة منخفضة في الإنتاج (من 1 إلى 10%) ثم عدّل بحسب الحجم. وإذا كانت التطبيقات تقرر أخذ العيّنات (sampling) أصلًا، فإن الوكيل يحترم القرار الذي تحمله الترويسة الواردة. ولأخذ عيّنات أدق، أبقِ القرار في Collector (انظر tail sampling).
الخطوة 3: التصدير إلى Dynatrace من Collector
في إعداد Collector أضف مُصدِّر OTLP HTTP الخاص بـ Dynatrace ومستقبِل Prometheus يجمع من الـ sidecars:
receivers:
otlp:
protocols:
grpc:
endpoint: 0.0.0.0:4317
prometheus:
config:
scrape_configs:
- job_name: istio-sidecars
scrape_interval: 30s
metrics_path: /stats/prometheus
kubernetes_sd_configs:
- role: pod
relabel_configs:
- source_labels: [__meta_kubernetes_pod_container_name]
regex: istio-proxy
action: keep
- source_labels: [__address__]
regex: ([^:]+)(?::\d+)?
replacement: $$1:15090
target_label: __address__
processors:
batch: {}
cumulativetodelta: {}
exporters:
otlphttp/dynatrace:
endpoint: https://${env:DT_ENV_ID}.live.dynatrace.com/api/v2/otlp
headers:
Authorization: "Api-Token ${env:DT_API_TOKEN}"
service:
pipelines:
traces:
receivers: [otlp]
processors: [batch]
exporters: [otlphttp/dynatrace]
metrics:
receivers: [prometheus]
processors: [cumulativetodelta, batch]
exporters: [otlphttp/dynatrace]
الأسطر الحرجة: يعرض المنفذ 15090 إحصاءات Envoy بصيغة Prometheus؛ والرمز $$ يهرّب الرمز $ في إعداد Collector؛ والمعالج cumulativetodelta ضروري لأن Dynatrace تتوقع عدّادات بنمط الفرق (delta) عبر OTLP. وفي Managed تصبح النقطة https://<domaine>/e/<env-id>/api/v2/otlp. ويجب أن يملك حساب الخدمة (service account) الخاص بـ Collector صلاحية سرد الـ Pods.
وإذا فضّلت أن يجمع Dynatrace Operator المقاييس بنفسه، فاستخدم التعليقات metrics.dynatrace.com/* الموصوفة في جمع مقاييس Prometheus على Kubernetes. ولا تجمع الطريقتين على الـ Pods نفسها، وإلا حُسبت المقاييس مرتين.
كيف تتحقق من أن الإعداد يعمل
- ولّد حركة مرور ثم اقرأ سجلات Collector: يجب ألا يعيد الأمر
kubectl -n observability logs deploy/otel-collector | grep -iE "error|refused"أي شيء. - تحقق من وجود spans الوكلاء:
fetch spans, from: -15m | filter isNotNull(istio.canonical_service) | summarize spans = count(), by: { istio.canonical_service } | sort spans descإن حمل الوسم اسمًا آخر في إصدارك، فافحص span خامًا بـ
fetch spans | limit 5. - راقب مقاييس الـ mesh موزعة بحسب الخدمة ورمز الرد:
timeseries requêtes = sum(istio_requests_total), by: { destination_service, response_code }, from: -1hنسبة السلاسل ذات الرمز
5xxإلى المجموع تعطي مؤشر SLI لمعدل الأخطاء لكل خدمة. كيّف مفتاح المقياس مع الاسم الذي تراه في متصفح المقاييس: بحسب مسار الاستيعاب قد تُضاف لاحقة.
أفضل الممارسات
- ابنِ أهداف SLO على مقاييس الـ mesh من جهة الخادم (
reporter="destination") لتجنب عدّ كل طلب مرتين. - قيّد عدد القيم المميزة (cardinality): استبعد الوسوم غير المفيدة قبل التصدير بدل تخزين ملايين السلاسل.
- أبقِ معدل أخذ العيّنات معروفًا وموثّقًا؛ فالتغيير غير المعلَن يشوّه المقارنات من أسبوع إلى آخر.
- راقب Collector نفسه: إن توقف، صمتت شبكة الخدمات.
الأسئلة الشائعة
ألا يكفي OneAgent دون إعداد Istio؟
ينفّذ OneAgent القياس البرمجي لعمليات التطبيق داخل الـ Pods وينشر سياقه الخاص؛ فيرى استدعاءات الخدمة إلى الخدمة. وتضيف spans ومقاييس Envoy رؤية الوكيل (إعادات المحاولة وmTLS ومهلات الـ sidecar). ويعتمد مستوى الدعم الأصلي لـ Envoy على الإصدار: راجع الوثائق قبل تكرار الإشارات.
لماذا تنقطع تتبعاتي عند كل قفزة؟
في الغالب لأن تطبيقًا لا ينقل traceparent من الاستدعاء الوارد إلى الصادر. ينشئ الوكيل spans الخاصة به فعلًا، لكنه لا يستطيع ربط طلبين لم يربطهما التطبيق.
هل تعمل هذه الخطوات في الوضع ambient؟
يستبدل الوضع ambient الـ sidecars بـ ztunnel ووكلاء waypoint؛ وتختلف المنافذ ومصادر المقاييس. يبقى المبدأ (مزوّد OpenTelemetry وCollector وتصدير OTLP) صحيحًا، لكن كيّف الجمع مع هذه البنية.
الخلاصة
مزوّد OpenTelemetry في إعداد الـ mesh، ومورد Telemetry، وCollector يجمع من الـ sidecars ويصدّر عبر OTLP: هكذا تصبح شبكة الخدمات Istio مرئية في Dynatrace، بمؤشرات SLI مبنية على كل طلب. وستُقرأ سلسلة إعادات المحاولة القادمة في تتبع، لا في تخمين.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تتغير الخيارات والسمات، لذا تحقق منها في وثائق Istio وفي وثائق Dynatrace. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.