Pup CLI

概要

Pup CLIは、AI エージェントが Datadog の監視可能性プラットフォームにアクセスできる、包括的な AI エージェント対応のコマンドラインインターフェイスです。AI エージェントのワークフローや自動化パイプラインで使用するために、Datadog の API サーフェスが公開されています。

主な特徴:

自己発見可能なコマンド; コマンドは、エージェントが外部ドキュメントなしでナビゲートできるように構成されています。
構造化された出力: 応答は、信頼性のある解析のために JSON および YAML で利用可能です。
限定認証: OAuth2 と PKCE は、長期 API キーを使わずに限定アクセスを提供します。
広範な製品カバレッジ: Pupは、モニター、ログ、メトリクス、RUM、セキュリティなどをサポートします。

このページは、Pup のコア機能をカバーしています。機能とコマンドの完全なリストは、Pup リポジトリのドキュメントを参照してください。

インストール

Homebrew (macOS/Linux)

brew tap datadog-labs/pack
brew install datadog-labs/pack/pup

ソースからビルドする

git clone https://github.com/DataDog/pup.git && cd pup
cargo build --release
cp target/release/pup /usr/local/bin/pup

手動ダウンロード

最新のリリースから事前ビルドされたバイナリをダウンロードします。

使用例

# Log in to Datadog
pup auth login

# List monitors filtered by tag
pup monitors list --tags="team:api-platform"

# Search logs for errors in the last hour
pup logs search --query="status:error" --from="1h"

# Query CPU metrics
pup metrics query --query="avg:system.cpu.user{*}" --from="1h"

# Get dashboard details
pup dashboards get <DASHBOARD_ID>

# Delete a dashboard
pup dashboards delete <DASHBOARD_ID> --yes

サポートされている製品領域

Pup は主要な Datadog 製品サーフェスをほとんどカバーしています。標準的な製品固有のコマンドリストについては、コマンドリファレンスを参照してください。ライブのコマンドリストを表示するには、pup --help (または機械可読出力用の pup agent schema) を実行することもできます。

カテゴリ	例
コア監視可能性	メトリクス、ログ、イベント、RUM、APM、トレース
監視とアラート	モニター、ダッシュボード、SLO、合成テスト、ダウンタイム、ワークフロー
セキュリティとコンプライアンス	セキュリティルール、シグナル、所見、監査ログ、CSM 脅威
インフラストラクチャーとクラウド	ホスト、タグ、コンテナ、ネットワーク、AWS/GCP/Azure インテグレーション
インシデントとオペレーション	インシデント、オンコール、ケース管理、エラートラッキング、サービスカタログ
CI/CD と開発	CIの可視性、テスト最適化、DORA メトリクス、デプロイメントゲート
組織とアクセス	ユーザー、API キー、アプリケーションキー、組織
プラットフォームと設定	使用量計測、コスト管理、機能フラグ、監視可能性パイプライン

エージェントモード

Pup が AI コーディングエージェントによって呼び出されると、自動的にエージェントモードに切り替わり、機械による使用に最適化された構造化 JSON 応答を返します。応答にはメタデータ、エラー詳細、およびヒントが含まれます。エージェントモードでは、確認プロンプトは自動的に承認されます。

サポートされるコーディングエージェントの場合、環境変数が設定されていれば、エージェントモードは自動検出されます。--agent フラグを使用するか、FORCE_AGENT_MODE=1 を設定することで、明示的に有効にすることもできます。

その他の機能

Pup には AI エージェントワークフローで使用できる追加機能が含まれています。詳細については、以下のリンクを参照してください。

ランブック: pup runbooksは、YAMLで定義された運用手順のためのローカル実行エンジンであり、pup、シェル、HTTP、および Datadog ワークフローステップを使用してマルチステップタスクをエンコードします。
エージェントスキル: Pup にはバイナリに埋め込まれたスキルとドメインエージェントが付属しており、pup skills install を使用して任意の AI コーディングアシスタントにインストール可能です。
ACP サーバー: pup acp serve は、コーディングツールを ACP および OpenAI 互換プロトコルを通じて Datadog Bits AI に接続するローカル AI エージェントサーバーを実行します。

認証

Pup は OAuth2 および API キー認証方法をサポートしています。OAuth2 が推奨されます。ブラウザを通じて認証するには pup auth login を実行してください。OAuth2 が利用できない場合、Pup は API キー (DD_API_KEY および DD_APP_KEY) にフォールバックします。詳細については認証ドキュメントを参照してください。

グローバルフラグ

フラグ	説明
`-o, --output`	出力形式 (`json`、`table`、`yaml`)。デフォルト: `json`
`-y, --yes`	破壊的操作に対する確認プロンプトをスキップする
`--agent`	エージェントモードを有効にする
`--no-agent`	エージェントモードを無効にする
`--read-only`	すべての書き込み操作 (作成、更新、削除) をブロックする
`--org <org>`	マルチアカウントワークフローのために名前付き組織プロファイルを使用する (セットアップするには `pup auth login --org` を実行)
`-h, --help`	ヘルプを表示する

環境変数

変数	説明
`DD_ACCESS_TOKEN`	ステートレス認証のためのベアラートークン
`DD_API_KEY`	Datadog API キー (OAuth2 または`DD_ACCESS_TOKEN` を使用する場合はオプション)
`DD_APP_KEY`	Datadog アプリケーションキー (OAuth2 または `DD_ACCESS_TOKEN` を使用する場合はオプション)
`DD_SITE`	Datadog サイト (デフォルト: `datadoghq.com`)
`DD_AUTO_APPROVE`	破壊的操作の自動承認 (`true`/`false`)
`DD_TOKEN_STORAGE`	トークンストレージバックエンド (`keychain`または`file`、デフォルト: 自動検出)