أثناء الحوادث، يفتح المناوب dashboard Dynatrace Managed فيجد عشرين بلاطة بلا تراتبية: رسوم افتراضية، ومضيفون من كل البيئات مختلطون، ولا معالم تخص SLO. تضيع عشر دقائق في البحث عن العرض المناسب، ويطول MTTR بالقدر نفسه.
يوضح هذا الدليل كيف تبني لوحات معلومات كلاسيكية مفيدة على Dynatrace Managed: بلاطات أصلية، ورسوم Data Explorer بمحددات مقاييس builtin: دقيقة، وترشيحًا بمناطق الإدارة (management zones)، ثم تصديرًا واستيرادًا بصيغة JSON عبر واجهة Configuration API لإدارة إصداراتها.
الهدف: الخروج بثلاث لوحات كاملة موصوفة بلاطة بلاطة (صحة التطبيق، والمضيفون، وعرض التشغيل)، وبطريقة لتهيئتها دون نقرات. المحتوى موجه إلى Dynatrace Managed؛ واللوحات الكلاسيكية وConfiguration API موجودة أيضًا في Dynatrace SaaS، ولا يتغير فيهما سوى عنوان URL.
المتطلبات
- بيئة Dynatrace Managed مع OneAgent منشور على المضيفين والخدمات المراد متابعتها.
- مناطق إدارة جاهزة (انظر مناطق الإدارة والوسوم): تعمل مرشحًا لكل لوحة.
- للـ API: رمز (token) بالنطاق
ReadConfig(قراءة وتصدير) وWriteConfig(إنشاء وتحديث وتحقق). - عنوان البيئة بصيغة Managed:
https://{votre-domaine}/e/{id-environnement}. - أهداف SLO معرّفة مسبقًا إن أردت بلاطة SLO من المثال 3.
لبنات dashboard Dynatrace Managed
اللوحة الكلاسيكية شبكة من البلاطات. لكل بلاطة نوع (tileType) وموضع (bounds: top وleft وwidth وheight بالبكسل) وعند الحاجة مرشح خاص (tileFilter) يحل محل مرشح اللوحة.
| نوع البلاطة | الاستخدام |
|---|---|
HEADER |
عنوان قسم لهيكلة الشبكة |
HOSTS وSERVICES وAPPLICATIONS |
الصحة العامة لعائلة من الكيانات، قابلة للترشيح بمنطقة إدارة |
DATA_EXPLORER |
رسم مبني في Data Explorer انطلاقًا من محدد مقاييس |
OPEN_PROBLEMS |
المشكلات المفتوحة التي اكتشفها Davis |
SLO |
حالة SLO وميزانية أخطائه |
MARKDOWN |
نص حر: رابط دليل التشغيل وجهات اتصال المناوبة |
على مستوى اللوحة، يحدد dashboardMetadata.dashboardFilter منطقة الإدارة والنطاق الزمني الافتراضي (مثلًا l_2_HOURS أو l_72_HOURS). ويضيف الحقل dynamicFilters.filters مرشحات يغيّرها القارئ مباشرة، مثل SERVICE_TYPE أو HOST_TAG_KEY:<tag> أو KUBERNETES_CLUSTER.
بناء بلاطة باستخدام Data Explorer
- افتح Data Explorer من القائمة، وابحث عن المقياس (مثلًا CPU usage %).
- اختر التجميع والتقسيم (Split by) والمرشحات، أو انتقل إلى المحرر المتقدم لإدخال المحدد مباشرة.
- اختر التصوّر (رسم أو قيمة وحيدة أو جدول أو top list)، ثم Pin to dashboard واللوحة المستهدفة.
- على اللوحة، حرّر البلاطة لتمنحها اسمًا معبّرًا، وعند الحاجة منطقة إدارة خاصة بها.
يتبع المحدد صيغة Metrics v2: مفتاح المقياس، ثم تحويلات متسلسلة بالرمز :. مثال موثّق: builtin:host.cpu.user:sort(value(max,descending)):limit(10) لأكثر عشرة مضيفين تحميلًا. وللتوسع في الاستكشاف انظر وحدة استكشاف البيانات.
المثال 1: صحة التطبيق
الهدف: معرفة خلال عشر ثوانٍ هل تحقق خدمات تطبيق ما مؤشرات SLI لديها (زمن الاستجابة والأخطاء ومعدل المعالجة). مرشح اللوحة: منطقة إدارة التطبيق، والنطاق Last 2 hours.
| البلاطة | النوع | المحدد أو الإعداد |
|---|---|---|
| «Services» | HEADER |
عنوان قسم |
| صحة الخدمات | SERVICES |
المرشح: منطقة إدارة التطبيق |
| زمن الاستجابة الوسيط | DATA_EXPLORER، رسم |
builtin:service.response.time:splitBy("dt.entity.service"):median |
| زمن الاستجابة p90 | DATA_EXPLORER، رسم |
builtin:service.response.time:splitBy("dt.entity.service"):percentile(90) |
| معدل الأخطاء | DATA_EXPLORER، top list |
builtin:service.errors.total.rate:splitBy("dt.entity.service"):avg:sort(value(avg,descending)):limit(10) |
| معدل المعالجة | DATA_EXPLORER، رسم |
builtin:service.requestCount.total:splitBy("dt.entity.service"):auto |
الأسطر الحرجة: يُعبَّر عن builtin:service.response.time بالميكروثانية، ويحوّل Data Explorer العرض. ومعدل الأخطاء builtin:service.errors.total.rate نسبة مئوية أصلًا ولا يقبل إلا auto وavg. أما العداد builtin:service.requestCount.total فلا يقبل إلا auto وvalue: لا تطبّق عليه avg. ويلائم p90 التجربة الفعلية أكثر من المتوسط.
المثال 2: المضيفون
الهدف: رصد المضيفين المشبعين قبل أن يتسببوا بمشكلة. المرشح: منطقة إدارة فريق البنية التحتية، والنطاق Last 24 hours.
| البلاطة | النوع | المحدد أو الإعداد |
|---|---|---|
| صحة المضيفين | HOSTS |
المرشح: منطقة الإدارة |
| أعلى 10 في CPU | DATA_EXPLORER، top list |
builtin:host.cpu.usage:splitBy("dt.entity.host"):avg:sort(value(avg,descending)):limit(10) |
| أعلى 10 في الذاكرة | DATA_EXPLORER، top list |
builtin:host.mem.usage:splitBy("dt.entity.host"):max:sort(value(max,descending)):limit(10) |
| الأقراص الأكثر امتلاءً | DATA_EXPLORER، جدول |
builtin:host.disk.usedPct:splitBy("dt.entity.host"):max:sort(value(max,descending)):limit(10) |
| التوافر | DATA_EXPLORER، رسم |
builtin:host.availability (التجميع الافتراضي) |
مقاييس الموارد الثلاثة نسب مئوية وتقبل avg وmax وmin. اختر max للذاكرة والقرص: المتوسط يخفي الذروة التي تسقط عملية. وفي Data Explorer أضف قيمة عتبة عند 85% لتلوين التجاوزات.
المثال 3: عرض التشغيل للبيئة
الهدف: الصفحة الرئيسية للمناوبة. دون مرشح منطقة إدارة، أو بمنطقة «Production»، والنطاق Last 2 hours.
| البلاطة | النوع | الإعداد |
|---|---|---|
| المشكلات المفتوحة | OPEN_PROBLEMS |
المرشح: منطقة إدارة Production |
| SLO توافر الواجهة الأمامية | SLO |
SLO معيَّن للبلاطة، مع ميزانية الأخطاء |
| SLO زمن استجابة الـ API | SLO |
SLO معيَّن للبلاطة |
| الأخطاء، كل الخدمات | DATA_EXPLORER، قيمة وحيدة |
builtin:service.errors.total.rate:splitBy():avg |
| المضيفون غير المتاحين | DATA_EXPLORER، top list |
builtin:host.availability:splitBy("dt.entity.host") |
| دليل التشغيل | MARKDOWN |
رابط الإجراء وقناة المناوبة |
تعكس بلاطة OPEN_PROBLEMS ما فتحه Davis؛ وهي المقابل البصري لإشعارات ملفات التنبيه لديك. ولمراقبة عنقود Managed نفسه (العقد والتخزين وActiveGates)، أبقِ لوحة منفصلة واعتمد على مراقبة صحة العنقود.
تصدير لوحة واستيرادها بصيغة JSON
الخطوة 1: السرد والتصدير
export DT_URL="https://{votre-domaine}/e/{id-environnement}"
# Lister (scope ReadConfig) : renvoie id, name, owner
curl -s "$DT_URL/api/config/v1/dashboards" \
-H "Authorization: Api-Token $DT_TOKEN" | jq '.dashboards[] | {id, name, owner}'
# Exporter un dashboard
curl -s "$DT_URL/api/config/v1/dashboards/<id>" \
-H "Authorization: Api-Token $DT_TOKEN" > sante-app.json
تُرجع القائمة كل اللوحات مهما كانت الصلاحيات في الواجهة. وأفضل طريقة للحصول على البنية الدقيقة لبلاطة DATA_EXPLORER هي تصديرها بعد بنائها في الواجهة.
الخطوة 2: JSON أدنى صالح
{
"dashboardMetadata": {
"name": "Exploitation - Production",
"owner": "sre-team",
"shared": true,
"dashboardFilter": {
"timeframe": "l_2_HOURS",
"managementZone": { "id": "3438779970106539862", "name": "Production" }
}
},
"tiles": [
{
"name": "Hôtes", "tileType": "HEADER", "configured": true,
"bounds": { "top": 0, "left": 0, "width": 304, "height": 38 },
"tileFilter": {}
},
{
"name": "Santé des hôtes", "tileType": "HOSTS", "configured": true,
"chartVisible": true,
"bounds": { "top": 38, "left": 0, "width": 304, "height": 304 },
"tileFilter": {}
}
]
}
الحقلان dashboardMetadata (مع name وowner) وtiles إلزاميان. قبل استيراد ملف مصدَّر احذف id وكتلة metadata اللذين يخدمان التنقيح فقط: المعرّف تمنحه Dynatrace.
الخطوة 3: التحقق ثم الإنشاء أو التحديث
# Valider sans créer (scope WriteConfig) : 204 = valide
curl -s -o /dev/null -w "%{http_code}\n" -X POST \
"$DT_URL/api/config/v1/dashboards/validator" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json" -d @sante-app.json
# Créer
curl -s -X POST "$DT_URL/api/config/v1/dashboards" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json" -d @sante-app.json
# Mettre à jour un dashboard existant
curl -s -X PUT "$DT_URL/api/config/v1/dashboards/<id>" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json" -d @sante-app.json
يُرجع الرمز 400 كائن ErrorEnvelope تشير constraintViolations فيه إلى الحقل المخطئ. لمناطق الإدارة معرّفات خاصة بكل بيئة: عدّلها عند الانتقال من بيئة إلى أخرى.
المشاركة والصلاحيات
يجعل الحقل shared اللوحة مرئية لبقية المستخدمين؛ ويضبط sharingDetails (linkShared وpublished) المشاركة بالرابط والنشر. ويحتفظ المالك (owner) بحق التحرير. اللوحة المشتركة لا تمنح وصولًا إلى البيانات: لا يرى كل قارئ إلا ما تتيحه صلاحياته على مناطق الإدارة. أما اللوحات التي تحوي بلاطات بيئة بعيدة فلا يستطيع تعديلها عبر الـ API إلا مسؤول (وإلا جاء الرد 403).
التهيئة الآلية باستخدام Terraform أو Monaco
يدير مزوّد Terraform الخاص بـ Dynatrace اللوحات الكلاسيكية بالمورد dynatrace_json_dashboard الذي يأخذ JSON اللوحة. وتستثنيها أداة التصدير فيه افتراضيًا: سمّها صراحة. ومع Monaco تشكل اللوحات نوع إعداد خاصًا؛ ومنذ Monaco CLI 1.208 يجب أن يكون owner غير فارغ ولم يعد sharingDetails مدعومًا. ارجع إلى وثائق المزوّد للصيغة الدقيقة في إصدارك.
كيف تتحقق من أن النتيجة صحيحة
- يُرجع استدعاء المحقق
204، ويُرجع POST معرّف اللوحة الجديدة. - يُظهر GET القائمة اللوحة بقيمة
ownerالصحيحة. - في الواجهة، قائمة Dashboards: تظهر اللوحة، ويُعرض مرشح منطقة الإدارة في الأعلى، وتُظهر كل بلاطة Data Explorer بيانات على النطاق المختار.
- عند الدخول بحساب مقيَّد بمنطقة إدارة أخرى، لا تعرض اللوحة المشتركة إلا الكيانات المسموح بها.
أفضل الممارسات
- لوحة واحدة لسؤال واحد: «هل التطبيق بخير؟» لا «كل شيء عن كل شيء».
- ضع مؤشرات SLI في الأعلى على اليمين، والتفاصيل تحتها.
- فضّل النسب المئوية (percentiles) والقيم القصوى على المتوسطات في زمن الاستجابة والتشبع.
- قيّد قوائم top list بعشرة كيانات عبر
limit(10): ما زاد ضجيج. - أدِر إصدارات JSON وطبّقه عبر خط أنابيب (pipeline)؛ فاللوحة المعدلة يدويًا تنحرف سريعًا.
- أضف بلاطة Markdown بدليل التشغيل: تقصّر زمن أول إجراء.
الأسئلة الشائعة
هل لوحات Dynatrace Managed هي نفسها في SaaS؟
اللوحات الكلاسيكية وواجهة /api/config/v1/dashboards موجودتان في الاثنتين. وفي SaaS يُضاف تطبيق Dashboards الجديد القائم على Grail وDQL؛ وهو لا يخص Managed.
لماذا بلاطة Data Explorer فارغة؟
غالبًا تستبعد منطقة إدارة البلاطة أو اللوحة الكيانات، أو لا يقبل المقياس التجميع المختار. اختبر المحدد وحده في Data Explorer ثم أعد تطبيق المرشح.
هل يمكنني نسخ لوحة بين بيئتي Managed؟
نعم: صدّر بـ GET، واحذف id وmetadata، واستبدل معرّفات مناطق الإدارة وSLO والكيانات، ثم تحقق وأرسل POST إلى البيئة الهدف.
الخلاصة
تُبنى لوحة Dynatrace Managed الجيدة حول مؤشرات SLI: زمن الاستجابة والأخطاء ومعدل المعالجة والتشبع والمشكلات المفتوحة. وبمحددات دقيقة ومناطق إدارة جيدة التعريف وJSON مُدار الإصدارات، تصبح لوحاتك الثلاث قابلة للتكرار ومفيدة في اللحظة التي تحتاجها فيها المناوبة. المرجع الرسمي: Dashboards API في Dynatrace Managed.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. الأمثلة للاستئناس فقط: تحقق منها في الوثائق الرسمية الخاصة بإصدارك.