dashboard Dynatrace Managed: البلاطات وData Explorer وJSON مع 3 أمثلة كاملة

ابنِ dashboard Dynatrace Managed مفيدًا: محددات builtin دقيقة، ومناطق إدارة، وتصدير JSON عبر API، وثلاثة أمثلة كاملة للنسخ.
Dashboard Dynatrace Managed : tuiles, Data Explorer et JSON, avec 3 exemples complets

أثناء الحوادث، يفتح المناوب 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

  1. افتح Data Explorer من القائمة، وابحث عن المقياس (مثلًا CPU usage %).
  2. اختر التجميع والتقسيم (Split by) والمرشحات، أو انتقل إلى المحرر المتقدم لإدخال المحدد مباشرة.
  3. اختر التصوّر (رسم أو قيمة وحيدة أو جدول أو top list)، ثم Pin to dashboard واللوحة المستهدفة.
  4. على اللوحة، حرّر البلاطة لتمنحها اسمًا معبّرًا، وعند الحاجة منطقة إدارة خاصة بها.

يتبع المحدد صيغة 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. الأمثلة للاستئناس فقط: تحقق منها في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

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

Previous Post
Dashboard Dynatrace SaaS : construire des tableaux de bord DQL sur Grail, avec 3 exemples complets

dashboard Dynatrace SaaS: بناء لوحات معلومات DQL على Grail مع 3 أمثلة كاملة

Next Post
MCP Dynatrace SaaS : installer, authentifier et connaître ses outils

خادم MCP لـ Dynatrace SaaS: التثبيت والمصادقة ومعرفة أدواته

Related Posts