Grafana Alloy: المُجمِّع وما يستبدله وكيفية الترحيل إليه

Grafana Alloy: ما يستبدله هذا المُجمِّع (Grafana Agent وPromtail)، وكيف تنتقل إليه بالأمر alloy convert وترسل بيانات OTLP إلى Dynatrace SaaS.
Grafana Alloy : le collecteur, ce qu'il remplace et comment migrer

Grafana Alloy مُجمِّع (collector) مفتوح المصدر للقياس عن بُعد، تقدّمه Grafana Labs على أنه توزيعة من OpenTelemetry Collector مع مسارات (pipelines) Prometheus مدمجة ودعم أصلي لـ Loki وPyroscope. بالنسبة لمهندس SRE أو فريق المنصة، السؤال العملي بسيط: ماذا يستبدل Grafana Alloy في بيئتك، وما الذي يبقى عليك فعله بجانبه؟

تجيب هذه المقالة عن هذا السؤال انطلاقًا من الوثائق الرسمية: ما الذي يستبدله Alloy (Grafana Agent وPromtail، وأحيانًا OpenTelemetry Collector أو وكيل Prometheus)، وكيف تُبنى الإعدادات، وكيف يتم الترحيل، وكيف تُرسل بيانات OTLP إلى Dynatrace. وهي تكمّل مقارنة Dynatrace وGrafana التي تقارن بين منصات، بينما Alloy مكوّن للتجميع.

أمثلة الإرسال إلى Dynatrace صالحة لـ Dynatrace SaaS: فالصفحات التي قُرئت تصف عنوان live.dynatrace.com. أما حالة Dynatrace Managed فلم يتم التحقق منها هنا.

باختصار

  • يُوزَّع Grafana Alloy بترخيص Apache-2.0 (مستودع GitHub grafana/alloy) ويغطي المقاييس والسجلات والتتبعات والملفات التعريفية (profiles).
  • بحسب وثائق Loki، بلغت Grafana Agent Static وFlow وOperator نهاية عمرها في 1 نوفمبر 2025؛ وبحسب وثائق Alloy، تبلغها Promtail في 2 مارس 2026.
  • لا يستبدل Alloy نظامًا خلفيًا (back-end): فهو يجمع ويحوّل ويرسل.
  • يتحدث بروتوكول OTLP، فيمكنه تغذية Dynatrace، دون أن يكون ذلك تكاملًا مخصصًا.

Grafana Alloy: ما هو هذا المُجمِّع

يصف المستودع Alloy بأنه توزيعة من OpenTelemetry Collector مع مسارات قابلة للبرمجة. ويوضح ملف README أنه يدعم عشرات المكوّنات من Collector، إضافة إلى مكوّنات خاصة بـ Alloy. وتضيف الوثائق أن أداة واحدة يمكنها أن تحلّ محل مُجمِّع منفصل لكل نوع إشارة، مما يقلل عبء التشغيل، وأنها ترسل إلى أي نظام خلفي متوافق.

النموذج قائم على المكوّنات. يؤدي كل مكوّن مهمة واحدة: الاستقبال أو التحويل أو الإرسال. ويربط ملف إعداد بينها، فيصبح خرج أحدها دخل التالي. ثم ينفّذ Alloy المجموعة كلها كمسار متواصل. وتتكرر ثلاث عائلات:

  • prometheus.*: جمع المقاييس بتنسيق Prometheus وإرسالها؛
  • loki.*: قراءة السجلات وإرسالها؛
  • otelcol.*: المستقبِلات والمعالِجات والمصدِّرات القادمة من منظومة OpenTelemetry.

يتضمن Alloy أيضًا واجهة ويب. بحسب صفحة استكشاف الأخطاء، تستمع افتراضيًا على http://localhost:12345 وتعرض قائمة المكوّنات مع حالة سلامتها ووسائطها المقيَّمة ومخرجاتها (exports). وفي التثبيت خارج الحاويات، لا يصل إليها افتراضيًا سوى الجهاز المحلي.

ما الذي يستبدله Grafana Alloy وما الذي لا يستبدله

تقدّم الوثائق أدلة ترحيل من Grafana Agent (وضعا Static وFlow، وكذلك Operator) ومن Promtail وPrometheus وOpenTelemetry Collector. وهذا هو جدول القراءة الأكثر فائدة.

الأداة الحالية الوضع دور Alloy
Grafana Agent (Static وFlow وOperator) نهاية العمر في 1 نوفمبر 2025، بحسب وثائق Loki الخليفة المحدد في أدلة الترحيل
Promtail نهاية العمر في 2 مارس 2026، بحسب وثائق Alloy البديل، مع تحويل الإعدادات
وكيل Prometheus دليل ترحيل متاح الجمع عبر prometheus.scrape
OpenTelemetry Collector دليل ترحيل متاح العائلة نفسها من المكوّنات، مع مسارات Grafana
نظام خلفي (Prometheus وLoki وDynatrace…) خارج النطاق لا شيء: Alloy لا يخزّن

يلزم تنبيهان. أولًا، الصفحة الرئيسية لوثائق Alloy لا تقول حرفيًا «Alloy يستبدل Agent»؛ بل تثبت ذلك أدلة الترحيل وصفحة Loki. ثانيًا، Alloy توزيعة: إذا كانت حاجتك تقتصر على OTLP نحو نظام خلفي من جهة ثالثة، فإن OpenTelemetry Collector القياسي، مثل الذي تصفه مقالتنا عن OpenTelemetry Collector على Kubernetes، يظل خيارًا مشروعًا. ويصبح Alloy مفيدًا عندما تجمع البيئة بين مقاييس Prometheus وسجلات Loki وOTLP.

كتابة أول إعداد Alloy لـ Dynatrace

لإرسال قياسات OTLP إلى Dynatrace SaaS، تذكر وثائق Dynatrace عنوانًا أساسيًا https://{id-environnement}.live.dynatrace.com/api/v2/otlp يُضاف إليه /v1/traces أو /v1/metrics أو /v1/logs. وتستخدم المصادقة رمز منصة (platform token) في ترويسة Authorization بالمخطط Bearer. والنطاقات (scopes) المذكورة هي openpipeline:logs:ingest وopenpipeline:metrics:ingest وopenpipeline:traces:ingest.

النقطة المهمة لـ Alloy: تحدد الصفحة نفسها أن gRPC غير مدعوم وأن المطلوب هو protobuf الثنائي. فالمصدِّر المناسب إذن هو otelcol.exporter.otlphttp، الذي تقبل كتلته client الوسيطين endpoint وheaders. أما المستقبِل فيمكنه قبول gRPC وHTTP من جهة التطبيقات (المنفذان 4317 و4318 افتراضيًا): ويتولى Alloy التحويل إلى HTTP.

إعداد Alloy: المستقبِل otelcol.receiver.otlp والمعالِج batch والمصدِّر otelcol.exporter.otlphttp مع ترويسة Authorization Bearer مقروءة من متغير بيئة
otelcol.receiver.otlp "default" {
  http {}
  grpc {}

  output {
    metrics = [otelcol.processor.batch.default.input]
    logs    = [otelcol.processor.batch.default.input]
    traces  = [otelcol.processor.batch.default.input]
  }
}

otelcol.processor.batch "default" {
  output {
    metrics = [otelcol.exporter.otlphttp.dynatrace.input]
    logs    = [otelcol.exporter.otlphttp.dynatrace.input]
    traces  = [otelcol.exporter.otlphttp.dynatrace.input]
  }
}

otelcol.exporter.otlphttp "dynatrace" {
  client {
    endpoint = sys.env("DT_ENDPOINT")
    headers  = { "Authorization" = "Bearer " + sys.env("DT_PLATFORM_TOKEN") }
  }
}

يجمع هذا الإعداد ثلاثة أمثلة من وثائق Alloy (المستقبِل والدُّفعة والمصدِّر) مع الترويسة التي تصفها Dynatrace. ولم يُنفَّذ على بيئة Dynatrace من أجل هذه المقالة: اختبره في بيئة غير حرجة.

الأسطر الحرجة

  1. الكتلة output إلزامية في المستقبِل. بحسب الوثائق، إذا بقيت القوائم metrics وlogs وtraces فارغة، فإن القياسات تُهمَل.
  2. الأسرار تأتي من البيئة عبر sys.env. يدمج المعامل + السلاسل النصية، مما يتيح بناء القيمة Bearer … دون كتابة الرمز في الملف.
  3. لا gRPC نحو Dynatrace: لا تخلط بين المصدِّر otlp (gRPC) وotlphttp.

الترحيل من Grafana Agent أو Promtail باستخدام alloy convert

يوفّر Alloy أمر تحويل. بحسب أدلة الترحيل، تكون قيمة --source-format إما promtail أو static، ويحدد --output ملف Alloy الناتج، ويكتب --report تقرير تشخيص. وبدون تقرير، تخرج أخطاء التحويل على stderr.

أوامر alloy convert من الوثائق: تحويل إعداد Promtail، ثم إعداد Grafana Agent Static، ثم مع تقرير تشخيص

ويشير الدليل أيضًا إلى خيارين يجب التعامل معهما بحذر. فالخيار --bypass-errors ينتج تحويلًا «بأفضل جهد» قد يختلف سلوكه عن الأصل. والأمر run --config.format=… مع --config.bypass-conversion-errors يشغّل Alloy رغم أخطاء غير حرجة، وهو ما تنصح الوثائق بتجنبه في بيئة الإنتاج.

  1. احتفظ بنسخة من الإعداد الأصلي وسجّل ما يجمعه (ملفات السجلات، أهداف Prometheus).
  2. شغّل alloy convert مع --report واقرأ كل تحذير.
  3. شغّل Alloy بالتوازي على عقدة اختبار، دون إيقاف الوكيل القديم.
  4. قارن الأحجام المستلمة من الجانبين قبل إيقاف الوكيل القديم.

المقاييس والسجلات: مثالان من الوثائق

بالنسبة للمقاييس، يتطلب prometheus.scrape وسيطين إلزاميين هما targets (يحمل كل هدف على الأقل الوسم __address__) وforward_to. والفاصل الافتراضي 60 ثانية. وبالنسبة للسجلات، يقرأ loki.source.file ملفات يُعطى مسارها في الوسم __path__، ثم يمرّرها إلى loki.write.

أمثلة من وثائق Alloy: prometheus.scrape مع scrape_interval قدره 10 ثوانٍ، وloki.source.file مع مسار __path__، وloki.write نحو عنوان Loki

توضح هذه الكتل فائدة الأداة الواحدة: عملية واحدة وملف إعداد واحد وواجهة محلية لمعرفة المكوّنات السليمة. غير أن تمرير مقاييس Prometheus أو سجلات Loki إلى Dynatrace يتطلب مكوّنات تحويل لم تتحقق منها هذه المقالة؛ فلا تعتمد على ذلك قبل قراءتها في الوثائق.

التحقق من عمل Grafana Alloy

  1. افتح http://localhost:12345: يجب أن تظهر كل المكوّنات سليمة.
  2. افتح صفحة تفاصيل otelcol.exporter.otlphttp لمراجعة وسائطه المقيَّمة.
  3. أرسل تتبعًا تجريبيًا من تطبيق مزوّد بـ OpenTelemetry إلى المنفذ 4318.
  4. ابحث عن هذا التتبع في Dynatrace؛ وإن لم يظهر، فراجع نطاق الرمز والعنوان والبروتوكول.

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

  • مؤشر SLI للمُجمِّع نفسه: المُجمِّع الذي يفقد البيانات خطر على ميزانية الأخطاء (error budget). راقبه كخدمة. راجع قابلية الملاحظة والمراقبة.
  • رحّل على مراحل واحتفظ بالوكيل القديم ما دامت الأحجام غير متطابقة.
  • لا تكتب رمزًا في الإعداد أبدًا: استخدم متغيرات البيئة.
  • اقرأ صفحة المكوّن قبل إضافته: الوسائط والقيم الافتراضية والاستقرار.
  • اجعل OTLP هو العقد مع تطبيقاتك، مما يحدّ من الارتباط بمورّد واحد، كما يشرح OpenTelemetry وPrometheus.

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

هل يستبدل Grafana Alloy الأداة Grafana Agent؟

نعم من الناحية العملية: تذكر وثائق Loki أن Grafana Agent Static وFlow وOperator بلغت نهاية عمرها في 1 نوفمبر 2025، وتحدد أدلة الترحيل Alloy وجهةً لها.

هل Grafana Alloy هو OpenTelemetry Collector؟

هو توزيعة من OpenTelemetry Collector مع مسارات Prometheus مدمجة ودعم لـ Loki وPyroscope. وتستعيد المكوّنات otelcol.* المستقبِلات والمعالِجات والمصدِّرات الخاصة بـ Collector.

هل يمكن إرسال بيانات Alloy إلى Dynatrace؟

يصدّر Alloy بصيغة OTLP/HTTP، وتقبل واجهة OTLP في Dynatrace SaaS بروتوكول HTTP مع رمز منصة، وليس gRPC. فالجمع بينهما يعمل نظريًا؛ فاختبره قبل اعتماده. وحالة Managed غير مشمولة هنا.

الخلاصة

يستبدل Grafana Alloy أولًا وكلاء Grafana التي بلغت نهاية عمرها، ويمكنه أن يجمع عدة مُجمِّعات في واحد. لكنه لا يستبدل نظامًا خلفيًا ولا التفكير فيما يُجمَع. وللاختيار بين Alloy وOpenTelemetry Collector القياسي، انطلق من مصادرك: كلما تنوعت (Prometheus وLoki وOTLP) ازداد ما يبرر Alloy. ولتقليص حجم التتبعات، راجع أيضًا أخذ العينات المتأخر (tail sampling).

المصادر

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

Total
0
Shares
Leave a Reply

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

Previous Post
Monaco ou Terraform : quel outil pour la configuration Dynatrace ?

Monaco أم Terraform: أي أداة لإعدادات Dynatrace؟

Next Post
Ollama vLLM llama.cpp : quel moteur local choisir pour vos LLM ?

Ollama vLLM llama.cpp: أي محرك محلي تختار لنماذج LLM؟

Related Posts