इस प्रोजेक्ट के बारे में

Pup, Datadog द्वारा प्रकाशित एक कमांड-लाइन इंटरफ़ेस है जो एक ही टूल के माध्यम से Datadog observability प्लेटफ़ॉर्म के एक बड़े हिस्से को उजागर करता है। README इसे "AI-agent-ready" CLI के रूप में प्रस्तुत करता है: कमांड स्व-खोज योग्य हैं, आउटपुट को पार्सिंग के लिए JSON या YAML के रूप में संरचित किया जा सकता है, और प्रमाणीकरण केवल लंबे समय तक चलने वाली कुंजियों के बजाय scoped OAuth2 with PKCE का समर्थन करता है। मनुष्य भी इसका उपयोग कर सकते हैं। कवरेज कई उत्पाद क्षेत्रों में फैला हुआ है। Core observability में metrics (V1 और V2), logs, events, RUM (apps, sessions, events, metrics, retention filters, replay playlists, viewership, heatmaps), APM services और entities, traces, database monitoring samples, और session replay शामिल हैं। Monitoring और alerting में monitors, dashboards, SLOs, synthetics, downtimes, notebooks, status pages, workflow automation, और pup/shell/http/workflow step प्रकारों के साथ YAML-परिभाषित local runbooks शामिल हैं। Security और compliance में security monitoring rules/signals/findings, DDSQL के माध्यम से cloud और application security findings, static analysis, audit logs, data governance, tag governance, CSM threats, AWS/GCP/Azure के लिए agentless scanning, log restriction queries, और data deletion requests शामिल हैं। Infrastructure और cloud कमांड में hosts, tags, network flows और devices, AWS/GCP/Azure/OCI integrations, containers, और processes शामिल हैं। Incident और operations टूलिंग में incidents, on-call teams और pages, Jira/ServiceNow लिंकिंग के साथ case management, error tracking, service catalog, scorecards, fleet automation, HAMR connections, investigations, change management, change stories, live debugger probes, और software catalog entities शामिल हैं। CI/CD और development कवरेज में CI visibility, test optimization और flaky tests, DORA metrics, code coverage summaries, और deployment gates शामिल हैं। Organization और access कमांड users, organizations, API keys, app keys, और AuthN mappings को संभालते हैं। Platform और configuration क्षेत्रों में usage metering, cost management और Cloud Cost Management, product analytics, third-party integrations, feature flags, Kafka data streams (experimental), restricted datasets, observability pipelines, LLM observability, reference tables, miscellaneous endpoints, और App Builder शामिल हैं। इंस्टॉलेशन विकल्प हैं Homebrew के माध्यम से datadog-labs/pack tap, Cargo के साथ स्रोत से बिल्ड करना, या releases से पूर्व-निर्मित बाइनरी डाउनलोड करना। प्रमाणीकरण प्राथमिकता क्रम में तीन विधियों का समर्थन करता है: DD_ACCESS_TOKEN के माध्यम से stateless bearer token, `pup auth login` के माध्यम से प्राप्त OAuth2 tokens, और DD_API_KEY और DD_APP_KEY के माध्यम से API keys। OAuth2 ब्राउज़र-आधारित लॉगिन का उपयोग करता है जिसमें स्वचालित token refresh होता है और Datadog साइट पर Dynamic Client Registration की आवश्यकता होती है। कई साइटों और orgs को अलग-अलग नामित sessions के रूप में संग्रहीत किया जा सकता है और --org या DD_ORG के साथ चुना जा सकता है; साइट रिज़ॉल्यूशन DD_SITE, फिर रिकॉर्ड किए गए session site, फिर datadoghq.com का अनुसरण करता है। Tokens प्लेटफ़ॉर्म secure store (macOS Keychain, Linux Secret Service, Windows Credential Manager) में संग्रहीत किए जाते हैं, जिसमें ~/.config/pup/ के अंतर्गत 0600 अनुमतियों के साथ फ़ाइल-आधारित fallback होता है, जिसे DD_TOKEN_STORAGE या config के माध्यम से ओवरराइड किया जा सकता है। README में दिखाए गए उदाहरण उपयोग में `pup monitors list --tags="team:api-platform"`, `pup logs search --query="status:error" --from="1h"`, और `pup metrics query --query="avg:system.cpu.user{*}"` शामिल हैं। एक canonical command reference docs/COMMANDS.md में है, और `pup --help` या `pup agent schema` लाइव कमांड सूची प्रदान करता है। कुछ क्षेत्रों को अभी तक लागू नहीं किया गया बताया गया है, जैसे profiling, powerpacks, roles listing, और IP allowlist। यह प्रोजेक्ट Apache 2.0 लाइसेंस के अंतर्गत है और Rust में लिखा गया है।