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.

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 من أجل هذه المقالة: اختبره في بيئة غير حرجة.
الأسطر الحرجة
- الكتلة
outputإلزامية في المستقبِل. بحسب الوثائق، إذا بقيت القوائمmetricsوlogsوtracesفارغة، فإن القياسات تُهمَل. - الأسرار تأتي من البيئة عبر
sys.env. يدمج المعامل+السلاسل النصية، مما يتيح بناء القيمةBearer …دون كتابة الرمز في الملف. - لا gRPC نحو Dynatrace: لا تخلط بين المصدِّر
otlp(gRPC) وotlphttp.
الترحيل من Grafana Agent أو Promtail باستخدام alloy convert
يوفّر Alloy أمر تحويل. بحسب أدلة الترحيل، تكون قيمة --source-format إما promtail أو static، ويحدد --output ملف Alloy الناتج، ويكتب --report تقرير تشخيص. وبدون تقرير، تخرج أخطاء التحويل على stderr.

ويشير الدليل أيضًا إلى خيارين يجب التعامل معهما بحذر. فالخيار --bypass-errors ينتج تحويلًا «بأفضل جهد» قد يختلف سلوكه عن الأصل. والأمر run --config.format=… مع --config.bypass-conversion-errors يشغّل Alloy رغم أخطاء غير حرجة، وهو ما تنصح الوثائق بتجنبه في بيئة الإنتاج.
- احتفظ بنسخة من الإعداد الأصلي وسجّل ما يجمعه (ملفات السجلات، أهداف Prometheus).
- شغّل
alloy convertمع--reportواقرأ كل تحذير. - شغّل Alloy بالتوازي على عقدة اختبار، دون إيقاف الوكيل القديم.
- قارن الأحجام المستلمة من الجانبين قبل إيقاف الوكيل القديم.
المقاييس والسجلات: مثالان من الوثائق
بالنسبة للمقاييس، يتطلب prometheus.scrape وسيطين إلزاميين هما targets (يحمل كل هدف على الأقل الوسم __address__) وforward_to. والفاصل الافتراضي 60 ثانية. وبالنسبة للسجلات، يقرأ loki.source.file ملفات يُعطى مسارها في الوسم __path__، ثم يمرّرها إلى loki.write.

توضح هذه الكتل فائدة الأداة الواحدة: عملية واحدة وملف إعداد واحد وواجهة محلية لمعرفة المكوّنات السليمة. غير أن تمرير مقاييس Prometheus أو سجلات Loki إلى Dynatrace يتطلب مكوّنات تحويل لم تتحقق منها هذه المقالة؛ فلا تعتمد على ذلك قبل قراءتها في الوثائق.
التحقق من عمل Grafana Alloy
- افتح
http://localhost:12345: يجب أن تظهر كل المكوّنات سليمة. - افتح صفحة تفاصيل
otelcol.exporter.otlphttpلمراجعة وسائطه المقيَّمة. - أرسل تتبعًا تجريبيًا من تطبيق مزوّد بـ OpenTelemetry إلى المنفذ 4318.
- ابحث عن هذا التتبع في 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).
المصادر
- مقدمة، وثائق Grafana Alloy
- مستودع grafana/alloy
- الترحيل من Promtail، وثائق Alloy
- الترحيل من Grafana Agent Static، وثائق Alloy
- Migrate to Alloy، وثائق Loki
- otelcol.receiver.otlp، otelcol.exporter.otlphttp، prometheus.scrape، loki.source.file
- واجهة Alloy، وثائق Grafana Alloy
- واجهة OTLP، وثائق Dynatrace (SaaS)
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لشركة Grafana Labs. Dynatrace علامة تجارية لشركة Dynatrace LLC. أسماء المنتجات المذكورة تعود إلى مالكيها؛ والإعدادات أمثلة يجب تكييفها واختبارها. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.