Dynatrace for AI: skills وprompts وMCP لوكلاء البرمجة، الدليل العملي

Dynatrace for AI: 34 skill و6 prompts وإعداد MCP لـ Claude Code أو Cursor أو Copilot. التثبيت والتحقيق خطوة بخطوة والحدود الفعلية.
Dynatrace for AI : skills, prompts et MCP pour les agents de code, le guide pratique

يعرف وكيل البرمجة كتابة Python، لكنه كثيرًا ما يكتب DQL كأنها SQL. يخترع أسماء حقول، وينسى المحاذاة الزمنية، ويطلق استعلامات تمسح تيرابايتات دون جدوى. ويعالج هذه المشكلة المستودع العام Dynatrace for AI، الذي نشرته Dynatrace على GitHub: يمنح الوكلاء المعرفة المهنية التي تنقصهم قبل أن يلمسوا بيئتك.

هذا المستودع ليس منتجًا جديدًا. إنه مجموعة ملفات نصية: 34 skill بصيغة Agent Skills المفتوحة، و6 prompts جاهزة للاستخدام، وإعداد MCP، وملف تعريف (manifest) للسجل الرسمي لـ MCP، وملف llms.txt. وكله بترخيص Apache-2.0.

تتناول هذه المقالة المحتوى، وتبين كيف تثبته في الوكلاء الذين يوثقهم المستودع (Claude Code وCursor وGitHub Copilot وبعض الآخرين)، وتسير في مسار تحقيق خطوة بخطوة، ثم توضح ما يغيّره قياسًا بخادم MCP وحده. النطاق واضح: تتحدث الـ skills عن Grail وDQL وتطبيقات المنصة، أي عن Dynatrace SaaS. أما Dynatrace Managed فيُعالَج أدناه.

ما يحتويه مستودع Dynatrace for AI

في الجذر أشياء قليلة، ولكل منها دور محدد.

الدور العنصر
34 مجلدًا dt-*، في كل منها ملف SKILL.md وغالبًا مجلد فرعي references/ skills/
6 ملفات *.prompt.md: سيناريوهات تحقيق قابلة لإعادة الاستخدام prompts/
تصريح بخادم MCP البعيد من Dynatrace، مضبوط بمتغيرات البيئة mcp.json و.mcp.json
ملف التعريف المنشور في السجل الرسمي لـ MCP باسم io.github.Dynatrace/dynatrace-for-ai server.json
ملخص يقرؤه النموذج: ما Dynatrace، وقائمة الـ skills والـ prompts، والتثبيت llms.txt
ملفات تعريف إضافتي Claude Code وCursor .claude-plugin/ و.cursor-plugin/
التعليمات التي يحمّلها Claude Code مع الإضافة (المتغيرات المطلوبة واستخدام الـ skills) CLAUDE.md
فحوص بنية الـ skills وجودتها واتساق أرقام الإصدارات tests/ وscripts/
شجرة مستودع Dynatrace for AI مع المجلدين skills وprompts

الـ skills، عائلةً عائلة

الـ skill مجلد يبدأ ملف SKILL.md فيه برأس YAML (name وdescription وlicense). وتتحقق اختبارات المستودع من أن الاسم يطابق المجلد وأن الوصف لا يتجاوز 250 حرفًا. وتتبع الأسماء النمط dt-<domaine>[-<usage>].

  • لغة الاستعلام: dt-dql-essentials، الأساس. صياغة DQL والمزالق الشائعة وتحسين تكلفة الاستعلامات. ويطلب المستودع تحميله قبل كتابة أي استعلام.
  • قابلية الملاحظة: الخدمات ومقاييس RED (dt-obs-services)، والتتبعات وspans (dt-obs-tracing)، والسجلات (dt-obs-logs)، والمضيفات والعمليات (dt-obs-hosts)، وKubernetes (dt-obs-kubernetes)، وRUM وWeb Vitals (dt-obs-frontends)، ومشكلات Davis (dt-obs-problems)، وسحب AWS وAzure وGCP، والتنبؤ وكشف الاتجاهات (dt-obs-predictive-analytics)، ومحللات Davis (dt-obs-analytics)، والتنبيه من البداية إلى النهاية (dt-alerting)، وتطبيقات GenAI (dt-obs-genai)، ومعدات الشبكة SNMP وتدفقات الشبكة، واستيعاب نتائج اختبارات خارجية (dt-obs-ext-monitors)، والمطابقة الدلالية لسجلات التدقيق.
  • الأمان: dt-sec-insights (الجدول security.events)، وإضفاء السياق على الإشارات، والبحث عن مؤشرات الاختراق، والمطابقة الدلالية لتكاملات الأمان، ومساعد للامتثال لـ DORA.
  • القياس البرمجي (instrumentation): OneAgent (الآلات الافتراضية وKubernetes وAWS Lambda وWindows وAzure)، وAndroid وiOS وFlutter وReact Native.
  • المنصة: Dashboards وNotebooks، وبيئة JavaScript من جهة الخادم وحزم @dynatrace-sdk/* SDK، وتحليل التكاليف واستهلاك DPS.
  • الترحيل: dt-migration، للانتقال من DQL الكلاسيكي القائم على الكيانات إلى مكافئات Smartscape.

الـ prompts: ستة سيناريوهات تشغيل

الـ prompts قوالب مهام قصيرة. كل منها يصف منهجًا لا إجابة.

  • dt-daily-standup: متابعة يومية لخدمة أو أكثر.
  • dt-health-check: الحالة الصحية لخدمة في الإنتاج.
  • dt-incident-response: حادثة جارية، ومشكلات Davis النشطة، والأثر، وتقرير قابل للمشاركة.
  • dt-investigate-error: الأخطاء الحديثة، بالانطلاق من مشكلات Davis إلى السجلات ثم التتبعات.
  • dt-performance-regression: هل أضرّ نشر حديث بالأداء، والتراجع أو الإصلاح.
  • dt-troubleshoot-problem: تحقيق منظم في مشكلة Davis قائمة.

لمن يفيد Dynatrace for AI

يستفيد ثلاثة أصناف. المطوّر الذي يريد التحقق في الإنتاج من أثر شيفرته دون مغادرة المحرر. ومهندس SRE في المناوبة الذي يريد تحقيقًا قابلًا للتكرار بدل الارتجال في الثالثة صباحًا. وفريق المنصة الذي يصنّع القياس البرمجي (OneAgent وحزم SDK للجوال) ويريد أن يتبع الوكيل الإجراء الموثق بدل ذكرى تقريبية.

النقطة الأساسية، التي يذكّر بها README كما يذكّر بها llms.txt: الـ skills تقدم معرفة لا وصولًا. ولتنفيذ استعلام حقيقي، يجب ربطها بأداة: خادم MCP من Dynatrace أو dtctl، واجهة سطر الأوامر مفتوحة المصدر على طراز kubectl.

تثبيت الـ skills في وكيلك

يوثق المستودع أربعة طرق. اختر واحدة فقط لكل جهاز.

  1. حزمة skills (skills.sh)، لـ Claude Code وCursor وCline وGitHub Copilot وOpenCode والوكلاء المتوافقين:
    npx skills add dynatrace/dynatrace-for-ai
  2. إضافة Claude Code، وتضم الـ skills وإعداد خادم MCP:
    export DT_ENVIRONMENT=https://<env>.apps.dynatrace.com
    export DT_PLATFORM_TOKEN=<your-platform-token>
    claude plugin install dynatrace@claude-plugins-official
    claude mcp login plugin:dynatrace:dynatrace   # checks the connection

    البروتوكول https:// إلزامي في DT_ENVIRONMENT. ويجب أن يحمل الرمز على الأقل نطاقات MCP gateway؛ والقائمة الكاملة في وثائق خادم MCP.

  3. إضافة Cursor: تثبيت رسومي فقط، من Customize في الشريط الجانبي، مع تعريف متغيري البيئة نفسيهما قبل التشغيل.
  4. يدويًا: انسخ مجلدات الـ skills إلى دليل الوكيل (.agents/skills/ أو .claude/skills/ أو .cursor/skills/…). ولـ GitHub Copilot في VS Code، انسخ أيضًا الـ prompts إلى .github/prompts/: تصبح أوامر slash مثل /dt-troubleshoot-problem.

من جهة الاتصال، تشير الإضافة إلى خادم MCP بعيد تستضيفه Dynatrace: لا شيء يُثبَّت. وهذا جوهر mcp.json:

{
  "mcpServers": {
    "dynatrace": {
      "url": "${env:DT_ENVIRONMENT}/platform-reserved/mcp-gateway/v0.1/servers/dynatrace-mcp/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DT_PLATFORM_TOKEN}",
        "Dt-External-Source": "dynatrace-for-ai/8.0.1"
      }
    }
  }
}

لا يعيش الرمز في الملف أبدًا: يُقرأ من البيئة. ويحدد الترويس Dt-External-Source إصدار الحزمة فحسب. وإعداد الخادم بالتفصيل مغطى في دليلنا MCP لـ Dynatrace على SaaS.

ملف mcp.json في مستودع Dynatrace for AI مع المتغيرين DT_ENVIRONMENT وDT_PLATFORM_TOKEN

مسار عملي: التحقيق في أخطاء خطوة بخطوة

السيناريو: ارتفع معدل الأخطاء في خدمة دفع بعد نشر. تعمل في Claude Code والإضافة مثبّتة.

  1. تحقق من الاتصال. شغّل claude mcp login plugin:dynatrace:dynatrace. بدون هذه الخطوة سيستدل الوكيل في الفراغ.
  2. حمّل السيناريو المناسب. الصق محتوى prompts/dt-investigate-error.prompt.md. يطلب من الوكيل استنتاج اسم الخدمة من مساحة العمل وأخذ تأكيدك عليه.
  3. دع الوكيل ينطلق من مشكلات Davis. يفرض الـ prompt الترتيب: المشكلات، ثم سجلات المستوى ERROR المحصورة في النافذة وكيانات المشكلة، ثم التتبعات. يتجنب هذا الترتيب البحث النصي الكامل على ثلاثين يومًا.
  4. لاحظ التحميل التدريجي. لا يملك الوكيل في البداية إلا اسم كل skill ووصفه (نحو 100 رمز لكل منها). وحين يكتب DQL يحمّل dt-dql-essentials (أقل من 5 000 رمز)، ثم المرجع المفيد فقط، مثل references/optimization.md.
  5. راجع الاستعلامات. اطلب من الوكيل عرض كل استعلام DQL قبل تنفيذه. تحقق من المرشّحات المبكرة ومن نطاق الزمن القصير: هنا تُحسم التكلفة.
  6. استثمر الخلاصة. ينتهي الـ prompt بثلاثة أخطاء ذات أولوية، وتتبعات مرتبطة، والشيفرة المسؤولة، واقتراح معالجة. انقلها إلى تذكرة الحادثة.
مقتطف من الـ prompt المسمى dt-investigate-error ومن رأس الـ skill المسمى dt-dql-essentials

كيف تتحقق من أن الإعداد يعمل

  • في Claude Code، يجب أن يسرد /plugin إضافة Dynatrace، وأن ينجح الأمر claude mcp login.
  • اطرح سؤالًا يتطلب DQL: يجب أن يذكر الرد حقولًا من القاموس الدلالي، لا أعمدة مختلقة.
  • أعد تشغيل استعلام أنتجه الوكيل في Notebook: النتيجة نفسها، وإلا فالسبب في الاستعلام أو الصلاحيات.

ما الذي يتغير قياسًا بخادم MCP وحده

يمنح خادم MCP الوكيل أيادي: تنفيذ DQL وسرد المشكلات. لكنه لا يعلّمه كيف يحسن استخدامها. تضيف الـ skills دليل الاستخدام: أي الحقول موجودة، وأي الاستعلامات مكلفة، وأي ترتيب يُتّبع في التحقيق. يعرض مقالنا عن خادم Dynatrace MCP من العَرَض إلى الإصلاح الأداة وحدها؛ ومع الـ skills تصبح الاستدعاءات نفسها أدق وأقل كلفة.

بالنسبة إلى SRE، يُقاس الأثر بـ MTTR: ذهاب وإياب أقل على استعلامات خاطئة، ومنهج متطابق من مناوبة إلى أخرى، وعبء متكرر (toil) أقل. وتجعل الـ prompts التحقيق قابلًا للتكرار، مما يسهّل أيضًا التحليل اللاحق دون لوم (blameless post-mortem).

فارق آخر: يقدّم المستودع dtctl بوصفه الخيار الموصى به في معظم الحالات، لأنه يغطي أيضًا SLO وdashboards وworkflows والإعدادات، في أي وكيل قادر على تشغيل أوامر shell. ويبقى خادم MCP الخيار الطبيعي حين يتحدث الوكيل MCP بصورة أصلية. وللصيغة نفسها، راجع شرح بروتوكول سياق النموذج، وللمكافئ من جهة المحرر، إضافة Dynatrace لـ Cursor.

حدود ينبغي معرفتها

  • Dynatrace Managed. عناوين المستودع تشير إلى *.apps.dynatrace.com وتقوم الـ skills على Grail وDQL وتطبيقات المنصة. فهي موجهة إلى Dynatrace SaaS. ولعنقود Managed، اقرأ مقالنا MCP لـ Dynatrace على Managed قبل التفكير في أي شيء.
  • معرفة لا حقيقة. تقلل الـ skill الأخطاء ولا تلغيها. راجع الاستعلامات والتعديلات المقترحة.
  • مساهمات مغلقة في الـ skills. المحتوى يُصان داخليًا ويُنشر دوريًا؛ وطلبات السحب (pull requests) التي تعدّل الـ skills تُرفض، ويجب فتح issue.
  • البيانات. خادم MCP المقدَّم يتصل ببيئتك؛ ويحيل README إلى سياسة الخصوصية لدى Dynatrace. امنح الرمز الحد الأدنى الضروري.

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

  • ثبّت كل الـ skills: يجنّبك التحميل التدريجي ازدحام السياق.
  • خزّن DT_PLATFORM_TOKEN في البيئة أو في مدير أسرار، ولا تضعه في مستودع أبدًا.
  • ابدأ كل تحقيق بـ prompt من المستودع بدل سؤال حر.
  • اجعل إنسانًا يصادق على كل إجراء كتابة (dashboard أو workflow أو إعداد).

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

هل يحل Dynatrace for AI محل خادم MCP؟

لا. الـ skills معرفة فقط. وتُدمج مع خادم MCP أو مع dtctl للوصول إلى البيانات.

هل يجب تثبيت الـ skills الأربع والثلاثين؟

نعم، يوصي المستودع بذلك: لا يحمّل الوكيل في البداية إلا الأسماء والأوصاف، ثم المحتوى الكامل حين يحتاج إليه فقط.

هل أستطيع استخدام الـ prompts دون إضافة؟

نعم. انسخها إلى أي محادثة وكيل، أو إلى .github/prompts/ لـ GitHub Copilot في VS Code. حمّل أولًا الـ skills التي تذكرها.

الخلاصة

يسدّ Dynatrace for AI الفجوة بين وكيل يعرف استدعاء API ووكيل يعرف التحقيق. ابدأ بالإضافة أو بـ npx skills add، واربط خادم MCP، ثم شغّل prompt تحقيق على حادثة سابقة لتقيّم جودة الردود قبل الاعتماد عليها في المناوبة. المصدر هو المرجع: مستودع GitHub ووثائق خادم MCP.

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

Total
0
Shares
Leave a Reply

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

Previous Post
MCP Dynatrace Managed : installer le serveur, token, outils et sécurité

خادم MCP لـ Dynatrace Managed: التثبيت والرمز والأدوات والأمان

Next Post
Parcours métriques Dynatrace Managed : la formation en 6 modules

مسار مقاييس Dynatrace Managed: التدريب في 7 وحدات

Related Posts