المسار: Dynatrace SaaS · الوحدة 2/8 — نشر OneAgent وDynatrace Operator · المدة: نحو 60 دقيقة · المستوى: مبتدئ
الأهداف:
- فهم ما يجمعه OneAgent وأوضاع المراقبة المتاحة.
- تثبيت OneAgent على مضيف Linux تجريبي والتحقق من ظهوره في البيئة.
- نشر Dynatrace Operator على Kubernetes باستخدام مورد DynaKube.
- معرفة كيفية تشخيص أكثر إخفاقات النشر شيوعًا.
المتطلبات المسبقة: الوحدة 1، وجهاز Linux تجريبي بصلاحيات root، وعنقود Kubernetes تجريبي مع kubectl، ويُنصح بوجود Helm.
بيئة Dynatrace بلا بيانات لا تُظهر شيئًا. تشرح هذه الوحدة كيف تنشر OneAgent وDynatrace Operator، وهما الوسيلتان الرئيسيتان للجمع التلقائي: OneAgent للمضيفات التقليدية، وOperator لعناقيد Kubernetes. وهي جزء من المسار التدريبي لـ Dynatrace SaaS وتمهّد لوحدات التحليل التالية.
الهدف ليس تغطية كل خيارات التثبيت الكثيرة، بل إنجاز أول عملية نشر سليمة وفهم ما يحدث.
ماذا يفعل OneAgent؟
OneAgent وكيل (agent) يُثبَّت مرة واحدة على كل مضيف. يكتشف العمليات تلقائيًا، ويحقن القياس البرمجي (instrumentation) في التقنيات المدعومة (Java و.NET وNode.js وPHP وGo وخوادم الويب…)، ويرسل إلى البيئة المقاييس والتتبعات الموزّعة والسجلات والطوبولوجيا. لا حاجة إلى تعديل شيفرة التطبيق للحصول على التتبعات في التقنيات المدعومة.
يمكن أن يعمل OneAgent بعدة مستويات من المراقبة. تختلف الأسماء الدقيقة بحسب الإصدارات، لكن الفكرة واحدة:
| المستوى | ما يُجمع | حالة الاستخدام |
|---|---|---|
| Full-stack | البنية التحتية والعمليات وتتبعات التطبيقات والسجلات | خوادم التطبيقات المطلوب مراقبتها بعمق |
| Infrastructure | المضيف والعمليات والشبكة دون قياس برمجي للتطبيقات | قواعد البيانات وخوادم البنية التحتية |
| Discovery | الجرد والمقاييس الأساسية | تغطية واسعة بتكلفة منخفضة |
للمستوى أثر مباشر على استهلاك الترخيص: اخترْه مضيفًا بمضيف بحسب القيمة المنتظرة.
دور ActiveGate
يمكن لـ OneAgent إرسال بياناته مباشرة إلى بيئة SaaS. يصبح ActiveGate مفيدًا حين لا يكون للمضيفات اتصال مباشر بالإنترنت (فيعمل حينها كمرحّل)، أو لبعض التكاملات التي تستعلم عن واجهات API بعيدة. على Kubernetes ينشر Operator بنفسه ActiveGate، خصوصًا لمراقبة واجهة API الخاصة بالعنقود.
كيف تنشر OneAgent على مضيف Linux؟
يبدأ النشر من البيئة: ابحث عن معالج نشر OneAgent (عبر البحث عن «Deploy OneAgent» أو من تطبيق البنية التحتية). يولّد أمر تنزيل يحتوي على عنوان البيئة ورمز تثبيت. انسخه كما هو ولا تصنع عنوان URL يدويًا.
يبدو التثبيت نفسه هكذا، بعد تنزيل المثبّت:
sudo /bin/sh Dynatrace-OneAgent-Linux-<version>.sh --set-host-group=formation-saas
يربط المعامل --set-host-group المضيف بمجموعة مضيفات (host group)، وهو عملي لتطبيق إعدادات مشتركة والتصفية لاحقًا. بعد التثبيت لا تُحقن العمليات الجارية أصلًا: أعد تشغيل التطبيقات كي يجري تتبعها.
للتحقق من الحالة المحلية للوكيل، تُثبَّت أداة سطر الأوامر oneagentctl مع OneAgent:
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-host-group
إذا سبق لك تثبيت OneAgent في سياق Managed فالمنطق قريب؛ يفصّل مقال نشر OneAgent على Linux في Managed الخيارات الصامتة. وحده الهدف يتغير: هنا بيئة SaaS.
نشر OneAgent وDynatrace Operator على Kubernetes
على Kubernetes لا يُثبَّت OneAgent عقدة بعقدة. تنشر Dynatrace Operator، وهو operator في Kubernetes يقرأ مواردَ مخصصة تُسمى DynaKube وينشئ بنفسه المكونات اللازمة: OneAgent وActiveGate والحقن في الـ pods.
اختيار وضع النشر
- Cloud-native full-stack: مراقبة البنية التحتية للعقد وحقن القياس البرمجي في pods التطبيقات. وهو الوضع الأشمل والأكثر شيوعًا.
- Application monitoring: الحقن في الـ pods دون مراقبة المضيف، ومفيد حين لا تتحكم في العقد.
- Host monitoring: مراقبة العقد فقط.
الخطوات
الأبسط اتباع معالج تطبيق Kubernetes الذي يولّد الرموز المميزة وملف dynakube.yaml مناسبًا. يلزم عادةً رمزان: واحد لـ Operator وآخر لاستيعاب البيانات. يأخذ تثبيت Operator عبر Helm الشكل التالي:
helm install dynatrace-operator oci://public.ecr.aws/dynatrace/dynatrace-operator \
--create-namespace --namespace dynatrace --atomic
مع Helm 4.0 أو أحدث، استبدل --atomic بـ --rollback-on-failure.
ثم يُطبَّق مورد DynaKube المولَّد. بنيته العامة تشبه هذا المقتطف المبسّط (إصدار API والحقول الدقيقة يتبعان إصدار Operator: خذها من الملف المولَّد):
apiVersion: dynatrace.com/<version>
kind: DynaKube
metadata:
name: formation
namespace: dynatrace
spec:
apiUrl: https://<environnement>/api
oneAgent:
cloudNativeFullStack: {}
activeGate:
capabilities:
- routing
kubernetesMonitoring: # Operator 1.11.0+
registration: {}
kubectl apply -f dynakube.yaml
kubectl get dynakube -n dynatrace
kubectl get pods -n dynatrace
كما في المضيف، يجب إعادة تشغيل pods التطبيقات التي بدأت بالفعل كي تتلقى الحقن.
ما أكثر الأخطاء شيوعًا؟
- تطبيقات بلا قياس برمجي: لم تُعد تشغيلها بعد التثبيت.
- وكيل لا يتصل: يمنع proxy أو جدار حماية الخروج نحو البيئة؛ يلزم ActiveGate كمرحّل أو ضبط proxy.
- DynaKube في حالة خطأ: رمز غير صالح أو صلاحيات رمز غير كافية أو عنوان API خاطئ. اقرأ حالة المورد وسجلات pod الخاص بـ Operator.
- تكلفة غير متوقعة: تفعيل full-stack في كل مكان افتراضيًا. قرّر الوضع قبل النشر على نطاق واسع.
للتعمق في Kubernetes أبعد من الأساسيات، يوضح مقال استعلامات CPU الفعلية لـ pods في Kubernetes ما يمكن استخلاصه من البيانات التي يجمعها Operator.
تمرين عملي
الخطوة 1 — ثبّت OneAgent على جهاز Linux
من معالج النشر، نزّل مثبّت Linux ونفّذه مع مجموعة المضيفات formation-saas. ثم شغّل تطبيقًا صغيرًا (خادم ويب مثلًا) أو أعد تشغيل التطبيق القائم.
النتيجة المتوقعة: بعد دقائق يظهر المضيف في تطبيق البنية التحتية مع عملياته.
الخطوة 2 — تحقق من البيانات في Grail
في notebook نفّذ:
fetch dt.entity.host
| fields entity.name, id
النتيجة المتوقعة: يظهر مضيفك في القائمة.
الخطوة 3 — انشر Operator
على العنقود التجريبي، اتبع معالج تطبيق Kubernetes بوضع cloud-native full-stack، وثبّت Operator ثم طبّق DynaKube. تحقق من انتقال pods في namespace باسم dynatrace إلى حالة Running.
النتيجة المتوقعة: يظهر العنقود في تطبيق Kubernetes مع عقده وnamespaces.
الخطوة 4 — راقب workload
انشر تطبيقًا تجريبيًا في namespace مخصص وأعد تشغيله إن كان موجودًا. ابحث عن خدمته في تطبيق Services.
النتيجة المتوقعة: تُكتشف الخدمة وتعرض الطلبات وأزمنة الاستجابة.
اختبار قصير
- لماذا يجب إعادة تشغيل تطبيق بعد تثبيت OneAgent؟ أ) لتفعيل الترخيص ب) كي يُحقن القياس البرمجي في العملية ج) لمسح ذاكرة DNS المؤقتة د) ليس ضروريًا أبدًا
- أي مورد مخصص يضبط Dynatrace Operator؟ أ) OneAgentConfig ب) DynaKube ج) HostGroup د) ActiveGateSet
- أي وضع في Kubernetes يجمع مراقبة العقد والحقن في الـ pods؟ أ) Host monitoring ب) Application monitoring ج) Cloud-native full-stack د) Discovery
- متى يكون ActiveGate مفيدًا للمضيفات التقليدية؟ أ) دائمًا، فلا يستطيع OneAgent الإرسال وحده ب) حين لا يكون للمضيفات وصول مباشر إلى البيئة ج) لتثبيت DQL د) ليحل محل OneAgent
الإجابات
- ب. يُحمَّل القياس البرمجي عند بدء العملية؛ والعملية التي بدأت لا تُتتبَّع.
- ب. يقرأ Operator مورد DynaKube وينشئ المكونات التي يصفها.
- ج. يراقب وضع cloud-native full-stack العقد ويحقن القياس البرمجي في الـ pods.
- ب. يستطيع OneAgent الإرسال مباشرة؛ ويعمل ActiveGate كمرحّل حين تفرضه الشبكة.
للمزيد
- استعلامات CPU الفعلية لـ pods في Kubernetes
- ربط Dynatrace Operator بعنقود Managed، للمقارنة بين السياقين
- OpenTelemetry من البداية إلى النهاية، حين لا يكفي القياس البرمجي التلقائي
- الوثائق الرسمية: docs.dynatrace.com، أقسام OneAgent وKubernetes
← الوحدة 1: منصة Dynatrace SaaS وGrail والمفاهيم الأساسية · فهرس المسار · الوحدة 3: أساسيات DQL →
الأسئلة الشائعة
هل يمكن تثبيت OneAgent على عقد Kubernetes دون Operator؟
ممكن تقنيًا في بعض الحالات، لكن Operator هو الطريقة الموصى بها: فهو يدير التحديثات والحقن في الـ pods وActiveGate بأسلوب تصريحي (declarative).
كم يلزم من الوقت لرؤية أولى البيانات؟
بضع دقائق عادةً بعد بدء الوكيل. إن لم يظهر شيء بعد ربع ساعة، فتحقق من اتصال الشبكة وحالة الوكيل باستخدام oneagentctl أو حالة DynaKube.
هل يلزم رمز مختلف لكل عنقود؟
ليس إلزاميًا، لكنه ممارسة جيدة: الرموز المنفصلة تحد من أثر أي تسريب وتسهّل تدويرها.
تتلقى بيئتك الآن بيانات من مضيف ومن عنقود. حان وقت تعلّم اللغة التي تتيح الاستعلام عنها.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. لا يغني هذا المسار عن الدورات والشهادات الرسمية من Dynatrace University. تحقق دائمًا من الميزات في الوثائق الرسمية الخاصة بإصدارك.