OWL¶
OWL は、Guance がツール連携とインテリジェント化のシナリオ向けに提供する統合機能エントリポイントであり、OWL CLI と OWL MCP Server の 2 種類の接続形態をサポートします。
OWL を通じて、ユーザーは Guance のメトリクス、ログ、イベント、モニター、ダッシュボード、APM、RUM、インフラストラクチャなどの機能を統一的に呼び出せます。
OWL は Guance のコンソールや Open API を置き換えるものではなく、既存機能の上に、ツール呼び出し、自動化オーケストレーション、AI Agent での利用により適したラッパーエントリポイントを提供します。
接続方式を選択¶
| 利用方法 | 選択 | 開始方法 |
|---|---|---|
| Agent との対話で使用し、Agent がターミナルコマンドを実行できる場合 | OWL CLI + 付属 Skill | 統一自動インストールフロー |
| ターミナルで手動操作する場合、スクリプトを作成する場合、または自動化タスクを実行する場合 | OWL CLI | 手動インストール → CLI クイックスタート |
| クライアントにリモートサービスアドレスを入力し、MCP ツールを使用する場合 | OWL MCP Server | クライアント設定と初回呼び出し |
CLI は実行可能なコマンドです。owl-diagnostics Skill は Agent が CLI を使用するための付属ガイドです。MCP はクライアントがリモートツールサービスに接続するもう一つの方式です。リモート OWL MCP Server に接続する場合、クライアントに OWL CLI や CLI 付属 Skill をインストールする必要はありません。
サポートされる Agent とクライアント¶
ターミナル実行機能を備えた Codex、Claude Code、Cursor、Trae、GitHub Copilot(VS Code)、Windsurf などの Agent は、統一フローに従って CLI を使用できます。上記の製品および Claude Desktop、Cherry Studio、OpenClaw、Hermes など、Streamable HTTP と Bearer リクエストヘッダー認証をサポートするクライアントは、MCP ガイドに従って接続できます。
動作の仕組み¶
flowchart LR
user["ユーザー / スクリプト"] --> cli["OWL CLI"]
agent["AI Agent"] --> cli
agent --> mcp["OWL MCP Server"]
cli --> owl["OWL ツールカタログと実行サービス"]
mcp --> owl
owl --> platform["Guance のプラットフォーム機能"]
OWL CLI と OWL MCP Server は同じ種類のプラットフォーム機能にアクセスしますが、異なる接続方式とユースケースに対応します。
| 接続形態 | ユースケース | 主要機能 |
|---|---|---|
| OWL CLI | AI Agent、ローカルコマンドライン、スクリプト、自動化フロー | ツールカタログの同期、ツール説明の表示、ツールの実行、Agent Schema のエクスポート |
| OWL MCP Server | AI Agent、MCP クライアント統合 | Model Context Protocol に基づく標準化されたツールサービスインターフェースの提供 |
ユースケース¶
- ターミナルでメトリクス、ログ、イベント、モニター、ダッシュボードなどの情報を照会する
- 認可ワークスペースの検出とクロスワークスペースクエリを通じて、同じターゲットサイト内の複数の認可済みワークスペースのデータを照会する
- 導入・デリバリーの過程で、顧客ワークスペースのオブザーバビリティ機能を迅速に検証する
- 独立した Profile を使用して複数のアカウントや環境を保存し、ターミナル、スクリプト、または Agent で使用するアクセスアイデンティティを明示的に選択する
- Guance の機能を MCP 対応の AI クライアントに接続する
- Agent が自然言語に基づいて Guance の照会、分析、管理ツールを呼び出せるようにする
- 同一組織のワークスペースリスト(same-org)や、専用のクロスワークスペース Trace クエリツール(
owl.data.same_org.trace.query)、SLO リスト(owl.slo.list)、ドキュメント検索(mdsearch)などの機能を利用して、クロスワークスペースのトラブルシューティングとクエリを実施する
使用上の制限¶
無料プランのワークスペースでも、個人用 API Key を使用して OWL を利用できます。具体的な機能は、引き続きワークスペースのバージョンとアカウント権限によって制限されます。
- DPoP ログインでは、選択したアカウントとワークスペースの権限に従ってリソースにアクセスします。API Key を使用する場合、アクセス範囲は引き続きその Key に依存します。どちらの方式でも、対象ツールの読み取りまたは書き込み権限が必要です。
- 書き込み系ツールは、ダッシュボードの作成、モニターの更新、コメントの追加など、Guance 内のリソースを変更します。
- AI Agent または MCP クライアントに接続する際は、意図しない変更を避けるため、書き込み系操作に人的確認または承認の仕組みを設定することを推奨します。
OWL 経由で AI API を呼び出す場合、トリガーとしても課金され、モデルクレジットの消費とは別に集計されます。
クイックアクセス¶
シナリオ 1:CLI 経由で使用する(Agent、ターミナル、またはスクリプト)¶
Agent との対話で使用する場合は、まず自動インストールを選択してください。ターミナルを手動で操作する場合やスクリプトを作成する場合は、手動インストールと CLI クイックスタートを選択してください。
シナリオ 2:MCP クライアント経由で使用する¶
クライアントの MCP 設定を使用してリモートサービスに接続し、対話の中でツールを呼び出すのに適しています。