عن المشروع

Pup هي واجهة سطر أوامر تنشرها Datadog وتتيح الوصول إلى جزء واسع من منصة المراقبة Datadog عبر أداة واحدة. يصفها ملف README بأنها واجهة سطر أوامر "جاهزة لوكلاء الذكاء الاصطناعي": فالأوامر قابلة للاستكشاف الذاتي، ويمكن هيكلة الإخراج بصيغة JSON أو YAML لتسهيل تحليله، وتدعم المصادقة OAuth2 بنطاقات محددة مع PKCE بدلاً من الاعتماد فقط على مفاتيح طويلة الأجل. ويمكن للبشر استخدامها أيضاً. تمتد التغطية عبر مجالات منتجات متعددة. تشمل المراقبة الأساسية المقاييس (V1 وV2)، والسجلات، والأحداث، وRUM (التطبيقات، والجلسات، والأحداث، والمقاييس، ومرشحات الاحتفاظ، وقوائم إعادة التشغيل، ومشاهدة المحتوى، والخرائط الحرارية)، وخدمات APM والكيانات، والتتبعات، وعينات مراقبة قواعد البيانات، وإعادة تشغيل الجلسات. وتغطي المراقبة والتنبيهات: المراقبات، ولوحات المعلومات، وSLOs، والاختبارات الاصطناعية، وفترات التوقف، والدفاتر، وصفحات الحالة، وأتمتة سير العمل، ودفاتر التشغيل المحلية المعرّفة بـ YAML مع أنواع خطوات pup/shell/http/workflow. وتشمل الأمن والامتثال: قواعد/إشارات/نتائج المراقبة الأمنية، ونتائج الأمن السحابي والتطبيقي عبر DDSQL، والتحليل الساكن، وسجلات التدقيق، وحوكمة البيانات، وحوكمة الوسوم، وتهديدات CSM، والفحص بدون وكيل لـ AWS/GCP/Azure، واستعلامات تقييد السجلات، وطلبات حذف البيانات. تغطي أوامر البنية التحتية والسحابة: المضيفين، والوسوم، وتدفقات الشبكة والأجهزة، وتكاملات AWS/GCP/Azure/OCI، والحاويات، والعمليات. وتشمل أدوات الحوادث والعمليات: الحوادث، وفرق الاستدعاء والصفحات، وإدارة الحالات مع الربط بـ Jira/ServiceNow، وتتبع الأخطاء، وكتالوج الخدمات، وبطاقات الأداء، وأتمتة الأسطول، واتصالات HAMR، والتحقيقات، وإدارة التغيير، وقصص التغيير، ومجسات المصحح المباشر، وكيانات كتالوج البرمجيات. وتشمل تغطية CI/CD والتطوير: رؤية CI، وتحسين الاختبارات والاختبارات المتقلبة، ومقاييس DORA، وملخصات تغطية الكود، وبوابات النشر. وتتعامل أوامر المؤسسة والوصول مع المستخدمين، والمؤسسات، ومفاتيح API، ومفاتيح التطبيقات، وخرائط AuthN. وتشمل مجالات المنصة والإعداد: قياس الاستخدام، وإدارة التكاليف وإدارة تكاليف السحابة، وتحليلات المنتج، وتكاملات الطرف الثالث، وأعلام الميزات، وتدفقات بيانات Kafka (تجريبية)، ومجموعات البيانات المقيّدة، وخطوط أنابيب المراقبة، ومراقبة LLM، والجداول المرجعية، ونقاط النهاية المتنوعة، وApp Builder. خيارات التثبيت هي Homebrew عبر tap datadog-labs/pack، أو البناء من المصدر باستخدام Cargo، أو تنزيل ملفات ثنائية جاهزة من الإصدارات. تدعم المصادقة ثلاث طرق بترتيب الأولوية: رمز حامل عديم الحالة عبر DD_ACCESS_TOKEN، ورموز OAuth2 التي يتم الحصول عليها عبر `pup auth login`، ومفاتيح API عبر DD_API_KEY وDD_APP_KEY. يستخدم OAuth2 تسجيل دخول عبر المتصفح مع تحديث تلقائي للرموز ويتطلب Dynamic Client Registration على موقع Datadog. يمكن تخزين مواقع ومؤسسات متعددة كجلسات مسماة منفصلة واختيارها عبر --org أو DD_ORG؛ ويتبع تحديد الموقع DD_SITE، ثم موقع الجلسة المسجل، ثم datadoghq.com. تُخزَّن الرموز في مخزن المنصة الآمن (macOS Keychain، أو Linux Secret Service، أو Windows Credential Manager) مع بديل قائم على الملفات تحت ~/.config/pup/ بأذونات 0600، ويمكن تجاوزه عبر DD_TOKEN_STORAGE أو الإعدادات. تشمل أمثلة الاستخدام الواردة في README: `pup monitors list --tags="team:api-platform"`، و`pup logs search --query="status:error" --from="1h"`، و`pup metrics query --query="avg:system.cpu.user{*}"`. ويوجد مرجع أوامر أساسي في docs/COMMANDS.md، كما يوفر `pup --help` أو `pup agent schema` قائمة الأوامر الحية. وتُذكر بعض المجالات على أنها غير منفذة بعد، مثل profiling، وpowerpacks، وسرد الأدوار، وقائمة IP المسموح بها. المشروع مرخص بموجب Apache 2.0 ومكتوب بلغة Rust.