في بيئة Dynatrace Managed لا تحدث الترقية أبدًا «من تلقاء نفسها». فالعنقود (cluster) يعمل على خوادمك وفي مراكز بياناتك وبحسب نوافذ الصيانة لديك. كل إصدار جديد يحمل إصلاحات أمنية وتحسينات في الواجهة وتوافقًا مع التقنيات الحديثة قيد المراقبة، لكنه يعني أيضًا إعادة تشغيل تدريجية للخدمات وفحصًا لمساحة القرص وتنسيقًا مع فرق التطبيقات. لذلك يجب تخطيط ترقية عنقود Managed كأي عملية تشغيلية أخرى.
الفخ الحقيقي هو التراكم. العنقود الذي يتخطى عدة إصدارات يضطر في النهاية إلى اللحاق بها على مراحل، بينما تتقادم وكلاء OneAgent المنشورة على مئات المضيفين (hosts) بدورها وتخرج من نافذة التوافق. فيتحول ما كان يكفيه روتين شهري إلى ورشة تمتد أسابيع.
يقترح هذا المقال طريقة لتخطيط ترقية عنقود Managed ووكلاء OneAgent: فهم ما يُرقّى وبأي ترتيب، وتجهيز المتطلبات المسبقة، وإدارة العملية من Cluster Management Console (CMC) ومن واجهة API، ثم أتمتة ذلك كله.
ما الذي يُرقّى وبأي ترتيب
يتكون نشر Managed من عدة طبقات، لكل منها دورة حياة خاصة:
- عُقد العنقود (nodes): خادم Dynatrace وCassandra وElasticsearch ومخزن المعاملات ومكونات الويب. تُرقّى معًا، عقدة بعد عقدة.
- Cluster ActiveGate وEnvironment ActiveGate: تتحاور مع العنقود ويجب أن تبقى ضمن نطاق إصدارات متوافق.
- OneAgent: مثبّتة على المضيفين المراقَبين، وتُدار حسب البيئة أو مجموعة المضيفين أو بشكل فردي.
- Dynatrace Operator على Kubernetes، وهو يدير بنفسه وكلاء OneAgent وActiveGate المعرّفين في المورد
DynaKube.
القاعدة الذهبية: العنقود أولًا، ثم ActiveGate، ثم OneAgent أخيرًا. يأتي هذا الترتيب من طريقة عمل Managed: فحزم OneAgent وActiveGate وRUM يوزعها العنقود نفسه مع ترقياته. تحقق من نوافذ التوافق بين الإصدارات في الوثائق الرسمية؛ فمثلًا ينبّه CMC إلى Cluster ActiveGate المتأخر بأكثر من خمسة إصدارات.
ترقيات تلقائية أم يدوية؟
عندما يكون العنقود متصلًا بـ Mission Control، يستطيع CMC تنزيل الإصدارات الجديدة واقتراح تثبيت تلقائي ضمن نافذة صيانة تحددها. وفي وضع عدم الاتصال (offline) تُحمَّل الحزم الواردة بالبريد الإلكتروني في CMC الذي يوزعها على جميع العقد. لا تُنفَّذ الترقية التلقائية إلا في أول نافذة صيانة تقع بعد 24 ساعة من تنزيل الحزمة. وفي الحالتين أنت من يقرر التوقيت.
| الوضع | المزايا | نقاط الانتباه |
|---|---|---|
| تلقائي (نافذة صيانة) | عنقود محدّث دائمًا بجهد قليل | مواءمة النافذة مع فترات تجميد التغييرات، ومتابعة الإشعارات |
| يدوي من CMC | تحكم كامل في الموعد، وإمكانية التحقق المسبق | يتطلب انضباطًا لتفادي التأخر |
| دون اتصال (حزمة منقولة) | متوافق مع البيئات المعزولة (air-gapped) | توثيق إجراء النقل والتحقق من سلامة الحزمة |
تجهيز ترقية عنقود Managed
معظم حوادث الترقية سببها متطلب مسبق أُهمل. قبل كل عملية، راجع هذه القائمة:
- سلامة العنقود: جميع العقد بحالة «Healthy» في CMC، ولا توجد تنبيهات تخزين جارية.
- مساحة القرص: تفك الترقية ضغط الملفات التنفيذية الجديدة تحت
/opt/dynatrace-managedوقد تطلق عمليات ترحيل بيانات تحت/var/opt/dynatrace-managed. تشترط الوثائق 5 جيجابايت على الأقل خالية في قسم التثبيت، وفاصل 24 ساعة بين ترقيتين للعنقود. - نسخة احتياطية حديثة: تأكد من أن آخر نسخة احتياطية للعنقود على تخزين NFS انتهت بنجاح.
- ملاحظات الإصدار: اقرأ تغييرات السلوك والتقنيات المهملة والحد الأدنى المطلوب لإصدار OneAgent وActiveGate.
- التواصل: أبلغ المستخدمين؛ ففي أقل من ثلاث عقد يتعذر الوصول إلى العنقود أثناء الترقية، وفي ثلاث عقد فأكثر تبقى الواجهة متاحة لكن قد تحدث انقطاعات اتصال متفرقة.
درس تطبيقي خطوة بخطوة
الخطوة 1: التحقق من حالة العنقود والعقد
في CMC افتح صفحة النظرة العامة للعنقود وتأكد من أن كل عقدة تعمل. وعلى مستوى النظام، نفّذ على كل عقدة:
systemctl list-units --type=service | grep -i dynatrace
df -h /opt/dynatrace-managed /var/opt/dynatrace-managed
sudo /opt/dynatrace-managed/utils/cassandra-nodetool.sh status
يمكنك أيضًا الاستعلام من Cluster API لسرد العقد وحالتها، باستخدام Cluster API token يملك الصلاحية Service Provider API (Cluster API v1):
curl -s -H "Authorization: Api-Token {token-cluster}" \
"https://{votre-domaine}/api/v1.0/onpremise/cluster" | python3 -m json.tool
الخطوة 2: فحص آخر نسخة احتياطية
في قسم إعدادات النسخ الاحتياطي في CMC، تحقق من تاريخ آخر نسخة احتياطية وحالتها. وعلى جهة التخزين المشترك:
ls -lh {point-de-montage-nfs}/
df -h {point-de-montage-nfs}
إذا فشلت آخر نسخة احتياطية، فعالج السبب قبل أي ترقية.
الخطوة 3: تحديد نافذة الصيانة
في Settings > Automatic update من CMC، اختر بين التثبيت التلقائي واليدوي، وحدد نافذة (مثلًا يوم الثلاثاء بين 22:00 و02:00). واءمها مع تقويم تجميد التغييرات ووثّقها في أداة ITSM لديك.
الخطوة 4: بدء ترقية العنقود
عند توفر الإصدار الجديد، شغّل التثبيت من Settings > Automatic update في CMC، أو عبر Cluster API v1:
curl -s -X POST -H "Authorization: Api-Token {token-cluster}" \
"https://{votre-domaine}/api/v1.0/upgradeManagement/triggerUpgrade"
ثم راقب التقدم في Deployment Status.
في وضع عدم الاتصال حمّل الحزمة عبر Upload installation package. وفي الترقية اليدوية بالكامل، انسخ dynatrace-managed-{version}.sh إلى /opt/dynatrace-managed/installer/upgrade على كل عقدة، ثم شغّله بصلاحية root مع الخيار --upgrade، عقدة واحدة في كل مرة، مع انتظار انتهاء كل واحدة.
الخطوة 5: التحقق بعد الترقية
- الإصدار المعروض في CMC يطابق الإصدار المستهدف على جميع العقد.
- لا تزال البيئات تتلقى بيانات (تحقق من مضيف وخدمة أساسيين).
- وكلاء ActiveGate متصلون ولا يظهر أي حدث خطأ في الاتصال.
الخطوة 6: ترقية ActiveGate
بعد استقرار العنقود، رقِّ وكلاء ActiveGate، إما عبر الترقية التلقائية من واجهة البيئة وإما بإعادة تثبيت الحزمة المنزّلة من عنقودك. ابدأ بـ ActiveGate غير حرج.
الخطوة 7: نشر OneAgent على دفعات
في كل بيئة، تتيح إعدادات تحديث OneAgent اختيار إصدار مستهدف ونافذة صيانة، على المستوى العام أو مستوى مجموعة المضيفين أو المضيف. الاستراتيجية الموصى بها:
- الدفعة 1: مجموعة مضيفين للاختبار (
--set-host-group=recetteعند التثبيت). - الدفعة 2: الإنتاج غير الحرج، بعد بضعة أيام.
- الدفعة 3: الإنتاج الحرج، بعد التحقق.
لمضيف منفرد، تحقق من الإصدار المثبّت باستخدام oneagentctl:
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --version
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-host-group
لجلب أحدث مثبّت من عنقودك (حالة المضيفين المعاد تثبيتهم بالأتمتة):
curl -o oneagent.sh -H "Authorization: Api-Token {token}" \
"https://{votre-domaine}/e/{id-environnement}/api/v1/deployment/installer/agent/unix/default/latest?arch=x86"
sudo /bin/sh oneagent.sh --set-host-group={groupe} --set-monitoring-mode=fullstack
لاحظ أن معظم ترقيات OneAgent تتطلب إعادة تشغيل عمليات التطبيق لتفعيل الإصدار الجديد من القياس البرمجي (instrumentation)، فخطّط لذلك مع فرق التطبيقات.
الخطوة 8: Kubernetes وDynatrace Operator
على Kubernetes، رقِّ أولًا الـ Operator بطريقتك المعتادة (Helm أو ملفات manifest)، ثم دعه يوائم وكلاء OneAgent المعرّفين في DynaKube (الذي يشير apiUrl فيه إلى https://{votre-domaine}/e/{id-environnement}/api). ثم تحقق:
kubectl -n dynatrace get dynakube
kubectl -n dynatrace get pods -o wide
أفضل الممارسات
- إيقاع ثابت: ترقية واحدة للعنقود في كل دورة إصدار دون تخطي أي إصدار أفضل من لحاق جماعي.
- عنقود اختبار: إن سمح ترخيصك، فعنقود Managed صغير للمرحلة السابقة للإنتاج يتلقى كل إصدار قبل الإنتاج بأسبوع إلى أسبوعين.
- مجموعات مضيفين مصممة للترقية: سمِّها حسب الأهمية والبيئة لتتمكن من استهداف الدفعات.
- runbook بإصدارات: وثّق الفحوص المسبقة والأوامر ومعايير التحقق وإجراء التراجع، وراجعها بعد كل عملية.
- مراقبة التوافق: لوحة معلومات (dashboard) تسرد إصدارات OneAgent لكل مجموعة مضيفين تساعد على رصد المضيفين المنسيين.
الأسئلة الشائعة
بأي ترتيب تُرقّى المكونات؟
العنقود أولًا، ثم ActiveGate، ثم OneAgent أخيرًا، لأن العنقود هو من يوزع حزم الوكلاء. تحقق من نوافذ التوافق في الوثائق الرسمية.
هل يمكن تخطي إصدارات العنقود؟
أحيانًا: فقط الإصدار المثبّت القابل للقسمة على 4 (1.300 أو 1.304…) يسمح بتخطي الإصدار التالي بعد نشر الهدف؛ وإلا فيجب المرور بكل إصدار. ومنذ 1.324 يفرض خيار في CMC ترقيات متتابعة. وتبقى ترقية واحدة في كل دورة أبسط روتين.
هل يعمل الإصدار الجديد من OneAgent فورًا؟
ليس دائمًا: معظم ترقيات OneAgent تتطلب إعادة تشغيل عمليات التطبيق لتفعيل القياس البرمجي الجديد. خطّط لهذه الإعادات مع فرق التطبيقات.
الخلاصة
ترقية Dynatrace Managed ليست محفوفة بالمخاطر إذا احترمت الترتيب عنقود ← ActiveGate ← OneAgent، وفحصت السلامة والقرص والنسخ الاحتياطي قبل التنفيذ، ونشرت الوكلاء على دفعات. المكسب الحقيقي في الانتظام: روتين قصير ومتكرر يحوّل عملية مخيفة إلى حدث عادي، ويُبقي منصة قابلية الملاحظة (observability) موثوقة بقدر التطبيقات التي تراقبها.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.