نظرة عامة على مشروع Grafana Agent

ملخص المشروع

Grafana Agent هو إصدار توزيعي يعتمد على OpenTelemetry Collector، مع نمط تكوين مستوحى من Terraform. تم تصميمه ليكون جامع بيانات مراقبة مرن وعالي الأداء ومتوافقًا مع العديد من الأنظمة البيئية، بما في ذلك Prometheus و OpenTelemetry.

⚠️ تذكير هام: تم إيقاف Grafana Agent وهو الآن في وضع الدعم طويل الأجل. يوصى بالترحيل إلى إصدار جديد من Grafana Alloy مبني على Grafana Agent Flow.

الميزات الأساسية

1. حيادية البائع

• توافق كامل: متوافق تمامًا مع أنظمة Prometheus و OpenTelemetry و Grafana مفتوحة المصدر.
• دعم متعدد الإشارات: جمع المقاييس والسجلات وتتبع الروابط وبيانات تحليل الأداء المستمر.
• نشر مرن: يمكن نشره على أي عدد من الأجهزة، ومعالجة ملايين التسلسلات النشطة وتيرابايت من السجلات.

2. بنية معيارية

تم بناء Grafana Agent على أساس المكونات. يتم توصيل المكونات معًا لتشكيل خطوط أنابيب مراقبة قابلة للبرمجة لجمع ومعالجة ونقل بيانات القياس عن بعد.

3. جمع البيانات ونقلها

يمكن لـ Grafana Agent جمع وتحويل وإرسال البيانات إلى:

• نظام Prometheus البيئي
• نظام OpenTelemetry البيئي
• نظام Grafana مفتوح المصدر البيئي (بما في ذلك Loki و Grafana و Tempo و Mimir و Pyroscope)

4. ميزات على مستوى المؤسسات

• قابلية التوسع: يدعم عمليات النشر واسعة النطاق، ومعالجة ملايين التسلسلات النشطة.
• التحقق من القتال: يوسع التعليمات البرمجية التي تم التحقق منها في القتال لمشاريع Prometheus و OpenTelemetry Collector.
• وظائف قوية: يدعم كتابة خطوط أنابيب قابلة للبرمجة ويوفر واجهة مستخدم مدمجة للتصحيح.
• جاهز للاستخدام: يتكامل مع أنظمة مثل MySQL و Kubernetes و Apache.

البنية التقنية

وضع التدفق (Flow)

تركز هذه الصفحة بشكل أساسي على "وضع التدفق"، وهو نسخة منقحة من Grafana Agent مستوحاة من Terraform. يوفر وضع التدفق طريقة تكوين أكثر سهولة، مما يسمح للمستخدمين بما يلي:

• سهولة إعداد وفحص التكوين
• تكرار سريع لخطوط أنابيب القياس عن بعد
• تقليل منحنى التعلم

مثال على التكوين

// اكتشاف وحدات Kubernetes لجمع المقاييس
discovery.kubernetes "pods" {
  role = "pod"
}

// جمع المقاييس من وحدات Kubernetes
prometheus.scrape "default" {
  targets = discovery.kubernetes.pods.targets
  forward_to = [prometheus.remote_write.default.receiver]
}

// الحصول على مفتاح API من القرص
local.file "apikey" {
  filename = "/var/data/my-api-key.txt"
  is_secret = true
}

// إرسال المقاييس إلى نقطة نهاية Prometheus remote_write
prometheus.remote_write "default" {
  endpoint {
    url = "http://localhost:9009/api/prom/push"
    basic_auth {
      username = "MY_USERNAME"
      password = local.file.apikey.content
    }
  }
}

حالة المشروع والترحيل

ملاحظة الإيقاف

Grafana Alloy هو الاسم الجديد لتوزيعة OTel Collector الخاصة بنا. تم إيقاف Grafana Agent وسيتم توفير دعم طويل الأجل (LTS) حتى 31 أكتوبر 2025. سيصل Grafana Agent إلى نهاية العمر الافتراضي (EOL) في 1 نوفمبر 2025.

توصيات الترحيل

يوصي القائمون على صيانة المشروع بشدة المستخدمين بالترحيل إلى Grafana Alloy، للأسباب التالية:

• أداء واستقرار أفضل
• ميزات أكثر ثراءً على مستوى المؤسسات
• تحديثات ودعم مستمر للميزات

التثبيت والنشر

الأنظمة الأساسية المدعومة

• Linux و macOS و Windows
• حاويات Docker
• مجموعات Kubernetes
• الأنظمة الأساسية السحابية (AWS و GCP و Azure وما إلى ذلك)

بداية سريعة

يوفر المشروع وثائق وأمثلة كاملة:

• دليل تثبيت مفصل
• دروس للمبتدئين
• وثائق مرجعية للمكونات
• بيئة مثال Docker Compose

سيناريوهات الاستخدام النموذجية

1. مراقبة واسعة النطاق

مناسب لعمليات نشر Prometheus واسعة النطاق التي تتطلب معالجة ملايين التسلسلات النشطة.

2. جمع متعدد الإشارات

جمع موحد للمقاييس والسجلات وتتبع الروابط وبيانات تحليل الأداء.

3. بيئة السحابة المختلطة

يوفر حلول مراقبة متسقة في بيئات السحابة المتعددة والمختلطة.

4. تكامل DevOps

تكامل عميق مع خطوط أنابيب CI/CD وسير عمل GitOps.

ملخص

يوفر Grafana Agent، باعتباره جامع بيانات مراقبة ناضجًا، للمستخدمين إمكانات قوية لجمع ومعالجة ونقل بيانات القياس عن بعد. على الرغم من أن المشروع قد دخل في وضع الصيانة، إلا أن مفاهيمه وهندسته الأساسية أرست أساسًا متينًا للجيل الجديد من Grafana Alloy. بالنسبة للمستخدمين الحاليين، يوصى بالترحيل تدريجيًا إلى Grafana Alloy وفقًا للإرشادات الرسمية للحصول على أداء أفضل ودعم مستمر.