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

Terraform Dynatrace خطوة بخطوة: المزوّد وmanagement zone وملف التنبيه ولوحة المعلومات وتصدير الموجود واكتشاف الانجراف في SaaS وManaged.
Provider Terraform Dynatrace : alerting, management zones et tableaux de bord

بنيتك التحتية موصوفة أصلًا بـ Terraform: الشبكات والعناقيد وقواعد البيانات. لكن قابلية الملاحظة ما زالت تُضبط يدويًا، شاشة بعد شاشة. مع مزوّد (provider) Terraform Dynatrace تنضم ملفات التنبيه ومناطق الإدارة (management zones) ولوحات المعلومات إلى المستودع نفسه، وإلى plan نفسه ومراجعة الشيفرة نفسها كبقية المنصة.

بالنسبة إلى فريق SRE المكسب مباشر: خدمة جديدة تصل مع تنبيهاتها ولوحة معلوماتها في merge request واحدة، ويزول الانجراف بين البيئات، ويتم التراجع بـ git revert. عبء أقل، وتنبيهات يتيمة أقل، وزمن حل (MTTR) لا يعتمد على ذاكرة أحد.

هدف هذا الدرس: إعداد المزوّد، وإنشاء management zone وملف تنبيه ولوحة معلومات، ثم استيراد الموجود بأداة التصدير. يستهدف المزوّد Dynatrace SaaS وDynatrace Managed؛ وبعض الموارد، كمستندات المنصة (لوحات المعلومات الجديدة)، مخصصة لـ SaaS. وتوضح كل خطوة ذلك.

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

  • Terraform مثبتًا (إصدار حديث) وواجهة خلفية (backend) لحالة مشتركة (S3 أو GCS أو Terraform Cloud…): يجب ألا تبقى الحالة (state) على جهاز أبدًا.
  • رمز API بالصلاحيتين settings.read وsettings.write لموارد Settings 2.0 (التنبيه ومناطق الإدارة)، إضافة إلى ReadConfig وWriteConfig للوحات المعلومات الكلاسيكية.
  • في SaaS، للمستندات: عميل OAuth بالأذونات document:documents:read وdocument:documents:write وdocument:documents:delete وdocument:trash.documents:delete.

إن كانت أهداف SLO لديك تُدار أصلًا بـ Terraform فالنهج نفسه؛ وهنا نركّز على التنبيه وبنية البيئة.

إعداد مزوّد Terraform Dynatrace

الخطوة 1: أعلن المزوّد

# providers.tf
terraform {
  required_providers {
    dynatrace = {
      source  = "dynatrace-oss/dynatrace"
      version = "~> 1.0"
    }
  }
}

provider "dynatrace" {}

تبقى كتلة provider فارغة: يُقرأ العنوان والرمز من متغيرات البيئة، ولا يُكتبان في الشيفرة أبدًا.

# SaaS
export DYNATRACE_ENV_URL="https://<env-id>.live.dynatrace.com"
# Managed
# export DYNATRACE_ENV_URL="https://<votre-domaine>/e/<env-id>"
export DYNATRACE_API_TOKEN="dt0c01.XXXX"

# SaaS uniquement, pour dynatrace_document
export DT_CLIENT_ID="dt0s02.XXXX"
export DT_CLIENT_SECRET="dt0s02.XXXX.YYYY"
export DT_ACCOUNT_ID="urn:dtaccount:<uuid>"

terraform init

الخطوة 2: أنشئ management zone

تحصر منطقة الإدارة العرض والتنبيه في نطاق محدد. هنا، كل ما ينتمي إلى عنقود Kubernetes المسمى prod-eu الذي يراقبه Dynatrace Operator (راجع ربط Dynatrace Operator بعنقود):

# zones.tf
resource "dynatrace_management_zone_v2" "prod_eu" {
  name = "k8s-prod-eu"
  rules {
    rule {
      type            = "ME"
      enabled         = true
      entity_selector = ""
      attribute_rule {
        entity_type = "CLOUD_APPLICATION_NAMESPACE"
        attribute_conditions {
          condition {
            case_sensitive = false
            key            = "KUBERNETES_CLUSTER_NAME"
            operator       = "EQUALS"
            string_value   = "prod-eu"
          }
        }
      }
    }
  }
}

يشير type = "ME" إلى قاعدة على كيانات مراقَبة (monitored entities). ويُفصَّل اختيار القواعد والوسوم التي تبني مناطقك في Management zones والوسم التلقائي.

الخطوة 3: أنشئ ملف تنبيه

# alerting.tf
resource "dynatrace_alerting" "paiement" {
  name            = "Paiement - production"
  management_zone = ""
  rules {
    rule {
      include_mode     = "INCLUDE_ALL"
      tags             = ["team:paiement", "env:production"]
      delay_in_minutes = 0
      severity_level   = "AVAILABILITY"
    }
    rule {
      include_mode     = "INCLUDE_ALL"
      tags             = ["team:paiement", "env:production"]
      delay_in_minutes = 10
      severity_level   = "PERFORMANCE"
    }
  }
}

الأسطر الحاسمة: severity_level يختار عائلة المشكلات، وdelay_in_minutes المهلة قبل الإشعار. انقطاع التوافر يُبلَّغ عنه فورًا؛ وتدهور الأداء ينتظر عشر دقائق، ما يصفّي الذروات القصيرة ويقلل ضجيج المناوبة. يصفّي الملف بالوسوم لا بالمنطقة، كما توصي وثائق المزوّد. اربطه بعد ذلك بتكامل إشعارات (راجع ملفات التنبيه وتكاملات الإشعارات).

الخطوة 4: أنشئ لوحة معلومات

في SaaS لوحات معلومات المنصة مستندات (documents):

# dashboards.tf (SaaS)
resource "dynatrace_document" "paiement" {
  type    = "dashboard"
  name    = "Paiement - santé"
  content = file("${path.module}/dashboards/paiement.json")
}

أبسط طريقة للحصول على JSON: ابنِ لوحة المعلومات في الواجهة، ثم نزّل محتواها وضعه في dashboards/. فيحتفظ المستودع بنسخة مقروءة من كل بلاطة وكل استعلام DQL.

وفي Managed (وللوحات المعلومات الكلاسيكية في SaaS) استخدم المورد dynatrace_json_dashboard:

resource "dynatrace_json_dashboard" "paiement" {
  contents = file("${path.module}/dashboards/paiement-classic.json")
}

الخطوة 5: خطّط ثم طبّق

terraform fmt -check
terraform validate
terraform plan -out=tfplan
terraform apply tfplan

اقرأ الـ plan كما تقرأ مراجعة شيفرة: سطر -/+ (حذف ثم إعادة إنشاء) على ملف تنبيه في الإنتاج يستحق سؤالًا قبل apply.

الخطوة 6: استورد الموجود

يضم الملف التنفيذي للمزوّد أداة تصدير تولّد HCL انطلاقًا من بيئة موجودة. تُستدعى مباشرة لا عبر terraform:

./terraform-provider-dynatrace -export dynatrace_alerting dynatrace_management_zone_v2

أضف -import-state لتوليد الحالة أيضًا، حتى يعدّ Terraform الكائنات مُدارة أصلًا. راجع الشيفرة المولَّدة قبل دمجها: فهي تعكس الموجود بما فيه من تناقضات. وتُستثنى لوحات المعلومات من التصدير افتراضيًا ويجب طلبها صراحة.

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

  • ينتهي terraform apply بالعبارة Apply complete! وبعدد الموارد المتوقع.
  • يعرض terraform plan الثاني No changes: البيئة مطابقة للشيفرة.
  • في Dynatrace تظهر منطقة الإدارة k8s-prod-eu في الإعدادات وتصفّي فعلًا مساحات أسماء العنقود؛ ويسرد ملف «Paiement – production» قاعدتيه.
  • عبر API يوجد الملف تحت المخطط builtin:alerting.profile:
curl -s -H "Authorization: Api-Token $DYNATRACE_API_TOKEN" \
  "$DYNATRACE_ENV_URL/api/v2/settings/objects?schemaIds=builtin:alerting.profile&fields=value" \
  | jq '.items[].value.name'

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

  • اكتشاف الانجراف: شغّل terraform plan كل ليلة في CI. الخطة غير الفارغة تدل على تعديل يدوي.
  • أداة واحدة لكل كائن: ملف تنبيه يديره Terraform يجب ألا يديره Monaco أو الواجهة أيضًا.
  • وحدات (modules) لكل فريق: وحدة «خدمة» تنشئ المنطقة والملف ولوحة المعلومات من بضعة متغيرات تضمن أن كل خدمة جديدة تبدأ بتنبيه سليم.
  • الأسرار خارج الشيفرة: متغيرات بيئة في CI، وحالة مشفرة، ولا رمز في ملف .tfvars مُدار بالإصدارات.
  • بيانات حساسة في الحالة: قد تحتوي الحالة قيم إعداد؛ قيّد الوصول إليها كما تقيّد سرًّا.

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

هل يعمل مزوّد Terraform Dynatrace مع Managed؟

نعم لمعظم موارد الإعداد وSettings 2.0، بعنوان بالصيغة https://<domaine>/e/<env-id>. أما موارد منصة SaaS، مثل dynatrace_document، فلا تنطبق على Managed.

لماذا تريد الخطة إعادة إنشاء مورد دون تغيير؟

غالبًا لأن حقلًا محسوبًا من جهة الخادم يختلف عن القيمة المكتوبة (ترتيب قائمة أو قيمة افتراضية). طابق الشيفرة مع القيمة التي يعيدها التصدير، ثم أعد تشغيل الخطة.

هل أفضّل Monaco؟

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

الخلاصة

مع Terraform Dynatrace يتبع التنبيه وبنية البيئة دورة البنية التحتية نفسها: شيفرة، خطة، مراجعة، تطبيق. ابدأ بتصدير الموجود، وثبّت وحدة أولى لخدمة، ثم فعّل اكتشاف الانجراف. فتصبح قابلية الملاحظة قابلة للتكرار، وتجهز بيئة جديدة بأمر apply واحد.

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

Total
0
Shares
Leave a Reply

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

Previous Post
Dynatrace Monaco : la configuration en code, pas à pas

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

Next Post
Intégration Dynatrace AWS : CloudWatch, métriques et logs pas à pas

تكامل Dynatrace AWS: CloudWatch والمقاييس والسجلات خطوة بخطوة

Related Posts