Dynatrace Monaco: الإعداد كشيفرة خطوة بخطوة

Dynatrace Monaco خطوة بخطوة: المانيفست وdownload وملف تنبيه مُعَلْمَن وdry-run والنشر عبر CI والحذف النظيف، لـ SaaS وManaged.
Dynatrace Monaco : la configuration en code, pas à pas

ملف تنبيه (alerting profile) عُدّل يدويًا في الإنتاج، وآخر نُسي في بيئة ما قبل الإنتاج، ولا أحد يعرف من غيّر ماذا. يحل Dynatrace Monaco (Monitoring as Code) هذه المشكلة: إعدادات بيئاتك تعيش في ملفات YAML وJSON مُدارة بالإصدارات في Git، تُراجَع في merge request وتُنشر عبر CI كأي شيفرة أخرى.

بالنسبة إلى فريق SRE الرهان ملموس. الإعداد القابل للتكرار يقلل الانجراف (drift) بين البيئات، ويجعل كل تغيير قابلًا للتراجع، ويلغي عبء الضبط اليدوي المتكرر على عشر بيئات. وعند الحادثة يجيب git log عن سؤال «ما الذي تغيّر؟» في ثوان.

هدف هذا الدرس: تثبيت CLI، وتنزيل إعداد موجود، وإنشاء ملف تنبيه مُعَلْمَن (parameterized)، ونشره تجريبيًا ثم فعليًا، ودمجه في مسار CI. يعمل Monaco مع Dynatrace SaaS وDynatrace Managed لواجهات الإعداد الكلاسيكية وSettings 2.0؛ أما كائنات المنصة (workflows والمستندات والـ buckets وSLO الحديثة) فتخص SaaS وحده.

Dynatrace Monaco: الملفات الثلاثة التي يجب معرفتها

الملف الدور
manifest.yaml يعلن المشاريع (مجلدات الإعداد) والبيئات الهدف، مع عناوينها وأسماء المتغيرات التي تحتوي الأسرار
config.yaml داخل كل مجلد مشروع: قائمة الإعدادات ونوعها (API كلاسيكية، مخطط Settings 2.0، workflow…) ومعاملاتها
قالب JSON جسم الكائن، مع متغيرات {{ .nom }} تُستبدل بالمعاملات عند النشر

يفصل هذا التقسيم ما يتغير من بيئة إلى أخرى (المعاملات) عمّا لا يتغير (القالب).

المتطلبات المسبقة

  • واجهة الأوامر monaco الإصدار 2.x، المنزَّلة من إصدارات (releases) المستودع Dynatrace/dynatrace-configuration-as-code.
  • رمز API بالنطاقات المناسبة للكائنات المُدارة: على الأقل settings.read وsettings.write لـ Settings 2.0، وReadConfig وWriteConfig للواجهات الكلاسيكية. وفي SaaS عميل OAuth أو platform token لكائنات المنصة.
  • مستودع Git ومنفّذ (runner) CI قادر على قراءة متغيرات سرية.

الرمز المرفوض يُنتج أخطاء 401 أو 403 قليلة الوضوح في مخرجات Monaco: يذكّر دليل أتمتة الإدارة عبر API بكيفية اختبار الرمز قبل استخدامه.

درس تطبيقي خطوة بخطوة

الخطوة 1: ثبّت CLI

# Linux amd64 : remplacez <version> par la dernière release publiée
curl -L -o monaco https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/download/v<version>/monaco-linux-amd64
chmod +x monaco
sudo mv monaco /usr/local/bin/
monaco version

الخطوة 2: اكتب المانيفست (manifest)

manifestVersion: 1.0
projects:
  - name: alerting
environmentGroups:
  - name: preprod
    environments:
      - name: preprod
        url:
          type: environment
          value: DT_PREPROD_URL
        auth:
          token:
            name: DT_PREPROD_TOKEN
  - name: prod
    environments:
      - name: prod
        url:
          type: environment
          value: DT_PROD_URL
        auth:
          token:
            name: DT_PROD_TOKEN

السطر الحاسم: type: environment. القيمة ليست العنوان بل اسم المتغير الذي يحتويه. والمنطق نفسه لـ token.name. لذلك يمكن إيداع الملف في Git بلا أسرار. في Managed يكون العنوان بالصيغة https://<domaine>/e/<env-id>، وفي SaaS https://<env-id>.live.dynatrace.com.

الخطوة 3: ابدأ من الموجود بالأمر download

بدل كتابة قالب من الصفر، نزّل كائنًا موجودًا للحصول على الصيغة الصحيحة:

export DT_PREPROD_URL="https://<env-id>.live.dynatrace.com"
export DT_PREPROD_TOKEN="dt0c01.XXXX"
monaco download --manifest manifest.yaml --environment preprod \
  --settings-schema builtin:alerting.profile \
  --output-folder download

يكتب Monaco مجلد مشروع فيه config.yaml وملف JSON لكل كائن. ولا يستخرج إلا قيمة الكائن، دون بيانات API الوصفية.

الخطوة 4: عَلْمِن الإعداد

انسخ الكائن المنزَّل إلى alerting/ واستبدل القيم الخاصة بالفريق بمتغيرات. ملف config.yaml:

configs:
  - id: profil-equipe-paiement
    type:
      settings:
        schema: builtin:alerting.profile
        scope: environment
    config:
      name: Paiement - production
      template: profil.json
      parameters:
        equipe: paiement

والقالب profil.json، مبسَّطًا من الملف المنزَّل:

{
  "name": "{{ .name }}",
  "severityRules": [
    {
      "severityLevel": "AVAILABILITY",
      "delayInMinutes": 0,
      "tagFilterIncludeMode": "INCLUDE_ALL",
      "tagFilter": ["team:{{ .equipe }}"]
    }
  ],
  "eventFilters": []
}

يُعرض الحقل name من config.yaml على القالب باسم {{ .name }}، وكل إدخال في parameters يُعرض باسمه. أبقِ أسماء الخصائص كما أنتجها download تمامًا: فمخطط Settings 2.0 هو المرجع. تفترض قاعدة الوسم أن الوسم متسق، راجع Management zones والوسم التلقائي.

الخطوة 5: تحقق ثم انشر

monaco deploy manifest.yaml --environment preprod --dry-run
monaco deploy manifest.yaml --environment preprod

يتحقق الوضع --dry-run من الصياغة والمراجع والمعاملات دون استدعاء API للكتابة. أما النشر الفعلي فينشئ الكائن أو يحدّثه إن وُجد: يجد Monaco الكائن بفضل معرّف خارجي مشتق من المشروع وid الإعداد. لذلك لا تنتج إعادة تشغيل الأمر نسخة مكررة.

الخطوة 6: اربط CI

# .gitlab-ci.yml (extrait)
monaco-preprod:
  stage: deploy
  script:
    - monaco deploy manifest.yaml --environment preprod --dry-run
    - monaco deploy manifest.yaml --environment preprod
  rules:
    - if: $CI_COMMIT_BRANCH == "main"

monaco-prod:
  stage: deploy
  script:
    - monaco deploy manifest.yaml --environment prod
  when: manual

تأتي المتغيرات DT_PREPROD_* وDT_PROD_* من أسرار مشروع CI. ويبقى الإنتاج يدويًا: يعتمده إنسان بعد أن يرى بيئة ما قبل الإنتاج تعمل جيدًا.

الخطوة 7: احذف بطريقة نظيفة

إزالة إدخال من config.yaml لا تحذف شيئًا في Dynatrace. أدرج الكائن في ملف delete.yaml:

delete:
  - project: alerting
    type: builtin:alerting.profile
    id: profil-equipe-paiement
monaco delete --manifest manifest.yaml --file delete.yaml --environment preprod

كيف تتحقق من أنه يعمل

  • ينتهي مخرج monaco deploy دون خطأ ويسرد الإعداد المنشور.
  • في البيئة، افتح إعدادات ملفات التنبيه: يجب أن يوجد ملف «Paiement – production» بالقاعدة المتوقعة.
  • عبر API يظهر الكائن تحت المخطط:
curl -s -H "Authorization: Api-Token $DT_PREPROD_TOKEN" \
  "$DT_PREPROD_URL/api/v2/settings/objects?schemaIds=builtin:alerting.profile&fields=objectId,value" | jq '.items[].value.name'
  • أعد تشغيل monaco deploy: يجب أن تكون النتيجة مطابقة، دون كائن جديد.

أفضل الممارسات

  • مصدر حقيقة واحد: الكائن الذي يديره Monaco لا يُعدَّل يدويًا بعد ذلك. أعلن ذلك، أو الأفضل قيّد صلاحيات الكتابة في الواجهة.
  • مشاريع صغيرة: مجلد لكل مجال (التنبيه والوسم واكتشاف الشذوذ) ولكل فريق مالك. فتبقى المراجعات مقروءة.
  • dry-run بصورة منتظمة في merge request: يظهر الخطأ قبل الدمج لا أثناء النشر.
  • اكتشاف الانجراف: download مجدول يُقارَن بالمستودع يكشف التغييرات التي جرت خارج Git.
  • تنبيه متسق: يجب أن تبقى الملفات المنشورة متوافقة مع تكاملات الإشعارات، وإلا ذهب التنبيه إلى الفراغ.

الأسئلة الشائعة

هل يعمل Monaco مع Dynatrace Managed؟

نعم لواجهات الإعداد الكلاسيكية وكائنات Settings 2.0، برمز API. أما الأنواع الخاصة بمنصة SaaS (workflows والمستندات وbuckets في Grail) فلا تنطبق على Managed.

Monaco أم Terraform؟

يتمحور Monaco حول Dynatrace، بنموذج مشاريع وبيئات سهل التعلم. ويناسب Terraform إن كانت فرقك تستخدمه أصلًا لبقية البنية التحتية. والأهم ألا تدير الكائن نفسه بالأداتين.

كيف أدير الأسرار في القوالب؟

أعلن معاملًا من النوع environment يقرأ متغير بيئة عند النشر. فلا يمر السر أبدًا عبر مستودع Git.

الخلاصة

مع Dynatrace Monaco يصبح الإعداد شيفرة: مانيفست ومشاريع وقوالب مُعَلْمَنة وdry-run في merge request ونشر عبر CI. ابدأ بمجال بسيط كملفات التنبيه ثم وسّع. فيصبح كل تغيير قابلًا للتتبع والتراجع ومتطابقًا بين البيئات.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لمالكها. خيارات CLI والمخططات تتطور: تحقق منها في الوثائق الرسمية لـ Monaco.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Pods en CrashLoopBackOff OOMKilled : diagnostiquer avec Dynatrace

CrashLoopBackOff OOMKilled: تشخيص الـ Pods باستخدام Dynatrace

Next Post
Provider Terraform Dynatrace : alerting, management zones et tableaux de bord

مزوّد Terraform Dynatrace: التنبيه ومناطق الإدارة ولوحات المعلومات

Related Posts