Prometheus Dynatrace: جمع مقاييس Prometheus على Kubernetes

Prometheus Dynatrace على Kubernetes: تعليقات Pods يقرؤها ActiveGate أو OTel Collector، وتصفية الحجم عند المصدر، ثم التحقق بـ DQL خطوة بخطوة.
Prometheus Dynatrace : récupérer des métriques Prometheus sur Kubernetes

تعرض فرقك أصلًا مقاييس بصيغة Prometheus: مُصدِّر (exporter) لـ Redis، ونقطة /metrics في كل خدمة مصغّرة، ومقاييس الـ ingress. تجاهلها يعني التخلي عن مؤشرات SLI جاهزة. وربط Prometheus Dynatrace بعنقود Kubernetes يُدخلها إلى المنصة نفسها التي فيها التتبعات والسجلات، دون إعادة كتابة سطر برمجي واحد.

من زاوية SRE الأمر بسيط: هدف مستوى الخدمة (SLO) لزمن الاستجابة المحسوب على مدرّج تكراري (histogram) من Prometheus لا قيمة له إلا إذا ارتبط بالنشر والـ Pod والتتبع الذي يفسّره. وإلا ربطت المناوبة (on-call) ذلك يدويًا، فيطول زمن الاستعادة (MTTR).

هدف هذا الدرس التطبيقي جمع مقاييس Prometheus في Dynatrace بطريقتين: تعليقات (annotations) على الـ Pods يقرؤها ActiveGate، ثم OpenTelemetry Collector، مع التحقق من الاستيعاب. المحتوى صالح لـ Dynatrace SaaS وDynatrace Managed، وتُشار الفروق عند وجودها.

طريقتان لتطبيق Prometheus Dynatrace على Kubernetes

الطريقة متى تختارها القيود
تعليقات metrics.dynatrace.com/* يقرؤها ActiveGate عنقود تراقبه Dynatrace Operator أصلًا وعدد قليل من المُصدِّرات سقوف موثّقة: 1000 Pod مُصدِّر و1000 مقياس لكل Pod
OpenTelemetry Collector مع المستقبِل prometheus نشر جديد أو عنقود كبير أو حاجة إلى التصفية والإثراء مكوّن إضافي يجب تشغيله ومراقبته

توصي الوثائق الآن باستخدام Collector في عمليات النشر الجديدة وفي أي عنقود يقترب من سقوف ActiveGate. ويمكن للطريقتين التعايش أثناء الترحيل، شرط ألا يُجمع المقياس من الـ Pod نفسه مرتين.

المتطلبات المسبقة

  • عنقود Kubernetes والأداة kubectl بصلاحيات الإدارة.
  • الطريقة 1: Dynatrace Operator منشورة مع ActiveGate داخل العنقود؛ انظر ربط Dynatrace Operator بعنقود.
  • الطريقة 2: رمز API مميّز (API token) بنطاق استيعاب المقاييس (metrics.ingest) محفوظ في سرّ (secret) داخل Kubernetes.
  • مُصدِّر يستجيب أصلًا: يجب أن يعيد curl http://<pod-ip>:9121/metrics نصًا.

الطريقة 1: تعليقات يقرؤها ActiveGate

الخطوة 1: تفعيل الجمع

في إعدادات مراقبة عنقود Kubernetes داخل Dynatrace، فعّل مراقبة الـ namespaces والخدمات والأحمال (workloads) والـ Pods، ثم خيار مراقبة مُصدِّرات Prometheus المعلَّمة بتعليقات. بدون هذا الإعداد تُهمَل التعليقات.

الخطوة 2: وضع التعليقات على Pod المُصدِّر

apiVersion: apps/v1
kind: Deployment
metadata:
  name: redis-exporter
spec:
  selector:
    matchLabels: { app: redis-exporter }
  template:
    metadata:
      labels: { app: redis-exporter }
      annotations:
        metrics.dynatrace.com/scrape: "true"
        metrics.dynatrace.com/port: "9121"
        metrics.dynatrace.com/path: "/metrics"
        metrics.dynatrace.com/filter: |
          {
            "mode": "include",
            "names": ["redis_up", "redis_connected_clients", "redis_db_keys"]
          }
    spec:
      containers:
      - name: exporter
        image: oliver006/redis_exporter:v1.62.0
        ports:
        - containerPort: 9121

الأسطر الحرجة: تُوضع التعليقات على قالب الـ Pod (template) لا على الـ Deployment نفسه. القيمة port مطلوبة، وpath قيمتها الافتراضية /metrics. أما filter بالوضع include فهو حارس الحجم: يعرض المُصدِّر غالبًا مئات السلاسل لا يفيد منها إلا ثلاث.

إذا كانت NetworkPolicy تحمي الـ namespace، فاسمح بالحركة القادمة من Pod الخاص بـ ActiveGate في الـ namespace المسمى dynatrace. وهذا السبب الأول لغياب المقاييس.

الطريقة 2: OpenTelemetry Collector يجمع المقاييس

الخطوة 1: السرّ

kubectl create namespace otel
kubectl -n otel create secret generic dynatrace-otelcol-dt-api-credentials \
  --from-literal=DT_ENDPOINT=https://<environment-id>.live.dynatrace.com/api/v2/otlp \
  --from-literal=DT_API_TOKEN=<token-metrics-ingest>

في Managed تمر نقطة OTLP عبر ActiveGate: https://<activegate>:9999/e/<environment-id>/api/v2/otlp.

الخطوة 2: إعداد Collector

receivers:
  prometheus:
    config:
      scrape_configs:
      - job_name: redis-exporter
        scrape_interval: 60s
        kubernetes_sd_configs:
        - role: pod
        relabel_configs:
        - source_labels: [__meta_kubernetes_pod_label_app]
          action: keep
          regex: redis-exporter
        - source_labels: [__meta_kubernetes_namespace]
          target_label: k8s_namespace_name

processors:
  cumulative_to_delta:
    max_staleness: 25h

exporters:
  otlp_http:
    endpoint: ${env:DT_ENDPOINT}
    headers:
      Authorization: "Api-Token ${env:DT_API_TOKEN}"

service:
  pipelines:
    metrics:
      receivers: [prometheus]
      processors: [cumulative_to_delta]
      exporters: [otlp_http]

سبب استخدام cumulative_to_delta: عدّادات Prometheus تراكمية، بينما تتوقع Dynatrace بيانات OTLP بنمط الفرق (delta temporality). وبدون هذا المعالج تُرفض العدّادات. والتفاصيل في نمط الزمن في مقاييس OTLP. وتضيف وثائق Dynatrace أيضًا المعالج metric_start_time مع توزيعتها الخاصة من Collector (الإصدار v0.41.0 أو أحدث)؛ وبحسب الصورة التي تستخدمها، تبقى الأسماء القديمة otlphttp وcumulativetodelta مقبولة كأسماء بديلة.

يحتاج المستقبِل prometheus مع kubernetes_sd_configs إلى ServiceAccount مخوَّل بسرد الـ Pods (get وlist وwatch). ولنشر Collector نفسه (Helm وRBAC والموارد) اتبع درسنا OpenTelemetry Collector على Kubernetes. وفي العناقيد الكبيرة يصبح Collector واحد عنق زجاجة: يوزّع Target Allocator في مشغّل OpenTelemetry الأهداف بين عدة نسخ.

كيف تتحقق من أن الإعداد يعمل

للطريقة 2، اقرأ أولًا سجلات Collector:

kubectl -n otel logs deploy/otel-collector | grep -iE "error|scrape|refused"

يجب ألا يظهر أي سطر 401 أو 403، وإلا فراجع نطاق الرمز المميّز. كما يعرض Collector مقاييسه الخاصة: يجب أن يتزايد otelcol_receiver_accepted_metric_points.

في Dynatrace SaaS افتح Notebook واعرض أحد مقاييس المُصدِّر:

timeseries clients = avg(redis_connected_clients)

إن لم يظهر المفتاح بهذا الاسم، فابحث عن «redis» في مستكشف المقاييس: بحسب طريقة الاستيعاب ونوع المقياس، قد تضيف Dynatrace لاحقة إلى المفتاح (وهذا موثّق للعدّادات والمدرّجات التكرارية والملخّصات summaries). وفي Managed استخدم مستكشف البيانات (Data Explorer) بالبحث نفسه.

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

  • صفِّ عند المصدر: قائمة include في الطريقة 1، وفي الطريقة 2 استخدم metric_relabel_configs أو المعالج filter.
  • أبقِ فاصل الجمع عند 60 ثانية ما لم تكن هناك حاجة محددة: تقسيم الفاصل على أربعة يضاعف الحجم أربع مرات.
  • لا تجمع مقاييس Pod بالطريقتين معًا أبدًا: ستتضاعف السلاسل وتتشوّه أهداف SLO.
  • لأهداف SLO الخاصة بزمن الاستجابة، استوعب المدرّجات التكرارية واقرأ مقاييس المدرّجات التكرارية مع OpenPipeline.
  • راقب Collector نفسه: جمع يفشل بصمت يشبه خدمة بلا حركة مرور.

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

هل يلزم الإبقاء على خادم Prometheus؟

لا، فلا تحتاج الطريقتان إليه: يجمع ActiveGate أو Collector البيانات مباشرة من المُصدِّرات. وإذا أبقيت Prometheus لأغراض أخرى، فتجنب تكرار السلاسل نفسها في الأداتين دون سبب.

هل تعمل التعليقات مع Dynatrace Managed؟

نعم، فطريقة التعليقات تعتمد على ActiveGate ووحدة Kubernetes الموجودتين في Managed كما في SaaS. وخيارات مصادقة العميل (الشهادات والأسرار) تتطلب ActiveGate منشورًا داخل العنقود المراقَب.

تعرض عدّاداتي قيمًا غريبة، لماذا؟

تخزّن Dynatrace عدّادات Prometheus بنمط الفرق (delta): ترى الزيادة بين جمعين متتاليين لا القيمة الخام للعدّاد. وهذا متوقع. أما من جهة Collector، فعدّاد يُعاد تشغيله دون ضبط cumulative_to_delta بشكل صحيح يُنتج فجوات.

الخلاصة

لبضعة مُصدِّرات على عنقود مزوّد أصلًا بـ Dynatrace Operator تكفي التعليقات. ولعنقود جديد أو أحجام كبيرة، يمنح OpenTelemetry Collector مع المستقبِل prometheus تحكمًا أكبر. وفي الحالتين: صفِّ مبكرًا، وتحقق من السجلات ثم بـ DQL، واربط مؤشرات SLI بأهداف SLO القائمة. والمرجع في docs.dynatrace.com، وللمستقبِل في opentelemetry.io.

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

Total
0
Shares
Leave a Reply

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

Previous Post
Extension Dynatrace base de données : superviser PostgreSQL ou Oracle avec Extensions 2.0

إضافة Dynatrace لقواعد البيانات: مراقبة PostgreSQL أو Oracle باستخدام Extensions 2.0

Next Post
Monitoring synthétique Dynatrace : tutoriel HTTP et navigateur, API, coût et emplacements

المراقبة الاصطناعية في Dynatrace: درس HTTP والمتصفح وAPI والتكلفة والمواقع

Related Posts