SLO Dynatrace Terraform: هدف لكل خدمة يُولَّد بالجملة

SLO Dynatrace Terraform: ولّد هدف توافر لكل خدمة من ملف YAML بواسطة for_each، وراجعه في merge request، في بيئتي SaaS وManaged.
SLO Dynatrace Terraform : un SLO pour chaque service, généré en masse

إنشاء ثلاثة أهداف SLO يدويًا أمر ممكن. أما ثمانون خدمة لكل منها هدف توافر، فهذا عمل رتيب (toil): نقرات متكررة، وأهداف تتباين، وأهداف تُنسى عند كل خدمة جديدة. إعداد SLO Dynatrace Terraform يحوّل هذا العمل اليدوي إلى قائمة خاضعة للتحكم بالإصدارات وتُراجَع في merge request.

هدف هذا الدرس التطبيقي توليد هدف توافر لكل خدمة انطلاقًا من ملف إعداد واحد، باستخدام مزوّد Terraform الخاص بـ Dynatrace وحلقة for_each، ثم التحقق من النتيجة. يعتمد المحتوى على أهداف SLO الكلاسيكية (Settings 2.0) المتاحة في Dynatrace Managed وDynatrace SaaS. ويشير قسم إلى خيار أهداف Grail الجديدة في SaaS.

قبل الأتمتة، تأكد أن مؤشراتك ذات معنى: راجع اختيار مؤشرات SLI.

المبدأ

  • ملف services.yaml يسرد الخدمات وهدف كل منها.
  • يقرأ Terraform هذا الملف بالدالة yamldecode وينشئ موردًا واحدًا لكل مدخل.
  • إضافة خدمة = إضافة ثلاثة أسطر ومرورها بمراجعة الشيفرة. وحذف سطر يحذف الـ SLO.

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

  • Terraform بالإصدار 1.5 أو أحدث.
  • المزوّد dynatrace-oss/dynatrace (سجل Terraform).
  • رمز API مميّز (API token) يحمل النطاقات (scopes) التي يتطلبها المورد dynatrace_slo_v2: slo.read وslo.write وsettings.read وsettings.write. تحقق من القائمة في وثائق المزوّد.
  • خدمات تحمل وسمًا مشتركًا، مثل service:checkout، تضعه قواعد الوسم لديك (راجع management zones والوسوم).

SLO Dynatrace Terraform: التوليد خطوة بخطوة

الخطوة 1: اضبط المزوّد

terraform {
  required_providers {
    dynatrace = {
      source = "dynatrace-oss/dynatrace"
    }
  }
}

provider "dynatrace" {}

يقرأ المزوّد العنوان والرمز من البيئة. لا تكتبهما أبدًا في الشيفرة:

# 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"

ثبّت إصدار المزوّد (version = "~> 1.x" مع الإصدار الذي اختبرته) لتجنب تغيير غير متوقع في المخطط.

الخطوة 2: صف الخدمات في ملف

# services.yaml
checkout:
  tag: "service:checkout"
  target: 99.9
  warning: 99.95
cart:
  tag: "service:cart"
  target: 99.5
  warning: 99.7
search:
  tag: "service:search"
  target: 99.5
  warning: 99.7

يصبح هذا الملف فهرس أهدافك. ويستطيع مالك المنتج (product owner) قراءته دون معرفة Terraform.

الخطوة 3: اكتب المورد باستخدام for_each

locals {
  services = yamldecode(file("${path.module}/services.yaml"))
}

resource "dynatrace_slo_v2" "availability" {
  for_each = local.services

  name               = "Disponibilité ${each.key}"
  enabled            = true
  custom_description = "Requêtes serveur sans erreur / requêtes. Géré par Terraform."
  evaluation_type    = "AGGREGATE"
  evaluation_window  = "-30d"
  filter             = "type(\"SERVICE\"),tag(\"${each.value.tag}\")"
  metric_name        = "availability_${replace(each.key, "-", "_")}"
  metric_expression  = "(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())"
  target_success     = each.value.target
  target_warning     = each.value.warning

  error_budget_burn_rate {
    burn_rate_visualization_enabled = true
    fast_burn_threshold             = 14.4
  }
}

الأسطر الحاسمة:

  • for_each = local.services: نسخة لكل مفتاح في YAML، يُشار إليها باسمها (dynatrace_slo_v2.availability["checkout"]). وعلى خلاف count، لا يؤدي حذف خدمة إلى إزاحة الخدمات الأخرى.
  • filter: محدد الكيانات يقصر الـ SLO على الخدمات التي تحمل الوسم. وعلامات الاقتباس الداخلية مهرَّبة.
  • metric_name: يجب أن يكون فريدًا؛ ويُستخدم لعرض الـ SLO كمقياس.
  • fast_burn_threshold: متوافق مع التنبيه السريع الموصوف في تنبيهات burn rate لـ SLO.

تتوقف أسماء السمات على إصدار المزوّد. والأسلم أن تنشئ SLO يدويًا، ثم تصدّره بأداة التصدير الخاصة بالمزوّد، ثم تقارنه بشيفرتك.

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

terraform init
terraform plan -out slo.plan
terraform apply slo.plan

يجب أن تعلن الخطة عن عملية إنشاء واحدة بالضبط لكل خدمة في YAML. راجعها في merge request قبل التطبيق، ويُفضَّل من خط معالجة CI.

وماذا عن أهداف Grail الجديدة في SaaS؟

في SaaS تُدار أهداف تطبيق Service-Level Objectives (المبنية على DQL) بمورد آخر من المزوّد، غير dynatrace_slo_v2. وقد تغير اسمه وسماته بين الإصدارات: راجع وثائق المزوّد قبل استخدامه. يبقى نمط for_each نفسه؛ وحده تعريف مؤشر SLI يتغير، باستعلام DQL مثل تلك الواردة في إنشاء SLO OpenTelemetry.

الخطوة 5: أضف هدف زمن استجابة إلى الفهرس نفسه

يمتد النمط نفسه إلى نوع ثانٍ من المؤشرات. أضف حقلًا اختياريًا latency_ms في YAML، ثم صفِّ الخريطة بحيث لا يُنشأ هدف زمن الاستجابة إلا للخدمات التي تعلن عنه:

locals {
  latency_services = {
    for name, svc in local.services : name => svc
    if try(svc.latency_ms, null) != null
  }
}

ثم يعيد مورد dynatrace_slo_v2 ثانٍ مع for_each = local.latency_services بناء الخطوة 3، مع تعبير مقياس لزمن الاستجابة يناسب إصدارك (تحقق من مقاييس زمن الاستجابة المتاحة في الوثائق). يبقى الفهرس واحدًا: خدمة واحدة، ومدخل واحد، وكل أهدافها فيه.

كيف تتأكد أن كل شيء يعمل

  1. يعرض الأمر terraform state list موردًا لكل خدمة: dynatrace_slo_v2.availability["cart"] وغيره.
  2. تعلن خطة terraform plan الثانية «No changes». وإلا فهناك سمة عدّلتها الواجهة البرمجية: طابق شيفرتك مع القيمة المعادة.
  3. في شاشة Service-level objectives يعرض كل SLO حالة وميزانية أخطاء لا «no data». وعبارة «no data» تدل في الغالب على وسم غائب أو مكتوب بشكل خاطئ في filter.

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

  • خزّن حالة Terraform في backend بعيد مع قفل، لا على جهاز شخصي.
  • امنع التعديل اليدوي للأهداف المُدارة: عبارة «Géré par Terraform» في الوصف تساعد الفريق.
  • نفّذ terraform plan كل ليلة في CI لاكتشاف الانحرافات.
  • أبقِ الأهداف في YAML لا في HCL: فالنقاش يدور حول الأهداف لا حول الشيفرة.
  • لبقية الأتمتة راجع الأتمتة عبر واجهة API الخاصة بالعنقود.

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

هل يمكن استيراد أهداف أُنشئت يدويًا؟

نعم، بكتلة import (Terraform 1.5 فما فوق) أو بالأمر terraform import، باستخدام معرّف الإعداد. أضف المدخل إلى YAML أولًا ليكون العنوان موجودًا.

كيف أولّد قائمة الخدمات تلقائيًا؟

يوفر المزوّد مصدر بيانات للكيانات يسرد الخدمات. وهو عملي، لكن هدفًا لكل خدمة دون مراجعة بشرية يُنتج سريعًا أهدافًا بلا مالك. فضّل ملف YAML تتم مراجعته.

هل تعمل هذه الشيفرة في Managed دون اتصال بالإنترنت؟

نعم، إن كان الجهاز الذي ينفّذ Terraform يصل إلى واجهة API الخاصة بالعنقود ويملك المزوّد في مرآة محلية.

الخلاصة

ملف YAML ومورد وحلقة for_each تكفي لمنح كل خدمة هدفًا، مع مراجعة للشيفرة وسجل للتغييرات. يختفي العمل الرتيب، وتصل كل خدمة جديدة ومعها هدفها منذ يومها الأول.

الخطوة التالية المقترحة: اربط هذا المستودع بخط CI، بخطة تلقائية على كل merge request وتطبيق يدوي بعد الموافقة. ابدأ بثلاث خدمات تجريبية، وتأكد أن الأهداف تعرض بيانات حقيقية، ثم افتح الفهرس للفرق الأخرى.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك، فميزات SaaS تتطور بسرعة.

Total
0
Shares
Leave a Reply

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

Previous Post
Choisir ses SLI : la méthode pratique, des requêtes DQL aux objectifs

اختيار مؤشرات SLI: الطريقة العملية من استعلامات DQL إلى الأهداف

Next Post
Budget d'erreur release gate : bloquer une mise en production avec Dynatrace (SaaS et Managed)

بوابة الإصدار وميزانية الأخطاء: امنع النشر في الإنتاج باستخدام Dynatrace (SaaS وManaged)

Related Posts