عنقودك يعمل منذ سنوات، والترقيات تتوالى، ويقضي الفريق وقتًا في تشغيل Dynatrace أكثر مما يقضيه في تشغيل خدماته. اتُّخذ القرار: ترحيل Managed إلى SaaS. يبقى أن يتم ذلك دون فجوة في الرؤية، ودون فقدان التنبيهات، ودون إيقاظ فريق المناوبة (on-call) في الثالثة فجرًا.
الترحيل الفاشل مكلف: مضيفون لم يعودوا يرسلون شيئًا، وملفات تنبيه منسية، وأهداف SLO تبدأ من الصفر. وكل ساعة بلا بيانات هي ساعة يتضخم فيها MTTR لحادثة حقيقية. المفتاح هو التعامل مع الترحيل كتغيير في البنية التحتية: جرد، وإعداد ككود، ونقل على دفعات، وفحص عند كل خطوة.
هدف هذا الدليل: خطة ملموسة من ست خطوات، والأدوات المستخدمة (Monaco وoneagentctl وDynatrace Operator) وأكثر الأخطاء شيوعًا. وهو يخص العالمين: Dynatrace Managed مصدرًا وDynatrace SaaS هدفًا. أما برنامج الترحيل التجاري وأدوات المرافقة المحتملة فتعتمد على عقدك: تحقق منها مع جهة الاتصال لديك في Dynatrace.
ما الذي يُرحَّل وما الذي لا يُرحَّل
قبل أي أمر، اتفق على التوقعات مع الفرق. ثلاث فئات من الكائنات تتصرف بشكل مختلف.
| العنصر | المقاربة | تعليق |
|---|---|---|
| الإعدادات (ملفات التنبيه، management zones، قواعد الوسم، كشف الشذوذ) | تصدير ثم استيراد ككود (Monaco أو Terraform) | تحتاج مراجعة: لبعض الكائنات الكلاسيكية مقابل مختلف في SaaS |
| الوكلاء (OneAgent وActiveGate وOperator) | إعادة توجيه أو إعادة تثبيت نحو البيئة الجديدة | تتم على دفعات مع خطة للتراجع |
| البيانات التاريخية (المقاييس والتتبعات والسجلات) | لا تعتمد عليها | خطط لفترة احتفاظ مزدوج على عنقود Managed |
| المستخدمون والمجموعات والرموز (tokens) | إعادة إنشاء في حساب SaaS | الرموز مرتبطة ببيئتها: لا يبقى أي منها بعد الترحيل |
النقطة الأخيرة تفاجئ كثيرًا. رمز API لبيئة Managed لا يعمل على بيئة SaaS: كل تكامل (CI/CD وOpenTelemetry Collector والنصوص البرمجية) سيحتاج إلى رمز جديد.
المتطلبات المسبقة
- بيئة Dynatrace SaaS مجهّزة ووصول مسؤول إلى الحساب.
- على Managed: رمز API لكل بيئة مصدر بنطاقات قراءة الإعدادات (
ReadConfigوsettings.read). - على SaaS: رمز API (
WriteConfigوsettings.write) وللكائنات الخاصة بالمنصة (المستندات وworkflows) عميل OAuth أو platform token. - أداة
monacoمثبّتة (الملف التنفيذي من مستودعDynatrace/dynatrace-configuration-as-code)، ومستودع Git لإصدار التصدير. - جرد للمضيفين وعناقيد Kubernetes وActiveGate مع مالك كل منها.
ترحيل Managed إلى SaaS في ست خطوات
الخطوة 1: الجرد والتقسيم إلى دفعات
اسرد ما يرسل بيانات إلى العنقود. تعطي Cluster API وAPI البيئة قائمة المضيفين وإصدارات الوكلاء؛ ويبيّن دليل أتمتة الإدارة باستخدام Cluster API كيفية الاستعلام منها. ثم جمّع في دفعات: بيئة اختبار أولًا، ثم الخدمات غير الحرجة، وأخيرًا الإنتاج. لكل دفعة مالك وتاريخ ومعيار نجاح قابل للقياس (مثلًا: 100% من مضيفي الدفعة مرئيون في SaaS خلال 30 دقيقة).
الخطوة 2: تصدير الإعدادات بـ Monaco
عرّف بيئة Managed في ملف manifest. يحتوي عنوان بيئة Managed على المسار /e/<env-id>.
manifestVersion: 1.0
projects:
- name: export
environmentGroups:
- name: source
environments:
- name: managed-prod
url:
type: environment
value: MANAGED_URL
auth:
token:
name: MANAGED_TOKEN
هنا يدل type: environment على أن القيمة اسم متغير بيئة، ويحدد token.name المتغير الذي يحوي الرمز. لا يُكتب أي سر في الملف.
export MANAGED_URL="https://<votre-domaine>/e/<env-id>"
export MANAGED_TOKEN="dt0c01.XXXX"
monaco download --manifest manifest.yaml --environment managed-prod --output-folder export-managed
أودِع النتيجة كما هي في commit. يصبح هذا الـ commit الأول مرجعًا: أي تعديل لاحق سيظهر في diff.
الخطوة 3: التنظيف قبل الاستيراد
الترحيل أفضل وقت للتخلص من الديون التقنية. راجع التصدير:
- احذف ملفات التنبيه والإشعارات التي لم تعد تشير إلى أحد؛
- استبدل معرّفات الكيانات المكتوبة بشكل ثابت (
HOST-…وSERVICE-…) بقواعد وسوم: فهي ستتغير في SaaS؛ - ادمج management zones المتكررة (انظر Management zones والوسم التلقائي)؛
- دوّن الكائنات التي لا توجد بالشكل نفسه في SaaS، مثل بعض لوحات المعلومات الكلاسيكية أو SLO، لإعادة إنشائها بأدوات المنصة.
الخطوة 4: نشر الإعدادات على SaaS
أضف البيئة الهدف إلى ملف manifest، ثم شغّل تجربة جافة أولًا:
environmentGroups:
- name: target
environments:
- name: saas-prod
url:
type: environment
value: SAAS_URL
auth:
token:
name: SAAS_TOKEN
export SAAS_URL="https://<env-id>.live.dynatrace.com"
monaco deploy manifest.yaml --environment saas-prod --dry-run
monaco deploy manifest.yaml --environment saas-prod
يتحقق --dry-run من الملفات والمراجع دون كتابة أي شيء. صحّح كل خطأ في المستودع لا في الواجهة: يجب أن يبقى الإعداد ككود مصدر الحقيقة.
الخطوة 5: إعادة توجيه الوكلاء، دفعة بعد دفعة
على المضيف يغيّر oneagentctl نقطة الاتصال دون إعادة تثبيت. اجلب environment ID وtenant token وعنوان الاتصال من بيئة SaaS، ثم:
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl \
--set-server=https://<env-id>.live.dynatrace.com/communication \
--set-tenant=<env-id> \
--set-tenant-token=<tenant-token> \
--restart-service
يجب أن ينتهي العنوان بـ /communication. العمليات المجهزة بعمق يجب إعادة تشغيلها لتبلّغ إلى البيئة الجديدة: خطّط لذلك مع فرق التطبيقات. وتبقى إعادة تثبيت نظيفة عبر أداة النشر لديك (Ansible مثلًا) خيارًا أسهل تدقيقًا للأساطيل الكبيرة.
أما في Kubernetes فلا يُعدَّل عنوان API في DynaKube في مكانه على الإصدارات الحديثة من Dynatrace Operator: احذف DynaKube والسر، وأعد إنشاء السر برموز SaaS، ثم أعد تطبيق DynaKube بقيمة apiUrl الجديدة. النشر الأولي مفصّل في ربط Dynatrace Operator بعنقود.
kubectl delete dynakube dynakube -n dynatrace
kubectl delete secret dynakube -n dynatrace
kubectl -n dynatrace create secret generic dynakube \
--from-literal="apiToken=<OPERATOR_TOKEN>" \
--from-literal="dataIngestToken=<DATA_INGEST_TOKEN>"
kubectl apply -f dynakube-saas.yaml
الخطوة 6: تحويل التكاملات
استبدل العنوان والرمز في كل عميل: مصدّرات OTLP وخطوط CI/CD ونصوص API وwebhooks الواردة. افعل ذلك بأسرار مُصدَّرة الإصدار في خزنتك، لا بقيم ثابتة في الشيفرة أبدًا. أبقِ عنقود Managed للقراءة طوال فترة المقارنة ومدة الاحتفاظ التاريخي التي تحتاجها.
كيف تتحقق من نجاح العملية
- الوكلاء: على المضيف يجب أن يعيد
oneagentctl --get-serverو--get-tenantقيم SaaS. وفي بيئة SaaS يظهر المضيف في قائمة المضيفين خلال دقائق. - الإعدادات: أعد تشغيل
monaco deploy --dry-run؛ يجب ألا يظهر أي فرق. قارن عدد ملفات التنبيه وmanagement zones بين المصدر والهدف. - البيانات: في Notebook على SaaS، عُدّ المضيفين الذين يرسلون مقاييس:
timeseries cpu = avg(dt.host.cpu.usage), by:{dt.entity.host}
| summarize hotes = count()
قارن هذا العدد بجرد الدفعة. الفرق يدل على مضيف منسي أو محجوب بجدار حماية صادر.
- التنبيه: أطلق تنبيهًا تجريبيًا وتحقق من وصوله إلى القناة الصحيحة. تنبيه لا يصل أسوأ من تنبيه مزعج.
أفضل الممارسات وأكثر الأخطاء شيوعًا
- جدار الحماية: يجب أن يصل المضيفون إلى بيئة SaaS (أو إلى ActiveGate يصل إليها) عبر HTTPS صادر. افتح التدفقات قبل الدفعة لا أثناءها.
- معرّفات الكيانات: كل ما يشير إلى معرّف مكتوب بشكل ثابت ينكسر. أما الوسوم ومحددات الكيانات فتبقى.
- الإرسال المزدوج: المضيف يبلّغ إلى بيئة واحدة فقط. وللمقارنة أبقِ مضيفين شاهدين على Managed بدل محاولة الإرسال المزدوج.
- الترخيص: نموذج الاستهلاك في SaaS يختلف عن عقد Managed لديك. اطلب التحقق من التقدير قبل دفعة الإنتاج.
- الجدول الزمني: تجنب فترات تجميد التغييرات وذروات النشاط. فدورات ترقية عنقود Managed تستمر أثناء الترحيل.
- التواصل: انشر حالة كل دفعة. الترحيل بلا لوم يُوثَّق كحادثة: ما نجح وما فاجأ وما سنغيّره للدفعة التالية.
الأسئلة الشائعة
هل يمكن استعادة سجل بيانات Managed التاريخي في SaaS؟
لا تبنِ خطتك على هذا الافتراض. خطّط للإبقاء على عنقود Managed متاحًا طوال مدة الاحتفاظ التي تحتاجها، واستفسر من Dynatrace عن الخيارات الخاصة بعقدك.
هل يجب إعادة تثبيت OneAgent؟
ليس بالضرورة. يكفي oneagentctl لإعادة توجيه وكيل متوافق. وتبقى إعادة التثبيت مفيدة إذا كان الوكيل قديمًا أو أردت استغلال الترحيل لتوحيد خيارات التثبيت.
Monaco أم Terraform للإعدادات؟
كلاهما يصدّر وينشر. Monaco أسرع غالبًا للتصدير الكبير؛ وTerraform مناسب إن كانت فرقك تدير بنيتها التحتية به أصلًا. اختر أداة واحدة مصدرًا للحقيقة لتفادي التعارضات.
الخلاصة
يُدار ترحيل Managed إلى SaaS كمشروع بنية تحتية: جرد، وإعداد ككود، ونقل على دفعات، وفحص قابل للقياس. صدّر بـ Monaco، ونظّف، وانشر تجريبيًا، ثم أعد توجيه الوكلاء على دفعات. أبقِ Managed للقراءة بالقدر اللازم: يجب ألا تنقطع الرؤية أبدًا أثناء الانتقال.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. شروط الترحيل والأدوات المقترحة وأسماء الشاشات تتغير: تحقق منها في الوثائق الرسمية ومع Dynatrace. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.