مسارات عمل التطويرالمهارات العامة

Observability & Monitoring

رصد شامل لوكلاء الذكاء الاصطناعي — تصحيح الأخطاء من السجلات، تتبع التأخير عبر الخدمات، إدارة التنبيهات، الاستجابة للحوادث باستخدام كتب التشغيل، وحماية ميزانيات أخطاء SLO عبر Datadog، Grafana، أو New Relic.

افتح مصدر المهارة اقرأ الدليل الرسمي ↗

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

تنسيق المراقبة الشاملة — استعلام السجلات، البحث في التتبع، مراقبة المقاييس، إدارة التنبيهات، التعامل مع الحوادث، تتبع SLOs، وتنفيذ كتب التشغيل. استخدم عند تصحيح الأخطاء، التحقيق في التأخير، التحقق من صحة الخدمة، إدارة التنبيهات، الاستجابة للحوادث، مراجعة معدل استهلاك SLO، أو العثور على كتب التشغيل.

الهيكلية

كيف يوجه Observability & Monitoring وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة Observability & Monitoring

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-observability

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-observability · الأدوات المسموح بها: 28

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

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

"خطأ"، "استثناء"، "500"، "فشل"؟

WORKFLOW 1: تصحيح الأخطاء

"بطيء"، "تأخير"، "انتهاء المهلة"، "p99"؟

WORKFLOW 2: تتبع التأخير

"الحالة الصحية"، "وحدة المعالجة المركزية"، "الذاكرة"، "القرص"؟

WORKFLOW 3: الحالة الصحية للنظام

"تنبيه"، "تفعيل"، "نداء"؟

WORKFLOW 4: إدارة التنبيهات

"حادث"، "انقطاع"، "تعطل"؟

WORKFLOW 5: الاستجابة للحوادث

"SLO"، "ميزانية الخطأ"، "الموثوقية"؟

WORKFLOW 6: تتبع SLO

"لوحة تحكم"، "نظرة عامة"؟

WORKFLOW 7: لوحات التحكم

غير واضح؟

ابدأ بـ get_system_health للحصول على صورة عامة

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

013-4 استدعاء

تصحيح الأخطاء

السجلات → التتبع → السبب الجذري

023-4 استدعاء

تتبع التأخير

العثور على الجزء البطيء

031-2 استدعاء

صحة النظام

نظرة عامة على وحدة المعالجة المركزية/الذاكرة/القرص

042-3 استدعاء

إدارة التنبيهات

فرز + كتاب تشغيل + تأكيد

053-4 استدعاء

الاستجابة للحوادث

الإعلان + التحقيق + الحل

062-3 استدعاء

تتبع SLO

الميزانية المتبقية + التوقعات

حدود الأداة

قد تستخدم المهارة 28 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-observability بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

query_logs

get_log_stats

get_errors

tail_logs

query_metric

list_metrics

get_system_health

compare_metrics

search_traces

get_trace

get_service_map

get_latency_breakdown

list_alerts

get_alert

create_alert

acknowledge_alert

list_incidents

get_incident

create_incident

update_incident

list_slos

get_slo

forecast_slo

list_dashboards

get_dashboard

get_runbook

list_services

get_service

قواعد العمل

ما الذي يجب على الوكيل القيام به.

اتبع دليل القرار، استخدم حدود الأداة المعلنة، وتحقق من النتيجة قبل الرد.

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

راجع SKILL.md الكامل قبل تمكين هذه المهارة للعمل الإنتاجي.

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-observability، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-observability-monitoring.git \
  ~/.skills/skills/observability-monitoring

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("observability-monitoring").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-observability (Datadog، Grafana Cloud، New Relic، أو API مخصص).

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md تدفقات عمل MCP المشتركة ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md شدة التنبيه ↗scripts/alert_severity.py تقرير الحوادث ↗assets/incident-report.md

استمر في الاستكشاف