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

خادم MCP لـ Dynatrace SaaS: التثبيت بـ npx، ورمز المنصة أو OAuth، والنطاقات، وضبط العملاء، ودور 18 أداة، والتحكم في ميزانية Grail.
MCP Dynatrace SaaS : installer, authentifier et connaître ses outils

يتيح خادم MCP لـ Dynatrace SaaS لمساعد ذكاء اصطناعي (VS Code أو Claude Desktop أو Cursor أو Gemini CLI…) أن يستعلم مباشرة من بيئة Dynatrace لديك: مشكلات Davis والثغرات والسجلات وspans عبر DQL. لكن لا بد من تثبيته بشكل سليم، واختيار نمط المصادقة المناسب، ومنح النطاقات (scopes) الصحيحة، دون أن يستهلك استعلام Grail غير محدود ميزانيتك.

الرهان ملموس لفريق SRE: خادم مضبوط بشكل سيئ يعيد أخطاء 403 في منتصف المناوبة، ومساعد يشغّل استعلامات على 30 يومًا من السجلات يكلّف كثيرًا. أما إذا ضُبط جيدًا فهو يقلل عبء التحقيق اليدوي (toil) ويقصّر زمن الاستعادة (MTTR).

الهدف: في نهاية هذا الدليل ستكون قد ثبّتّ خادم MCP المحلي @dynatrace-oss/dynatrace-mcp-server، واخترت بين المصادقة عبر المتصفح ورمز المنصة (platform token) وعميل OAuth، وضبطت عميل MCP لديك، وفهمت دور كل أداة معروضة. هذا المحتوى يخص Dynatrace SaaS فقط (منصة Grail، وعنوان apps.dynatrace.com): فالخادم لا يعمل مع Dynatrace Managed. ولحالة استخدام كاملة انظر من العَرَض إلى الإصلاح مع خادم Dynatrace MCP.

قبل كل شيء: حالة المشروع في الإصدار 2.1.3

نقطة أساسية قبل تثبيت أي شيء: بحسب ملف README وملف CHANGELOG، فإن المستودع dynatrace-oss/dynatrace-mcp مهجور (deprecated). يُعلَن فيه أن الإصدار 2.1.2 هو الأخير؛ ومع ذلك يعرض الملف package.json الإصدار 2.1.3، وهو إصدار يشدّد تهريب سلاسل DQL. كما لم يكن المشروع يومًا منتجًا مدعومًا رسميًا.

يوجّه README إلى بديلين مدعومين: Dynatrace-for-AI مع dtctl لبيئة المطور، وخادم Dynatrace Remote MCP Server (دون تثبيت محلي) لتكاملات وكيل إلى وكيل. ويقارن دليل الترحيل في المستودع (docs/remote-mcp-migration.md) بينهما. يظل هذا الدرس مفيدًا إن كنت تشغّل الخادم المحلي أصلًا أو عليك صيانته ريثما تنتقل.

المتطلبات

  • Node.js 24 أو أحدث (رُفع الحد الأدنى من 22.10 في الإصدار 2.0.0)؛
  • بيئة Dynatrace SaaS وعنوان منصتها، من نوع https://abc12345.apps.dynatrace.com — لا العنوان التقليدي live.dynatrace.com؛
  • عميل MCP يدعم stdio؛
  • بحسب النمط المختار، رمز منصة أو عميل OAuth بالنطاقات المذكورة أدناه.

تثبيت خادم MCP لـ Dynatrace SaaS خطوة بخطوة

الخطوة 1: تحقق من Node.js والحزمة

node --version   # doit afficher v24.x ou plus
npx -y @dynatrace-oss/dynatrace-mcp-server@latest --version

منذ الإصدار 1.8.7 يعمل الخياران --help و--version حتى دون DT_ENVIRONMENT: وهذا عملي للتحقق من التثبيت قبل لمس المصادقة.

الخطوة 2: اختر المصادقة

يقبل الخادم ثلاثة أنماط. اختر بحسب السياق لا بحسب العادة:

  • المتصفح (Authorization Code Flow): لا تقدّم إلا DT_ENVIRONMENT. يفتح الخادم نافذة تسجيل دخول SSO. ومنذ 2.0.0 يُخزَّن الرمز الناتج في سلسلة مفاتيح النظام (Keychain في macOS، وWindows Credential Manager، وSecret Service في Linux): فلا تظهر النافذة ثانية إلا عند انتهاء الصلاحية. وفي حاوية بلا سلسلة مفاتيح يخزّن DT_MCP_TOKEN_STORAGE=file الرمز في ~/.config/dynatrace-mcp/.
  • رمز المنصة: المتغير DT_PLATFORM_TOKEN (بصيغة dt0s16.…). مناسب لجهاز يزعجه فتح المتصفح.
  • عميل OAuth: OAUTH_CLIENT_ID وOAUTH_CLIENT_SECRET، لحسابات الخدمة والتبادل بين الآلات. ويتيح DT_SSO_URL فرض عنوان SSO إن لم يناسب الاكتشاف التلقائي.

نمط المتصفح يعمل بصلاحيات المستخدم. وللاستخدام المشترك فضّل رمزًا أو عميلًا مخصصًا محدودًا بالنطاقات الضرورية: وهذا مبدأ أقل الصلاحيات المفصّل في دليلنا لتأمين خادم MCP.

الخطوة 3: امنح النطاقات المفيدة

تصلح أسماء النطاقات نفسها لرموز المنصة وعملاء OAuth. مجمّعة بحسب الاستخدام:

الاستخدام النطاقات
الأساس (تقريبًا كل الأدوات) app-engine:apps:run
استعلامات DQL على Grail storage:buckets:read, storage:logs:read, storage:metrics:read, storage:spans:read, storage:entities:read, storage:events:read, storage:bizevents:read, storage:system:read, storage:smartscape:read…
Davis CoPilot davis-copilot:conversations:execute, davis-copilot:nl2dql:execute, davis-copilot:dql2nl:execute
محللات Davis davis:analyzers:read, davis:analyzers:execute
الكتابة والإشعارات storage:events:write, email:emails:send, app-settings:objects:read (Slack), document:documents:write

ابدأ بالأساس ونطاقات القراءة. ولا تضف نطاقات الكتابة إلا إذا احتاج الفريق فعلًا إلى إرسال أحداث أو رسائل.

الخطوة 4: اضبط عميل MCP

يوصي README بإعداد لكل مساحة عمل لا إعداد عام. في VS Code يستخدم الملف .vscode/mcp.json المفتاح servers:

{
  "servers": {
    "npx-dynatrace-mcp-server": {
      "command": "npx",
      "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"],
      "env": { "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com" }
    }
  }
}
ملف mcp.json في VS Code يعرّف خادم MCP لـ Dynatrace SaaS مع المتغير DT_ENVIRONMENT

يستخدم Claude Desktop وAmazon Q Developer CLI (.amazonq/mcp.json) وAmazon Kiro (.kiro/settings/mcp.json) الكتلة نفسها تحت المفتاح mcpServers. أما Gemini CLI فيوفر تثبيتًا بأمر واحد، gemini extensions install https://github.com/dynatrace-oss/dynatrace-mcp، ثم gemini mcp list للتحقق. وفي Claude Desktop ينشر كل إصدار أيضًا حزمة .mcpb تُسحب إلى Settings → Developer. ومنذ 1.0.0 لم يعد الخادم يقرأ ملف .env: مرّر الأسرار عبر الخيار envFile في العميل بدل كتابتها صريحة في ملف JSON.

الخطوة 5: نمط HTTP، إن كان ضروريًا حقًا

يمكن للخادم أن يعمل عبر HTTP (--http، والمنفذ 3000 افتراضيًا، و--port و--host للتعديل). ومنذ 2.1.0 صار MCP_BEARER_TOKEN إلزاميًا في هذا النمط: ومن دونه يرفض الخادم أن يبدأ.

export MCP_BEARER_TOKEN=$(openssl rand -base64 32)
npx -y @dynatrace-oss/dynatrace-mcp-server@latest --http --host 127.0.0.1

ويوصي README نفسه بخادم MCP البعيد من Dynatrace لهذه الحالة.

الأدوات المعروضة ودور كل منها

يسجّل الإصدار 2.1.3 ثماني عشرة أداة (الملف src/index.ts). أما الأداتان create_workflow_for_notification وmake_workflow_public فقد أُزيلتا في 2.0.0.

  • get_environment_info: تتحقق من الاتصال والمصادقة — وهي أول استدعاء ينبغي إجراؤه؛
  • find_entity_by_name: تعثر على معرّف كيان ونوعه (خدمة أو مضيف أو عقدة Kubernetes…) قبل أي استعلام موجَّه؛
  • list_problems وlist_vulnerabilities وlist_exceptions وget_kubernetes_events: قراءة مشكلات Davis والثغرات النشطة غير المكتومة والاستثناءات وأحداث عنقود؛
  • execute_dql: تنفّذ استعلام DQL على Grail (100 سجل و1 ميغابايت افتراضيًا)؛ وتتحقق verify_dql من صيغته قبل التنفيذ؛
  • generate_dql_from_natural_language وexplain_dql_in_natural_language وchat_with_davis_copilot: تعتمد على Davis CoPilot؛
  • list_davis_analyzers وexecute_davis_analyzer: التنبؤ وكشف الشذوذ والترابط؛
  • reset_grail_budget: تعيد ضبط ميزانية استعلامات الجلسة إلى الصفر؛
  • send_slack_message وsend_email وsend_event وcreate_dynatrace_notebook: الأدوات الوحيدة التي تكتب أو ترسل إشعارات. وكل منها يطلب موافقة بشرية في العميل قبل التنفيذ.
الأدوات الثماني عشرة المعرَّفة في الشيفرة المصدرية لخادم MCP لـ Dynatrace SaaS (الإصدار 2.1.3)، معروضة في طرفية

استعلامات Grail: التكلفة والضوابط

الخادم مجاني، لكن الأدوات التي تستعلم من Grail، وفي مقدمتها execute_dql، قد تُفوتَر بحسب نموذج الاستهلاك لديك، وفق الحجم الممسوح. ويتتبع الخادم البايتات الممسوحة في كل جلسة: يحدد DT_GRAIL_QUERY_BUDGET_GB الحد (1000 غيغابايت افتراضيًا)، ويظهر تحذير عند 80%، ويعود العداد إلى الصفر عند إعادة التشغيل أو عبر reset_grail_budget. وللقياس لاحقًا رشّح أحداث النظام:

fetch dt.system.events
| filter event.kind == "QUERY_EXECUTION_EVENT"
| filter contains(client.client_context, "dynatrace-mcp")
| summarize scanned = sum(scanned_bytes), by: { user.email }

إن كنت مبتدئًا في DQL فإن وحدة أساسيات DQL تساعد على مراجعة الاستعلامات المولَّدة قبل تركها تعمل.

كيف تتحقق من أن كل شيء يعمل

  1. اطلب من المساعد استدعاء get_environment_info: يجب أن يعيد معرّف البيئة وحالتها.
  2. إن فشل الاستدعاء مع OAuth فاختبر خارج MCP: احصل على رمز من https://sso.dynatrace.com/sso/oauth2/token بالنطاق app-engine:apps:run، ثم استدعِ /platform/management/v1/environment. استجابة فيها "state": "ACTIVE" تؤكد سلامة العميل.
  3. شغّل استعلامًا قصيرًا (آخر ساعة) وتحقق في دفتر ملاحظات (notebook) من الحجم الممسوح بالاستعلام أعلاه.

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

  • إعداد لكل مستودع، مع ملف قواعد (مثل .github/copilot-instructions.md) يحدد مرشحات DQL الخاصة بتطبيقك.
  • نوافذ قصيرة (من 12 إلى 24 ساعة) وbuckets مستهدفة للحد من الحجم الممسوح.
  • ميزانية DT_GRAIL_QUERY_BUDGET_GB أقل بكثير من القيمة الافتراضية للاستخدام الاستكشافي.
  • القياس عن بُعد: يرسل الخادم إحصاءات استخدام مجهولة؛ وDT_MCP_DISABLE_TELEMETRY=true يعطّلها.
  • خلف وكيل (proxy)، اضبط HTTPS_PROXY وعند الحاجة NODE_EXTRA_CA_CERTS.
  • خطّط للانتقال إلى بديل مدعوم: فالمستودع لن يتلقى تحديثات بعد الآن.

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

هل يعمل الخادم مع Dynatrace Managed؟

لا. فهو يتطلب عنوان منصة apps.dynatrace.com ويعتمد على Grail وDavis CoPilot وAppEngine، وهي خاصة بـ Dynatrace SaaS.

لماذا أحصل على 403 مع أن الرمز صالح؟

في الغالب ينقص نطاق: app-engine:apps:run أو نطاق storage:*:read للجدول المستعلَم عنه. وتهم أيضًا صلاحيات Grail للمستخدم. ويفصّل مقالنا عن استكشاف أخطاء رموز API في Dynatrace المنهج.

هل ما زال ينبغي تثبيت هذا الخادم في 2026؟

لمشروع جديد يوجّه README المستودع إلى Dynatrace-for-AI مع dtctl أو إلى خادم MCP البعيد. يبقى الخادم المحلي قابلًا للاستخدام، لكن دون تطوير.

الخلاصة

يُثبَّت خادم MCP لـ Dynatrace SaaS بسطر npx واحد، لكن موثوقيته تتوقف على الضبط: نمط مصادقة مناسب، ونطاقات دنيا، وميزانية Grail، وموافقات على أدوات الكتابة. ولأن المشروع مهجور، استعن بهذا الدليل لتشغيله بشكل سليم وللتحضير لما بعده. المرجع: وثائق رموز المنصة.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لمالكها. الأمثلة مقدَّمة على سبيل الإرشاد: تحقق منها في الوثائق الرسمية قبل استخدامها في الإنتاج.

Total
0
Shares
Leave a Reply

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

Previous Post
Dashboard Dynatrace Managed : tuiles, Data Explorer et JSON, avec 3 exemples complets

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

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

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

Related Posts