コマンドラインと Agent ツール

エンジニアと AI Agent に統制された Guance コマンド層を

OWL CLI は、認可された Guance ワークスペースで利用できるツールカタログを同期し、ツール Schema を表示し、ターミナル、スクリプト、AI Agent ワークフローから対応するクエリや管理ツールを実行します。

次の指示を AI ツールへ貼り付けます。先にサイトの Endpoint を選び、一時認可コードを置き換えてください：

https://static.guance.com/owl/skill.md を読み、その手順に従って現在の環境へ OWL CLI と OWL Skill をインストールして設定してください。

インストール値：
OWL_REGISTRY_ENDPOINT="<OWL_REGISTRY_ENDPOINT>"
OWL_TEMP_CODE="<YOUR_TEMP_CODE>"

ワークスペースのサイトに対応する OWL_REGISTRY_ENDPOINT を Endpoint 表から選びます。OWL_TEMP_CODE は Guance コンソールの個人 API キーページで生成します。

Linux / macOS 用コマンドです。先にサイトの Endpoint を選び、一時認可コードを置き換えてください：

export OWL_INSTALL_BASE_URL="https://static.guance.com/owl"
export OWL_REGISTRY_ENDPOINT="<OWL_REGISTRY_ENDPOINT>"
export OWL_TEMP_CODE="<YOUR_TEMP_CODE>"
bash -c "$(curl -fsSL "${OWL_INSTALL_BASE_URL}/install.sh")" -- --yes

インストールガイドを見る OWL CLI を確認する

OWL CLI の役割

設定した認証情報で許可されたツールを公開し、実行前に入力を確認できるようにする

OWL CLI は Guance コンソールや OpenAPI を置き換えません。カタログ同期、Schema 確認、クエリ、対応する操作にツール指向の入口を提供します。ツールの表示と結果は API Key の権限に従い、書き込みツールはワークスペースのリソースを変更するため、明示的なレビューまたは承認を挟む必要があります。

ターミナル、スクリプト、対応する AI Agent ツールから OWL を利用

クライアントごとに機能とインストール手順が異なります。OWL を実行する環境に合う最新の設定ガイドを確認してください。

Claude Code

Codex

Cursor

Trae

GitHub Copilot

Windsurf

実際のオブザーバビリティ運用に使うツールカタログ

カタログは Guance から同期され、プラットフォーム機能とともに更新されます。`owl list` と `owl show` で、現在のワークスペースにあるツール、パラメーター、権限を確認してください。

オブザーバビリティデータを照会

対応するメトリクス、ログ、RUM、APM、ネットワーク、Profiling、課金などのデータを探索・照会します。

DQL ワークフローを検証

DQL ガイドを検索し、完成したクエリを検証してから、意図したデータ範囲で実行します。

イベントとインシデントを確認

認可済みツールが公開するイベント、インシデント、コメント、操作履歴、オンコール情報を読み取ります。

リソースとトポロジーを確認

カタログエンティティ、インフラストラクチャレコード、詳細、利用可能な関係を照会します。

モニターと SLO を扱う

権限に応じて対応するモニターを一覧・管理し、利用可能な SLO コンテキストを確認します。

ダッシュボードを扱う

認証情報に必要な権限がある場合、文書化されたダッシュボード操作を参照または実行します。

ブラックボックスの回答ではなく、レビュー可能なワークフロー

具体的な運用上の問いから始め、ツール呼び出しとパラメーターを可視化し、返された証拠と最終的なエンジニアリング判断を分けます。

本番 Endpoint の 5xx が急増した

オンコール：直近 30 分の prod /checkout エラーを調べる

認可済みの探索・クエリツールで対象データソースを特定し、クエリを検証して、サービス、Endpoint、環境、バージョン別にログまたは Trace の証拠を比較します。

範囲サービスと時間

→

証拠ログと Trace

→

レビュー影響バージョン

複数ワークスペースにまたがる Trace を調べる

プラットフォーム担当：同一組織のワークスペースからこの Trace ID を探す

利用可能な場合はワークスペース探索と専用 Trace クエリを使い、返されたワークスペース、サービス、Span のコンテキストを確認してから結論を出します。

探索ワークスペース

→

クエリTrace の証拠

→

レビューサービス経路

日次運用レビューの入力を揃える

SRE：毎朝、主要サービスのエラー、遅いリクエスト、モニター状態を確認する

スクリプトや Agent が読み取り専用ツールを定期実行し、サマリーの下書きを作成できます。クエリ期間と結果を残し、対応前にエンジニアが変化を検証します。

収集定義済みシグナル

→

比較重要な変化

→

レビューサマリー下書き

関連する AI とプラットフォーム機能

Guance MCP Server

MCP 対応 AI クライアントへ認可済み Guance ツールを公開します。

AI Agent オブザーバビリティ

Agent Session、ワークフロー、モデル呼び出し、ツール呼び出しを追跡します。

プログラマビリティ

DQL、API、DataFlux Func で統制されたワークフローを構築します。

OWL CLI のよくある質問

OWL CLI とは何ですか？

Guance のコマンドライン入口です。ツールカタログを同期し、ツールの説明と Schema を確認し、ターミナル、スクリプト、AI Agent ワークフローから対応する Guance ツールを実行します。

OWL CLI ではどの機能を利用できますか？

カテゴリとツールは現在の Guance サービスから返され、設定したワークスペースと API Key 権限に依存します。固定のマーケティング一覧ではなく、`owl sync`、`owl list`、`owl show` で現在のカタログを確認してください。

OWL CLI は書き込み操作に対応しますか？

文書化された一部のツールはリソースを作成または更新します。書き込みは Guance ワークスペースを変更し、対応する権限が必要です。AI Agent が実行する前に手動確認などの承認制御を設けてください。

OWL CLI と OWL MCP Server の関係は？

どちらも Guance のツール指向機能を公開します。OWL CLI はローカルのコマンドライン、スクリプト、Agent ワークフロー向けで、OWL MCP Server は Model Context Protocol を通じてクライアントへツールを提供します。

導入ガイド

LLM 呼び出し、Token 使用量、Trace コンテキストを可視化する

モデルリクエスト、レイテンシー、エラー、Token 使用量、ワークフロー Span を同じ調査で確認します。

製品ガイド

AI Agent の実行を運用レビュー可能にする

AI Agent の実行を運用レビュー可能にする

Agent Session、Trace、ツール呼び出し、実行コンテキストを記録し、モデル出力だけを証拠として扱わない運用を設計します。

導入ガイド

OWL CLI をエンジニアリングと AI Agent のワークフローで使う

OWL CLI をエンジニアリングと AI Agent のワークフローで使う

利用可能なツールカタログを同期し、Schema を確認して、認可された Guance ツールをターミナルから実行します。

製品ガイド

MCP クライアントを認可済み Guance ツールへ接続する

MCP クライアントを認可済み Guance ツールへ接続する

MCP 接続と認証を設定し、クライアントへ公開されるツールを確認します。

導入ガイド