الوحدة 8 من مسار Dynatrace Managed التدريبي — أتمتة Dynatrace Managed بواجهة API البيئة وAPI العنقود: الانتقال من الإعدادات اليدوية إلى السكربتات والإعداد ككود.
المسار: Dynatrace Managed · الوحدة 8/8 · المدة: نحو 75 دقيقة · المستوى: متقدم
الأهداف:
- التمييز بين API البيئة وAPI العنقود ومعرفة أيهما يُستخدم.
- إنشاء رمز API مميّز بأقل نطاق ممكن وإجراء أولى الاستدعاءات.
- قراءة الكيانات والمقاييس والمشكلات من سكربت.
- فهم نهج الإعداد ككود (configuration as code) وأدواته.
المتطلبات المسبقة: الوحدات 1 إلى 7، وبيئة Managed للاختبار، وصلاحيات إنشاء رموز API، وجهاز عليه curl وjq، وإلمام بـ JSON وGit.
كل ما ضبطته يدويًا خلال هذا المسار (الوسوم، وmanagement zones، وملفات التنبيه، والبيئات) يمكن إنشاؤه وقراءته ومراقبته برمجيًا. تُخصَّص هذه الوحدة الأخيرة من مسار Dynatrace Managed لـ أتمتة Dynatrace Managed عبر API: العائلتان من واجهات API، والرموز المميّزة، وأولى السكربتات، ثم الانتقال إلى الإعداد ككود لإدارة نسخ إعداداتك كما تُدار نسخ شيفرة التطبيقات.
وهي تمتد مباشرة من الوحدة 7 التي تصلح فحوص التشغيل فيها مرشحة جيدة للأتمتة. ويلخّص فهرس المسار جميع الوحدات.
أتمتة Dynatrace Managed: أي واجهات API نستخدم؟
يوفّر نشر Managed عائلتين من واجهات API، بعنوانين ورمزين مميّزين مختلفين:
| API | العنوان الأساسي | الاستخدام |
|---|---|---|
| API البيئة (v1 وv2) | https://{your-domain}/e/{environment-id}/api/… |
بيانات بيئة وإعداداتها: الكيانات والمقاييس والمشكلات والإعدادات والرموز |
| API العنقود (v1 وv2) | https://{your-domain}/api/cluster/… |
إدارة العنقود: البيئات والعقد والمستخدمون والمجموعات والحصص |
قاعدة بسيطة: إذا تعلقت المهمة بما يُراقَب فهي API البيئة؛ وإذا تعلقت بالمنصة نفسها فهي API العنقود. ورموز إحداهما لا تعمل على الأخرى.
إنشاء رمز API بالنطاق المناسب
تُنشأ رموز البيئة في إعدادات البيئة، ورموز العنقود في CMC. في الحالتين، حدّد فقط الصلاحيات (scopes) اللازمة، وامنح الرمز اسمًا صريحًا («audit-lecture» أو «pipeline-config-recette»)، وخزّنه في خزنة أسرار، وليس أبدًا في مستودع Git. يُمرَّر الرمز في ترويسة HTTP:
Authorization: Api-Token {your-token}
تكفي في أولى استدعاءات هذه الوحدة رموز بيئة للقراءة فقط، بصلاحيات قراءة الكيانات والمقاييس والمشكلات والإعدادات. تظهر الأسماء الدقيقة في شاشة إنشاء الرمز.
قراءة البيانات بـ API البيئة
بعض الاستدعاءات المفيدة، تُكيَّف مع نطاقك ومعرّف بيئتك:
export DT_URL="https://{your-domain}/e/{environment-id}"
export DT_TOKEN="..." # load it from your secrets vault
# List monitored hosts
curl -s -H "Authorization: Api-Token $DT_TOKEN" \
"$DT_URL/api/v2/entities?entitySelector=type(%22HOST%22)" | jq '.entities[].displayName'
# List open or recent problems
curl -s -H "Authorization: Api-Token $DT_TOKEN" \
"$DT_URL/api/v2/problems" | jq '.problems[] | {title, severityLevel, status}'
# Query a metric
curl -s -H "Authorization: Api-Token $DT_TOKEN" \
"$DT_URL/api/v2/metrics/query?metricSelector=builtin:host.cpu.usage&from=now-2h"
الاستجابات الكبيرة مقسّمة إلى صفحات: اتبع مفتاح الصفحة التالية الذي تعيده API حتى النفاد. وتحقق أيضًا من رمز HTTP لكل استدعاء في سكربتاتك، فالرمز 401 أو 403 يدل غالبًا على رمز غير صالح أو صلاحية ناقصة.
الإدارة بـ API العنقود
تُستخدم API العنقود خصوصًا لتصنيع إنشاء البيئات وإدارة المجموعات وفحص حالة العقد قبل الصيانة. استدعاء أول نموذجي هو سرد البيئات:
curl -s -H "Authorization: Api-Token $CLUSTER_TOKEN" \
"https://{your-domain}/api/cluster/v2/environments" | jq
اكتب سكربتاتك بطريقة تكرارية آمنة (idempotent): تحقق من وجود الكائن قبل إنشائه، كي تعيد تشغيل السكربت دون آثار جانبية. يعرض المقال أتمتة الإدارة بواجهة API العنقود في Dynatrace Managed عدة سيناريوهات كاملة.
الانتقال إلى الإعداد ككود
تُظهر الاستدعاءات المفردة حدودها سريعًا: يجب إدارة ترتيب الإنشاء والتبعيات (ملف تنبيه يشير إلى management zone) وانتقال الإعداد من بيئة إلى أخرى. يلبّي الإعداد ككود هذه الحاجات: يُوصَف الإعداد في ملفات مؤرَّخة النسخ، تُراجَع في مراجعة الشيفرة وتُطبَّق بأداة.
| الأداة | المبدأ | متى تُختار |
|---|---|---|
| Monaco (Dynatrace Configuration as Code) | أداة سطر أوامر مفتوحة المصدر تصونها Dynatrace، إعدادات بصيغتي YAML وJSON، ونشر إلى بيئة أو أكثر | فرق تريد أداة مخصصة لـ Dynatrace |
| مزوّد Terraform لـ Dynatrace | موارد Terraform لإعداد Dynatrace | مؤسسات تستخدم Terraform أصلًا |
| سكربتات داخلية | استدعاءات API مباشرة | حاجات عابرة أو بالغة الخصوصية |
قبل الاختيار، تحقق في وثائق كل أداة من توافقها مع إصدار Managed لديك وأنواع الإعدادات المدعومة. وفي كل الأحوال، المخطط المستهدف واحد: مستودع Git، ومراجعة، وخط معالجة يطبّق أولًا في الاختبار ثم في الإنتاج.
dynatrace-config-repo/
├── test/
│ ├── management-zones/
│ ├── auto-tagging/
│ └── alerting-profiles/
└── prod/
└── ...
بالنسبة إلى الوسوم والمناطق، يبيّن المقال Management zones والوسم التلقائي كيف تُنشأ عبر API الإعدادات.
تمرين عملي
الخطوة 1 — أنشئ رمزًا للقراءة فقط
في بيئة الاختبار، أنشئ رمزًا باسم formation-lecture بصلاحيات قراءة فقط (الكيانات والمقاييس والمشكلات).
النتيجة المتوقعة: رمز يُعرض مرة واحدة فقط، تحفظه في مدير الأسرار لديك.
الخطوة 2 — اسرد المضيفات
نفّذ استدعاء entities أعلاه.
النتيجة المتوقعة: قائمة أسماء المضيفات، مطابقة لما في الواجهة.
الخطوة 3 — أنتج تقرير مشكلات
كيّف استدعاء problems لإخراج ملف CSV (العنوان والخطورة والحالة) بالأمر jq -r.
النتيجة المتوقعة: ملف مقروء في جدول بيانات، يمكنك إرساله كل اثنين.
الخطوة 4 — تحقق من الصلاحيات
جرّب عملية كتابة (مثل إنشاء إعداد) بالرمز نفسه.
النتيجة المتوقعة: رفض (الرمز 403)، دليل على أن نطاق الرمز محدود فعلًا.
الخطوة 5 — صدّر إعدادًا
باستخدام Monaco أو مزوّد Terraform، وفق وثائقهما، صدّر management zones بيئة الاختبار إلى مستودع Git محلي.
النتيجة المتوقعة: ملفات تصف مناطقك، جاهزة للمراجعة وإعادة التطبيق.
اختبار قصير
- أي API تستخدم لإنشاء بيئة جديدة؟
أ. API البيئة · ب. API العنقود · ج. API OneAgent - كيف يُمرَّر الرمز عند الاستدعاء؟
أ. في الترويسةAuthorization: Api-Token …· ب. في اسم النطاق · ج. في كوكي جلسة الواجهة - يتلقى سكربت الرمز 403. ما السبب الأرجح؟
أ. العنقود مطفأ · ب. الرمز لا يملك الصلاحية المطلوبة · ج. المقياس غير موجود - ما الإسهام الرئيسي للإعداد ككود؟
أ. يحل محل المراقبة · ب. يؤرِّخ النسخ ويراجع ويعيد تشغيل الإعداد بصورة قابلة للتكرار · ج. يلغي الحاجة إلى الرموز
الإجابات
- ب. إنشاء البيئات من شؤون إدارة العنقود.
- أ. تحمل الترويسة
AuthorizationبالبادئةApi-Tokenالرمز. - ب. يدل 403 على رفض الوصول، وغالبًا ما يكون سببه صلاحية غائبة عن الرمز.
- ب. الملفات المؤرَّخة النسخ تجعل كل تغيير قابلًا للتتبع والتكرار من بيئة إلى أخرى.
للتعمق
- أتمتة الإدارة بواجهة API العنقود في Dynatrace Managed
- إدارة عدة بيئات وحصص الترخيص في CMC
- Management zones والوسم التلقائي: تنظيم بيئة مشتركة
- الوثائق الرسمية لـ Dynatrace Managed: docs.dynatrace.com/managed (أقسام API البيئة وAPI العنقود والإعداد ككود)
← الوحدة 7: تشغيل العنقود · فهرس المسار →
الأسئلة الشائعة
هل نفضّل API v2 على v1؟
للسكربتات الجديدة، نعم عندما يوجد المكافئ في v2. تبقى بعض عمليات الإعداد متاحة في v1 فقط بحسب الإصدار: تحقق في وثائق إصدارك.
هل يمكن استخدام الرمز نفسه لكل شيء؟
لا يُنصح بذلك. رمز لكل استخدام، بأقل نطاق، يحد من أثر التسرب ويسهّل التدوير.
هل تعمل السكربتات المكتوبة لـ Managed في SaaS؟
جزء من واجهات API البيئة مشترك، لكن منصة SaaS من الجيل الأحدث توفر آليات أخرى وليس فيها API عنقود. يعرضها مسار Dynatrace SaaS على حدة.
تختتم هذه الوحدة المسار: صرت تعرف الآن كيف تثبّت بيئة Dynatrace Managed وتنشرها وتستكشفها وتنبّه فيها وتنظّمها وتشغّلها وتؤتمتها. عد إلى الفهرس لمراجعة وحدة أو للتحضير لشهادة رسمية.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. لا يحل هذا المسار محل الدورات والشهادات الرسمية في Dynatrace University. تحقق من الميزات في الوثائق الرسمية الخاصة بإصدارك.