جعلت عناقيد Kubernetes وOpenShift تثبيت الوكلاء «يدويًا» على كل مضيف أمرًا قديمًا. فالعقد تولد وتموت مع التوسع التلقائي، وتنتقل الـ pods، وتريد فرق المنصة أن يكون كل شيء تصريحيًا وخاضعًا للإصدارات ومتوافقًا تلقائيًا. وفي مجال قابلية الملاحظة (observability) يعني ذلك أن دورة حياة OneAgent وActiveGate يجب أن يديرها Kubernetes نفسه. وهذه هي مهمة Dynatrace Operator Kubernetes: يتولى Kubernetes نشر الوكلاء وتحديثهم بنفسه.
هذا هو دور Dynatrace Operator ومورده المخصص DynaKube. غير أن معظم الأمثلة المتاحة تفترض بيئة SaaS يمكن بلوغها عبر الإنترنت. أما في سياق Dynatrace Managed فالأسئلة مختلفة: عنوان API يشير إلى نطاقك الخاص، وشهادة العنقود تصدر غالبًا عن PKI داخلية، وسجلات الصور العامة ليست متاحة دائمًا، وتعبر التدفقات الشبكية بين عنقود Kubernetes وعنقود Managed جدرانًا نارية تديرها أنت.
يشرح هذا المقال كيفية ربط Dynatrace Operator ببيئة Managed، على Kubernetes القياسي وعلى OpenShift، بإعداد DynaKube يلائم هذه القيود.
البنية: ما الذي ينشره Operator
- Operator نفسه، الذي يراقب موارد
DynaKubeويوفّق الحالة المطلوبة. - الـ webhook، الذي يحقن وحدات الشيفرة في pods التطبيقات (وضع cloud-native) ويتحقق من موارد DynaKube.
- مشغّل CSI (بحسب الوضع)، الذي يخزّن ثنائيات OneAgent مؤقتًا على كل عقدة لتفادي التنزيلات المتكررة.
- OneAgent على شكل DaemonSet، أي pod واحد لكل عقدة، لرؤية المضيف والحقن.
- ActiveGate على شكل StatefulSet، يتولى مراقبة API الخاص بـ Kubernetes ويمكنه توجيه حركة الوكلاء إلى عنقود Managed.
تتواصل كل هذه المكونات مع API البيئة، المعروض في Managed على العنوان https://{votre-domaine}/e/{id-environnement}/api.
اختيار وضع النشر
| وضع DynaKube | المبدأ | متى يُستخدم |
|---|---|---|
cloudNativeFullStack |
OneAgent على المضيف مع الحقن في الـ pods عبر webhook | الخيار الافتراضي الموصى به لمعظم العناقيد |
applicationMonitoring |
الحقن في الـ pods فقط، دون وكيل على المضيف | المنصات التي تمنع DaemonSets ذات الامتيازات |
hostMonitoring |
وكيل على المضيف دون حقن في التطبيقات | مراقبة البنية التحتية للعقد |
classicFullStack |
الأسلوب التاريخي، حقن على مستوى المضيف | التوافق مع عمليات النشر القديمة |
تتطور الأوضاع المتاحة وسلوكها مع إصدارات Operator وAPI الخاص بـ DynaKube: راجع مصفوفة التوافق بين إصدار Managed لديك وإصدار Operator قبل الاختيار.
المتطلبات في جهة Managed
- بيئة مخصصة أو مشتركة، ومعرّفها الظاهر في العنوان
/e/{id-environnement}. - رمز Operator (رمز API) أُنشئ بالقالب Kubernetes: Dynatrace Operator:
InstallerDownloadوDataExportوsettings.readوsettings.writeوactiveGateTokenManagement.create(لم يعدentities.readمطلوبًا منذ Operator 1.7.0). - رمز استيعاب البيانات (ingestion token) بالقالب Kubernetes: Data Ingest:
metrics.ingestوlogs.ingestوopenTelemetryTrace.ingest. - تدفق HTTPS مفتوح من عقد Kubernetes إلى عقد Managed أو إلى ActiveGate.
- شهادة سلطة الجذر في PKI لديك بصيغة PEM (انظر شهادات SSL ونطاق العنقود) إذا كان عنقود Managed لا يستخدم شهادة عامة.
- إصدار حديث بما يكفي من عنقود Managed لإصدار Operator المستهدف.
دليل تطبيقي خطوة بخطوة: Dynatrace Operator Kubernetes
الخطوة 1: التحقق من الوصول إلى API من داخل العنقود
شغّل pod مؤقتًا لاختبار المسار الشبكي من داخل العنقود:
kubectl run nettest --rm -it --restart=Never --image=curlimages/curl -- \
curl -sS -o /dev/null -w "%{http_code}\n" \
-H "Authorization: Api-Token {token}" \
https://{votre-domaine}/e/{id-environnement}/api/v1/time
يتضمن رمز Operator النطاق DataExport الذي يتطلبه هذا الاستدعاء: فالرمز 200 يؤكد الشبكة والرمز معًا. أما خطأ الشهادة فيعني أنه يجب تزويد DynaKube بسلطة الجذر (الخطوة 4).
الخطوة 2: تثبيت Operator
أنشئ مساحة الأسماء (namespace) ثم ثبّت Operator بمخطط Helm الرسمي أو بالملفات (manifests) المنشورة لإصدارك:
kubectl create namespace dynatrace
helm install dynatrace-operator oci://public.ecr.aws/dynatrace/dynatrace-operator \
--namespace dynatrace --version {version-operator} --atomic
kubectl -n dynatrace get pods
على OpenShift ينطبق أمر Helm نفسه: تُكتشف المنصة تلقائيًا عند التثبيت (ويبقى OperatorHub بديلًا). تلزم قيود سياق الأمان (Security Context Constraints) في الوضعين cloudNativeFullStack وapplicationMonitoring مع مشغّل CSI. وفي البيئة المنفصلة عن الإنترنت انسخ الصور مسبقًا إلى سجلك الداخلي وعدّل مراجع الصور في قيم Helm.
الخطوة 3: إنشاء سر الرموز
kubectl -n dynatrace create secret generic {nom-dynakube} \
--from-literal="apiToken={token-operator}" \
--from-literal="dataIngestToken={token-ingestion}"
يجب أن يحمل السر اسم مورد DynaKube نفسه، ما لم تشر إليه صراحةً في المواصفات (spec).
الخطوة 4: تزويد شهادة PKI الخاصة بك
kubectl -n dynatrace create configmap dynatrace-trusted-ca \
--from-file=certs=/chemin/vers/ca-interne.pem
المفتاح certs هو ما ينتظره Operator. ويُشار إلى هذا الـ ConfigMap في الحقل trustedCAs.
الخطوة 5: تعريف مورد DynaKube
apiVersion: dynatrace.com/{version-api-dynakube}
kind: DynaKube
metadata:
name: {nom-dynakube}
namespace: dynatrace
spec:
apiUrl: https://{votre-domaine}/e/{id-environnement}/api
trustedCAs: dynatrace-trusted-ca
networkZone: {zone-reseau}
oneAgent:
hostGroup: {cluster-k8s}_{environnement}
cloudNativeFullStack: {}
activeGate:
capabilities:
- kubernetes-monitoring
- routing
resources:
requests:
cpu: 500m
memory: 1Gi
limits:
cpu: 1000m
memory: 2Gi
قيمة apiVersion (مثل v1beta2 أو v1beta3…) وبعض الحقول تتغير بين الإصدارات: يوضع hostGroup تحت spec.oneAgent، وتستبدل إصدارات Operator الحديثة القدرة kubernetes-monitoring بالقسم spec.kubernetesMonitoring (وهما يستبعد أحدهما الآخر). انطلق دائمًا من المثال المرفق بإصدار Operator المثبّت. أما موارد ActiveGate فهي أرقام تقريبية تُضبط بحسب حجم العنقود.
kubectl apply -f dynakube.yaml
kubectl -n dynatrace get dynakube
kubectl -n dynatrace get pods -o wide
الخطوة 6: التحقق من الاتصال
kubectl -n dynatrace describe dynakube {nom-dynakube}
kubectl -n dynatrace logs deploy/dynatrace-operator --tail=100
يجب أن يبلغ المورد المرحلة Running. وفي البيئة يظهر عنقود Kubernetes في عرض Kubernetes، وتظهر العقد في قائمة المضيفين مع المجموعة المحددة.
الخطوة 7: مراقبة الحقن
أعد تشغيل تطبيق تجريبي ثم تحقق من وجود الملاحظات (annotations) أو وحدات التخزين (volumes) التي أضافها الـ webhook:
kubectl -n {namespace-app} rollout restart deployment/{application}
kubectl -n {namespace-app} get pod -l app={application} -o yaml | grep -i dynatrace
لحصر الحقن في بعض مساحات الأسماء، استخدم namespaceSelector في DynaKube بدل قياس العنقود كله منذ البداية.
أفضل الممارسات
- ضع DynaKube وقيم Helm تحت إدارة الإصدارات في Git وطبّقهما عبر أداة GitOps لديك.
- طابق إصدار Operator مع مصفوفة التوافق لإصدار Managed قبل كل ترقية.
- استخدم سجلًا داخليًا للصور في البيئات المقيّدة، واختبر جلب الصورة على عقدة.
- استبعد مساحات أسماء النظام (
kube-systemوopenshift-*) من الحقن. - حدّد حجم ActiveGate بحسب عدد كائنات Kubernetes المراقَبة، وراقب استهلاكه للذاكرة.
- جدّد الرموز بانتظام بمجرد تحديث السر.
الأسئلة الشائعة
أي وضع DynaKube أختار مع عنقود Managed؟
الوضع cloudNativeFullStack هو الخيار الافتراضي لمعظم العناقيد. وإذا كانت DaemonSets ذات الامتيازات ممنوعة، فيقتصر applicationMonitoring على الحقن في الـ pods. وتحقق في جميع الحالات من مصفوفة التوافق بين إصدار Managed وإصدار Operator.
ماذا أفعل إذا أعاد اختبار API خطأ في الشهادة؟
هذه علامة على أن عنقود Managed يستخدم شهادة صادرة عن PKI داخلية. أنشئ ConfigMap يحتوي سلطة الجذر بصيغة PEM تحت المفتاح certs، ثم أشر إليه في الحقل trustedCAs من DynaKube.
كيف أتجنب قياس العنقود كله دفعة واحدة؟
استخدم namespaceSelector في DynaKube لحصر الحقن في مساحات الأسماء المطلوبة، واستبعد مساحات النظام مثل kube-system وopenshift-*.
الخلاصة
لا يتطلب ربط Dynatrace Operator بعنقود Managed آلية خاصة، لكنه يستلزم معالجة صريحة لما يخفيه SaaS: عنوان API على نطاقك، والشهادات الداخلية، والسجلات الخاصة، والتدفقات الشبكية. وبمورد DynaKube تصريحي وخاضع للإصدارات ومتلائم مع PKI لديك، يصبح Kubernetes وOpenShift مكونين من الدرجة الأولى في منصة قابلية الملاحظة داخل المؤسسة (on-premise).
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.