زمنية مقاييس OTLP إلى Dynatrace: delta أم cumulative، الخطأ الذي يُخفي عدّاداتك

زمنية مقاييس OTLP: شخّص العدّادات التراكمية التي يرفضها Dynatrace وانتقل إلى delta في SDK أو Collector، مع التحقق من وصول المقاييس.
Temporalité métriques OTLP vers Dynatrace : delta ou cumulative, l'erreur qui fait disparaître vos compteurs

تصل تتبعات OpenTelemetry إلى Dynatrace، وكذلك السجلات، لكن العدّادات لا تظهر. لا خطأ من جهة التطبيق، ولا شيء واضح في Collector. وفي معظم الحالات يكمن السبب في زمنية مقاييس OTLP (delta أم cumulative): يرسل التطبيق مجاميع تراكمية، بينما يتوقع Dynatrace قيم delta.

هدف هذا الدرس التطبيقي: فهم الفرق بين delta وcumulative في دقيقتين، ورصد المشكلة، ثم إصلاحها في SDK (Java أو Python أو Go) أو في Collector، والتحقق من وصول المقاييس. ينطبق المحتوى على Dynatrace SaaS وDynatrace Managed اللذين يعرضان واجهة OTLP نفسها.

إن كنت مبتدئًا في تصدير OTLP فابدأ بـ ضبط Collector الخاص بـ OpenTelemetry نحو Dynatrace.

زمنية مقاييس OTLP: delta أم cumulative

يتلقى عدّاد الطلبات 10 طلبات في الدقيقة. ويستطيع المصدّر (exporter) إرساله بطريقتين:

الدقيقة Cumulative Delta
1 10 10
2 20 10
3 30 10

في cumulative تحمل كل نقطة المجموع منذ بدء العملية. وفي delta تحمل الزيادة فقط منذ النقطة السابقة. تصدّر معظم حزم OpenTelemetry SDK بنمط cumulative افتراضيًا، وهو خيار صُمم لـ Prometheus. أما واجهة OTLP في Dynatrace فتتوقع العدّادات والمدرجات التكرارية (histograms) بنمط delta. والنقاط التراكمية المعنية لا تُستوعب.

المقاييس من نوع gauge لا زمنية لها وتمر دون تغيير. ويُقبل UpDownCounter في الزمنيتين: في delta يصبح عدّادًا، وفي cumulative يصبح gauge. أما المدرجات التكرارية التراكمية فتُرفض مثل العدّادات التراكمية. التفاصيل في وثائق استيعاب مقاييس OTLP (صفحة «About OTLP metrics ingest»).

المتطلبات

  • رمز API مميّز بالنطاق metrics.ingest.
  • نقطة OTLP في بيئتك (https://<env-id>.live.dynatrace.com/api/v2/otlp في SaaS، وhttps://<votre-domaine>/e/<env-id>/api/v2/otlp في Managed).
  • حزمة OpenTelemetry SDK حديثة، أو Collector من نوع contrib (فالمعالج المستخدم أدناه جزء من توزيعة contrib).

الخطوة 1 — تأكيد التشخيص

أضف مؤقتًا المصدّر debug إلى Collector لترى الزمنية المرسلة فعلًا:

exporters:
  debug:
    verbosity: detailed

service:
  pipelines:
    metrics:
      receivers: [otlp]
      exporters: [debug, otlphttp/dynatrace]

في سجلات Collector ابحث عن سطر AggregationTemporality الخاص بعدّاداتك. القيمة Cumulative تؤكد المشكلة. وبدون Collector قد تشير استجابة واجهة OTLP إلى نقاط مرفوضة (استجابة نجاح جزئي): فعّل سجلات المصدّر في SDK لتراها.

الخطوة 2 — الإصلاح في SDK

Java وPython و.NET وNode.js: متغير بيئة

export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta

هذا المتغير جزء من مواصفات OpenTelemetry، وتقرؤه حزم SDK لـ Java (ووكيل Java) وPython و.NET وNode.js. تحقق من دعمه في إصدار SDK الذي تستخدمه. وفي Java هو مدرج أصلًا في إعداد وكيل OpenTelemetry لـ Java.

Java: في الشيفرة، إن كنت تبني المصدّر بنفسك

import io.opentelemetry.exporter.otlp.http.metrics.OtlpHttpMetricExporter;
import io.opentelemetry.sdk.metrics.export.AggregationTemporalitySelector;

OtlpHttpMetricExporter exporter = OtlpHttpMetricExporter.builder()
    .setEndpoint("https://abc12345.live.dynatrace.com/api/v2/otlp/v1/metrics")
    .addHeader("Authorization", "Api-Token " + System.getenv("DT_API_TOKEN"))
    .setAggregationTemporalitySelector(AggregationTemporalitySelector.deltaPreferred())
    .build();

السطر الحرج: deltaPreferred() ينقل العدّادات والمدرجات التكرارية إلى delta. لاحظ أن العنوان الكامل مع /v1/metrics مطلوب حين يُضبط المصدّر في الشيفرة.

Go: محدِّد زمنية

تقرأ مصدّرات OTLP للمقاييس في Go الحديثة هذا المتغير أيضًا، لكن الإصدارات الأقدم تتجاهله. ولسلوك صريح أيًّا كان الإصدار، صرّح بالمحدِّد:

import (
    "context"

    "go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp"
    sdkmetric "go.opentelemetry.io/otel/sdk/metric"
    "go.opentelemetry.io/otel/sdk/metric/metricdata"
)

exp, err := otlpmetrichttp.New(ctx,
    otlpmetrichttp.WithTemporalitySelector(
        func(sdkmetric.InstrumentKind) metricdata.Temporality {
            return metricdata.DeltaTemporality
        }),
)

يفرض هذا المثال delta على كل الأدوات. وبالنسبة إلى UpDownCounter، يجعله delta يظهر كعدّاد؛ وإن فضلت gauge (القيمة الحالية) فاتركه cumulative في المحدِّد.

الخطوة 3 — أو الإصلاح في Collector

حين لا تتحكم في التطبيقات (مكتبات خارجية أو مستقبِل Prometheus)، حوّل في Collector بالمعالج cumulative_to_delta:

processors:
  cumulative_to_delta: {}
  batch: {}

exporters:
  otlphttp/dynatrace:
    endpoint: https://abc12345.live.dynatrace.com/api/v2/otlp
    headers:
      Authorization: "Api-Token ${env:DT_API_TOKEN}"

service:
  pipelines:
    metrics:
      receivers: [otlp, prometheus]
      processors: [cumulative_to_delta, batch]
      exporters: [otlphttp/dynatrace]

الأسطر الحرجة: cumulative_to_delta (الاسم الجديد للمعالج القديم cumulativetodelta الذي بقي اسمًا بديلًا مهجورًا) يحتفظ بحالة. فهو يخزّن آخر قيمة لكل سلسلة في الذاكرة. والنتائج:

  • يجب أن تمر كل بيانات السلسلة الواحدة عبر نسخة Collector نفسها (دون توزيع عشوائي بين عدة نسخ)؛
  • بعد إعادة التشغيل تُستخدم أول نقطة في سلسلة موجودة أصلًا مرجعًا ولا تُصدَّر (السلوك الافتراضي initial_value: auto)؛
  • تنمو الذاكرة مع عدد السلاسل: راقب الكاردينالية (cardinality).

ضع المعالج قبل batch، كما في المثال أعلاه.

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

  1. في سجلات المصدّر debug تظهر الزمنية الآن Delta. ثم أزل المصدّر debug.
  2. في Dynatrace SaaS افتح Notebook ونفّذ (استبدل باسم مقياسك):
timeseries requetes = sum(http.server.request.count), interval: 1m
| fieldsAdd total = arraySum(requetes)

يجب أن يكون المنحنى مسطحًا لحركة ثابتة (10 في الدقيقة في مثالنا)، لا منحدرًا يرتفع بلا نهاية. فالمنحدر يدل على قيمة تراكمية فُسرت كأنها delta. وقد يختلف اسم المقياس في Dynatrace قليلًا عن اسمه في OpenTelemetry: ابحث عنه في قائمة المقاييس. وفي Managed استخدم مستكشف البيانات مع التحقق البصري نفسه.

استكشاف الأخطاء وإصلاحها

  • ما زال لا شيء بعد التحول إلى delta: تحقق من نطاق الرمز metrics.ingest وعنوان النقطة (يدل 404 غالبًا على /v1/metrics مكرر أو مفقود).
  • قمم معزولة بعد كل إعادة تشغيل: المعالج cumulative_to_delta الموضوع خلف موازن حمل (load balancer) يتلقى نقاط السلسلة الواحدة على عدة نسخ. وجّه بحسب السلسلة أو أصلح في SDK.
  • يصل جزء فقط من المقاييس: بعض الأدوات تبقى تراكمية، مثل المدرجات التكرارية، فتُرفض (أما UpDownCounter التراكمي فيصل كـ gauge). قارن خرج المصدّر debug أداة بأداة.
  • قيم مضاعفة: المقياس نفسه ينطلق من SDK مباشرة وعبر Collector معًا. أبقِ مسار تصدير واحدًا.

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

  • أصلح أقرب ما يمكن إلى المصدر: SDK بنمط delta يجنّبك حالة Collector.
  • أبقِ الزمنية نفسها لجميع تطبيقات المنصة، ووثّقها في معاييرك.
  • لـ SLO زمن الاستجابة أرسل مدرجات تكرارية بنمط delta: راجع مقاييس المدرجات التكرارية مع OpenPipeline.
  • المقياس الذي يضيع بصمت هو SLI أعمى: أضف تنبيهًا على غياب البيانات للمقاييس الحرجة.

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

لماذا يفضّل Dynatrace نمط delta؟

لأن delta بلا حالة من جهة الاستقبال: كل نقطة تكفي نفسها، أيًّا كان عدد النسخ المرسِلة. ولا حاجة إلى تتبع إعادة تشغيل كل عملية.

مقاييس Prometheus لدي تراكمية: ماذا أفعل؟

اجمعها بمستقبِل Prometheus في Collector، ثم طبّق cumulative_to_delta كما في الخطوة 3.

هل مقاييس gauge معنية؟

لا. تمثل gauge قيمة لحظية (الذاكرة المستخدمة، طول الطابور) ولا زمنية تجميع لها.

الخلاصة

تُضبط زمنية مقاييس OTLP بسطر واحد، لكن نسيانها يُخفي عدّادات كاملة. تحقق من الزمنية بمصدّر debug، وحوّل SDK إلى delta أو حوّل في Collector، ثم افحص شكل المنحنيات. فتقوم SLI لديك على أرقام كاملة.

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
Agent OpenTelemetry Java : instrumenter une application et l'envoyer à Dynatrace

وكيل OpenTelemetry لـ Java: قِس تطبيقك وأرسل بياناته إلى Dynatrace

Next Post
Collector OpenTelemetry Kubernetes vers Dynatrace : Helm, Operator et k8sattributes

Collector الخاص بـ OpenTelemetry على Kubernetes إلى Dynatrace: Helm وOperator وk8sattributes

Related Posts