pup

Pup은 Datadog이 공개한 명령줄 인터페이스로, Datadog 관측성 플랫폼의 상당 부분을 단일 도구를 통해 노출합니다. README는 이를 "AI 에이전트에 적합한" CLI로 설명합니다. 명령은 스스로 발견할 수 있고, 출력은 파싱을 위해 JSON 또는 YAML로 구조화할 수 있으며, 인증은 장기 키만이 아니라 범위가 지정된 OAuth2와 PKCE를 지원합니다. 사람도 사용할 수 있습니다. 적용 범위는 여러 제품 영역에 걸쳐 있습니다. 핵심 관측성에는 메트릭(V1 및 V2), 로그, 이벤트, RUM(앱, 세션, 이벤트, 메트릭, 보존 필터, 리플레이 재생 목록, 시청률, 히트맵), APM 서비스와 엔터티, 트레이스, 데이터베이스 모니터링 샘플, 세션 리플레이가 포함됩니다. 모니터링과 알림은 모니터, 대시보드, SLO, 신서틱, 다운타임, 노트북, 상태 페이지, 워크플로 자동화, 그리고 pup/shell/http/workflow 단계 유형을 갖춘 YAML로 정의된 로컬 런북을 다룹니다. 보안과 규정 준수에는 보안 모니터링 규칙/시그널/파인딩, DDSQL을 통한 클라우드 및 애플리케이션 보안 파인딩, 정적 분석, 감사 로그, 데이터 거버넌스, 태그 거버넌스, CSM 위협, AWS/GCP/Azure용 에이전트리스 스캐닝, 로그 제한 쿼리, 데이터 삭제 요청이 포함됩니다. 인프라와 클라우드 명령은 호스트, 태그, 네트워크 흐름과 디바이스, AWS/GCP/Azure/OCI 통합, 컨테이너, 프로세스를 다룹니다. 인시던트와 운영 도구에는 인시던트, 온콜 팀과 페이지, Jira/ServiceNow 연동이 있는 케이스 관리, 오류 추적, 서비스 카탈로그, 스코어카드, 플릿 자동화, HAMR 연결, 조사, 변경 관리, 변경 스토리, 라이브 디버거 프로브, 소프트웨어 카탈로그 엔터티가 포함됩니다. CI/CD와 개발 범위에는 CI 가시성, 테스트 최적화와 불안정 테스트, DORA 메트릭, 코드 커버리지 요약, 배포 게이트가 포함됩니다. 조직과 접근 명령은 사용자, 조직, API 키, 앱 키, AuthN 매핑을 처리합니다. 플랫폼과 구성 영역에는 사용량 계량, 비용 관리와 Cloud Cost Management, 제품 분석, 서드파티 통합, 기능 플래그, Kafka 데이터 스트림(실험적), 제한된 데이터셋, 관측성 파이프라인, LLM 관측성, 참조 테이블, 기타 엔드포인트, App Builder가 포함됩니다. 설치 옵션은 datadog-labs/pack 탭을 통한 Homebrew, Cargo로 소스에서 빌드, 릴리스에서 미리 빌드된 바이너리 다운로드입니다. 인증은 우선순위 순서로 세 가지 방법을 지원합니다. DD_ACCESS_TOKEN을 통한 상태 비저장 베어러 토큰, `pup auth login`을 통해 얻은 OAuth2 토큰, DD_API_KEY와 DD_APP_KEY를 통한 API 키입니다. OAuth2는 자동 토큰 갱신이 있는 브라우저 기반 로그인을 사용하며 Datadog 사이트에서 Dynamic Client Registration이 필요합니다. 여러 사이트와 조직을 별도의 이름 있는 세션으로 저장하고 --org 또는 DD_ORG로 선택할 수 있습니다. 사이트 결정은 DD_SITE, 그다음 기록된 세션 사이트, 그다음 datadoghq.com 순서를 따릅니다. 토큰은 플랫폼 보안 저장소(macOS Keychain, Linux Secret Service, Windows Credential Manager)에 저장되며, ~/.config/pup/ 아래에 0600 권한을 사용하는 파일 기반 대체 저장 방식이 있고 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{*}"`가 있습니다. 정식 명령 참조는 docs/COMMANDS.md에 있으며, `pup --help` 또는 `pup agent schema`가 실시간 명령 목록을 제공합니다. 일부 영역은 아직 구현되지 않은 것으로 표시되어 있으며, 예를 들어 프로파일링, powerpacks, 역할 목록, IP 허용 목록이 있습니다. 이 프로젝트는 Apache 2.0 라이선스이며 Rust로 작성되었습니다.