منصوبے کے بارے میں

Pup ایک کمانڈ لائن انٹرفیس ہے جو Datadog کی جانب سے شائع کیا گیا ہے اور ایک ہی ٹول کے ذریعے Datadog observability پلیٹ فارم کے ایک وسیع حصے کو ظاہر کرتا ہے۔ README اسے ایک "AI-agent-ready" CLI کے طور پر پیش کرتا ہے: کمانڈز خود دریافت ہوتی ہیں، آؤٹ پٹ کو پارس کرنے کے لیے JSON یا YAML کے طور پر structured کیا جا سکتا ہے، اور تصدیق صرف طویل مدتی keys کے بجائے scoped OAuth2 بمع PKCE کی سہولت دیتی ہے۔ انسان بھی اسے استعمال کر سکتے ہیں۔ کوریج کئی پروڈکٹ شعبوں پر محیط ہے۔ بنیادی 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-defined مقامی 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 (تجرباتی)، restricted datasets، observability pipelines، LLM observability، reference tables، متفرق endpoints، اور App Builder شامل ہیں۔ انسٹالیشن کے اختیارات datadog-labs/pack tap کے ذریعے Homebrew، Cargo کے ساتھ سورس سے build کرنا، یا releases سے پہلے سے بنائی گئی binaries ڈاؤن لوڈ کرنا ہیں۔ تصدیق ترجیحی ترتیب میں تین طریقوں کی سہولت دیتی ہے: DD_ACCESS_TOKEN کے ذریعے stateless bearer token، `pup auth login` کے ذریعے حاصل کردہ OAuth2 tokens، اور DD_API_KEY اور DD_APP_KEY کے ذریعے API keys۔ OAuth2 خودکار token refresh کے ساتھ browser-based login استعمال کرتا ہے اور Datadog سائٹ پر Dynamic Client Registration کی ضرورت ہوتی ہے۔ متعدد sites اور orgs کو الگ الگ نامزد sessions کے طور پر محفوظ کیا جا سکتا ہے اور --org یا DD_ORG کے ساتھ منتخب کیا جا سکتا ہے؛ site resolution DD_SITE، پھر ریکارڈ شدہ session site، پھر datadoghq.com کی پیروی کرتی ہے۔ Tokens پلیٹ فارم secure store (macOS Keychain، Linux Secret Service، Windows Credential Manager) میں محفوظ کیے جاتے ہیں، جس میں ~/.config/pup/ کے تحت 0600 permissions کے ساتھ file-based fallback موجود ہے، جسے DD_TOKEN_STORAGE یا config کے ذریعے override کیا جا سکتا ہے۔ 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` live command list فراہم کرتا ہے۔ کچھ شعبے ابھی تک نافذ نہیں کیے گئے، جیسے profiling، powerpacks، roles listing، اور IP allowlist۔ یہ پروجیکٹ Apache 2.0 لائسنس یافتہ ہے اور Rust میں لکھا گیا ہے۔