MCP ツール一覧¶
このドキュメントでは、OWL MCP Server で現在 MCP から呼び出せるビジネスツール機能について説明します。ツール分類、権限タイプ、利用上の取り決め、ツール一覧、代表的な MCP 利用パスを含みます。
ツールの表示範囲と呼び出し結果は、現在接続に使用している API Key の権限によって決まります。API Key に関連リソースまたは操作の権限がない場合、該当するツール呼び出しは失敗するか、空の結果が返されることがあります。
注意
OWL MCP Server はデフォルトで facade モードを使用し、クライアントにはまず list_catalogs、list_tools、exec_tool の 3 つのラッパーツールが表示されます。サーバー側で static モードを有効にすることもでき、MCP tools/list で呼び出しを許可するビジネスツールを直接公開し、サーバー側の除外リストに従って指定ツールを非表示にします。一部のツールは OWL CLI でのみ提供され、MCP からは実行できません(例: ダッシュボード関連ツール)。実際に表示されるツールはクライアントの tools/list 結果に準拠します。
v1.8.0 ではフィールド検索、ページネーション、ノートの expected_etag が追加されました。完全なパラメータは現在のツール schema に準拠します。アップグレード順序と書き込み復旧ルールについては、v1.8.0 更新説明を参照してください。
ツール範囲¶
OWL MCP Server で実行できるビジネスツールは、プラットフォームの機能に合わせて継続的に更新されます。実際に実行可能なツールは、list_catalogs と list_tools が返すツールカタログに準拠します。
現在のドキュメントでは、次のビジネス分類を扱います。
| 分類 | 説明 |
|---|---|
account |
同一組織のワークスペース検出 |
catalog |
統合カタログエンティティのクエリ、作成、変更、トポロジー関係のクエリ |
data |
データソース/フィールドの検出、ログインデックスの検出、SLO、ログパターン、課金情報の検出、簡易データクエリ、同一組織内のワークスペース横断 Trace クエリ |
errors |
エラーセンターの Issue クエリとコメント管理 |
event |
イベント一覧クエリとイベント詳細取得 |
incident |
インシデント一覧と詳細、関連イベント参照、インシデントコメント、操作履歴、オンコールシフト |
infrastructure |
ホスト、コンテナ、プロセスなどのインフラストラクチャオブジェクトのクエリ |
llm |
LLM オブザーバビリティアプリケーション一覧のクエリ |
workspace |
ワークスペース横断データクエリの認可範囲検出、現在のワークスペースのメンバーとチームのクエリ |
mdsearch |
統合ドキュメントコーパスの検索、ドキュメント読み取り、ディレクトリ閲覧 |
monitor |
モニターのクエリ、作成、更新、外部イベント受信 |
nbook_note |
ノートのクエリ、読み取り、作成、変更、削除 |
pipeline |
Pipeline 一覧クエリとサンプル検証 |
権限タイプ¶
| 権限タイプ | 意味 | 使用上の推奨 |
|---|---|---|
| 読み取り専用 | クエリ、検索、詳細取得、サンプル検証など、ワークスペースリソースを変更しない操作 | Agent による自動呼び出しに必要に応じて開放できます |
| 書き込み | 作成、更新、コメント追加、外部イベント受信など、ワークスペースリソースを変更する操作 | Agent クライアントで人手による確認を設定することを推奨します |
利用上の取り決め¶
facade モードでは、MCP クライアントは次の順序で呼び出します。
list_catalogsを呼び出して利用可能な分類を確認します。list_toolsを呼び出し、catalog_idを渡して、その分類下のビジネスツールとパラメータを確認します。exec_toolを呼び出し、tool_nameとparametersを渡してビジネスツールを実行します。
static モードでは、クライアントは 3 つのラッパーツールを経由せずに、tools/list が返すビジネスツールを直接呼び出せます。どちらのモードを使用する場合でも、ツールのパラメータと権限要件は同じです。
| タイプ | 取り決め |
|---|---|
| 時間範囲 | 13 桁のミリ秒タイムスタンプを統一使用 |
| ページネーションパラメータ | 通常は page_size と page_index を使用 |
| 詳細クエリ | 通常は一覧ツールが返す UUID、ID、URN などの識別子に依存 |
| データクエリ | 先に検出系ツールを呼び出して source、field、index を取得し、その後クエリ系ツールを呼び出すことを推奨 |
| 戻り値構造 | 実際のツール応答に準拠します。DQL クエリのフィールドの意味については、戻り値フィールドの説明を参照してください。 |
ツール一覧¶
| ツールセット | ツール | 機能 | 権限 |
|---|---|---|---|
| account | owl.account.workspace.same_org.list |
現在の API Key のワークスペースと同一組織のワークスペースを一覧表示 | 読み取り専用 |
| catalog | owl.catalog.entity_type_query |
統合カタログがサポートするエンティティタイプをクエリ | 読み取り専用 |
| catalog | owl.catalog.entity_query |
タイプ、名前、URN、または属性でエンティティをフィルタ | 読み取り専用 |
| catalog | owl.catalog.entity_get |
urn で単一エンティティの詳細を取得 |
読み取り専用 |
| catalog | owl.catalog.entity_create |
既存のエンティティタイプの下にエンティティを作成 | 書き込み |
| catalog | owl.catalog.entity_modify |
指定エンティティの表示名、属性、または関係を変更 | 書き込み |
| catalog | owl.catalog.entity_topology_query |
単一エンティティに関連するトポロジー関係をクエリ | 読み取り専用 |
| data | owl.data.show_dql_namespace |
DQL namespace を表示 | 読み取り専用 |
| data | owl.data.simple_query |
簡易パラメータからクエリ文を自動組み立て | 読み取り専用 |
| data | owl.external_datasource.list |
現在のワークスペースでアクセス可能な外部データソースを検出 | 読み取り専用 |
| data | owl.external_datasource.query |
設定済み外部データソースに対して制限付き読み取り専用 SQL を実行 | 読み取り専用 |
| data | owl.data.same_org.trace.query |
trace_id で現在または同一組織のワークスペースにある Trace をクエリ |
読み取り専用 |
| data | owl.metric.list |
メトリクスクエリで利用可能な source またはフィールドを検出 |
読み取り専用 |
| data | owl.rum.list |
RUM クエリで利用可能な source またはフィールドを検出 |
読み取り専用 |
| data | owl.apm.list |
APM クエリで利用可能な source またはフィールドを検出 |
読み取り専用 |
| data | owl.network.list |
Network クエリで利用可能な source またはフィールドを検出 |
読み取り専用 |
| data | owl.profile.list |
Profile クエリで利用可能な source またはフィールドを検出 |
読み取り専用 |
| data | owl.logging.list |
ログクエリで利用可能な source またはフィールドを検出 |
読み取り専用 |
| data | owl.logging.cluster_task.create |
ログパターン分析の非同期タスクを作成 | 読み取り専用 |
| data | owl.logging.cluster_task.get |
ログパターン分析タスクの結果を取得 | 読み取り専用 |
| data | owl.billing.list |
クラウド請求クエリで利用可能な source またはフィールドを検出 |
読み取り専用 |
| data | owl.slo.list |
現在のワークスペースの SLO 一覧をクエリ | 読み取り専用 |
| data | owl.log_index.list |
ログクエリで利用可能なインデックスを一覧表示 | 読み取り専用 |
| data | owl.log_index.get |
単一ログインデックスの詳細をクエリ | 読み取り専用 |
| data | owl.field_schema.get |
現在のフィールドカタログをクエリし、クエリフィールドの補完に使用 | 読み取り専用 |
| data | owl.field_schema.search |
必要に応じてフィールド、メトリクス、measurement 設定を検索 | 読み取り専用 |
| errors | owl.errors.list |
エラーセンターの Issue 一覧をクエリ | 読み取り専用 |
| errors | owl.errors.comment.add |
エラー Issue にコメントを追加 | 書き込み |
| errors | owl.errors.comment.list |
エラー Issue のコメント一覧をクエリ | 読み取り専用 |
| errors | owl.errors.comment.update |
既存のエラーコメントを更新 | 書き込み |
| event | owl.event.list |
イベント一覧をクエリ | 読み取り専用 |
| event | owl.event.get |
単一イベントの詳細をクエリ | 読み取り専用 |
| event | owl.event.resolve |
イベントドキュメント ID、イベントまたはインシデント ID、リンクからイベント詳細を解決 | 読み取り専用 |
| incident | owl.incident.list |
インシデント一覧をクエリ | 読み取り専用 |
| incident | owl.incident.get |
インシデント詳細とページネーションされた関連イベント参照をクエリ | 読み取り専用 |
| incident | owl.incident_comment.list |
インシデントコメント一覧をクエリ | 読み取り専用 |
| incident | owl.incident_comment.add |
インシデントにコメントを追加 | 書き込み |
| incident | owl.incident_operation.list |
インシデント操作履歴をクエリ | 読み取り専用 |
| incident | owl.incident_schedule.list |
オンコールシフト一覧をクエリ | 読み取り専用 |
| incident | owl.incident_schedule.get |
オンコールシフト詳細をクエリ | 読み取り専用 |
| infrastructure | owl.infrastructure.list |
インフラストラクチャオブジェクト一覧をクエリ | 読み取り専用 |
| infrastructure | owl.infrastructure.get |
単一インフラストラクチャオブジェクトの詳細をクエリ | 読み取り専用 |
| llm | owl.llm.list |
LLM アプリケーション一覧をクエリ | 読み取り専用 |
| workspace | owl.workspace.data_authorized.list |
サイトごとに、現在のワークスペースにデータクエリ権限を付与しているワークスペースを一覧表示 | 読み取り専用 |
| workspace | owl.workspace.member.list |
ワークスペースメンバー一覧をクエリ | 読み取り専用 |
| workspace | owl.workspace.member.group_list |
現在のワークスペースのチームをクエリ | 読み取り専用 |
| mdsearch | mdsearch_search |
統合ドキュメントコーパスを検索し、候補ドキュメントを返す | 読み取り専用 |
| mdsearch | mdsearch_document |
ID または path で完全なドキュメントを読み取る | 読み取り専用 |
| mdsearch | mdsearch_catalog |
ドキュメントコーパスのディレクトリ構造を閲覧 | 読み取り専用 |
| monitor | owl.monitor.list |
モニター一覧をクエリ | 読み取り専用 |
| monitor | owl.monitor.upsert |
モニターを作成または既存モニターを更新 | 書き込み |
| monitor | owl.monitor.receive |
既存の受信エンドポイントに外部イベントを送信、またはレシーバーを作成してからイベントを送信 | 書き込み |
| monitor | owl.monitor.get |
モニター詳細をクエリ | 読み取り専用 |
| nbook_note | owl.nbook_note.list |
現在のアカウントで表示可能なノート概要をクエリ | 読み取り専用 |
| nbook_note | owl.nbook_note.get |
ノート詳細と Markdown 本文を取得 | 読み取り専用 |
| nbook_note | owl.nbook_note.add |
ノートを作成 | 書き込み |
| nbook_note | owl.nbook_note.modify |
ノートを変更 | 書き込み |
| nbook_note | owl.nbook_note.delete |
ノートを削除 | 書き込み |
| pipeline | owl.pipeline.list |
Pipeline 一覧をクエリし、デコード後の内容を返す | 読み取り専用 |
| pipeline | owl.pipeline.validate |
サンプルデータで Pipeline の処理結果を検証 | 読み取り専用 |
Account¶
同一組織の検出には次の表のツールを使用します。取得した workspace_uuid は owl.data.same_org.trace.query の workspace_uuids 入力パラメータとして使用でき、ワークスペース横断の Trace クエリに利用できます。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.account.workspace.same_org.list |
現在のワークスペースと同一組織のワークスペースを workspace id の降順で一覧表示 | 現在のワークスペースと同一組織のワークスペースを一覧表示 | workspace_uuids、page_size、before_workspace_id |
読み取り専用 |
注意: 戻り値の
workspace_uuidが後続のworkspace_uuids入力パラメータです。workspace_idは一覧のページネーションにのみ使用し、Trace クエリツールには渡さないでください。
v1.6.0 以降は owl exec owl.account.workspace.same_org.list で呼び出せ、owl workspace same-org list および MCP と一覧の契約を共有します。結果には items と page_info が含まれます。page_size のデフォルトは 20、範囲は 1~100 です。次のページは next_before_workspace_id をそのまま正の整数 before_workspace_id として渡し、配列インデックスから推測しないでください。workspace_uuids で結果をフィルタでき、空配列はフィルタなしを意味します。返された workspace_uuid は同一組織の Trace クエリにのみ使用してください。この一覧は通常のデータクエリ認可を確立しません。
Catalog¶
統合カタログのエンティティタイプ検出、エンティティクエリ、作成、変更、トポロジー関係のクエリに使用します。エンティティの作成・変更に使用する API Key には、カタログ管理権限が必要です。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.catalog.entity_type_query |
統合カタログがサポートするエンティティタイプをクエリ | 現在の Catalog がサポートするエンティティタイプを一覧表示 | page_size、page_index |
読み取り専用 |
owl.catalog.entity_query |
タイプ、名前、URN、または属性でエンティティをフィルタ | checkout-api という名前の service エンティティを完全一致で検索 |
entity_type, name, search, urn, filters, page_size, page_index |
読み取り専用 |
owl.catalog.entity_get |
urn で単一エンティティの詳細を取得 |
この urn に対応するエンティティ詳細をクエリ |
urn |
読み取り専用 |
owl.catalog.entity_create |
既存のエンティティタイプの下にエンティティを作成 | checkout-api という名前のサービスエンティティを作成 |
request_id、entity_type、name、display_name、attributes、relation_modes |
書き込み |
owl.catalog.entity_modify |
指定エンティティの表示名、属性、または関係を変更 | サービスエンティティの表示名を変更し、その他の設定は保持 | request_id、urn、display_name、attributes、relation_modes |
書き込み |
owl.catalog.entity_topology_query |
単一エンティティに関連するトポロジー関係をクエリ | このホストエンティティの上流・下流トポロジーを表示 | urn |
読み取り専用 |
entity_query では entity_type を必ず指定します。name は完全一致、search は名前、表示名、URN のあいまい検索に使用し、両者は同時に使用できません。完全な urn または filters で範囲を絞り込むこともできます。
エンティティの作成と変更¶
OWL に接続した後、ツール呼び出しをサポートする AI クライアントで明確な要件を提示できます。例:
- 「まず service タイプに必要な属性を確認し、
checkout-apiという名前のエンティティを作成してください。書き込み前に確認が必要な設定を一覧表示してください。」 - 「
checkout-apiエンティティの表示名を「決済サービス」に変更し、その他の属性と関係は変更しないでください。」
まずエンティティタイプのフィールド要件をクエリし、その後に対象エンティティを検索することを推奨します。作成には owl.catalog.entity_create を使用し、変更にはクエリで返された完全な urn を使って owl.catalog.entity_modify を呼び出します。所属チームを設定する必要がある場合は、先に owl.workspace.member.group_list でチーム名を取得します。完了後は、プラットフォームの統合カタログに戻ってエンティティを確認できます。
作成時は request_id、entity_type、name を必ず指定し、タイプの要件に従って attributes を補完します。変更時は request_id と urn を必ず指定し、変更する内容を少なくとも 1 項目指定します。request_id には今回の操作を識別する UUID を使用します。表示名には display_name を使用し、変更ツールではエンティティ名やタイプを変更できません。
変更時、送信されていない属性と関係は保持されます。依存関係やコンポーネントなどの関係を変更する場合は relation_modes を設定します。add は追加、replace は全体置換、replace と空配列の組み合わせはクリアです。フィールド、関係、所属チーム名は、現在のワークスペースの実際の設定に準拠してください。
結果が確認待ちを示す場合は、元の request_id とパラメータを保持し、返された案内に従って確認してください。UUID を変更して作成や変更を繰り返さないでください。結果が監査状態の不確定を示す場合は、先に管理者に連絡して確認してください。
注意: ダッシュボードツール(
owl.dashboard.create/owl.dashboard.replace/owl.dashboard.get)は OWL CLI でのみ提供され、MCP ツール一覧には表示されません。関連する使用方法については OWL CLI ドキュメントを参照してください。
Data¶
v1.6.0 では 13 桁の整数ミリ秒タイムスタンプを統一的に検証し、終了時間が開始時間より大きいことを要求します。ペアで指定するパラメータは片方だけを渡せません。必須要件と最大スパンは各ツールの schema に準拠します。owl.data.query の時間範囲は最大 7 日間です。
v1.5.0 以降、owl.metric/rum/apm/network/profile/logging/billing.list および owl.infrastructure.list/get には 13 桁のミリ秒単位の start_time / end_time を必ず渡す必要があり、時間ウィンドウは 7 日間を超えてはなりません。owl.llm.list の時間範囲は任意です。両方を省略した場合は直近 24 時間を使用します。
owl.data.show_dql_namespace が返す dql_namespace はクエリの別名であり、バックエンドの元の型名ではありません。owl.data.query を呼び出すときは dql_namespace に渡し、simple query またはログパターンツールを呼び出すときは同じ値をそのまま namespace に渡します。
認可済みのクエリ対象ワークスペースは owl.workspace.data_authorized.list で検出でき、region_code、search、page_index、page_size をサポートします。サイトごとに独立してページネーションされます。workspace_uuid と region_code を owl.data.simple_query の workspace_uuids と target_region に渡すと、同一のターゲットサイト内にある複数の認可済みワークスペースをクエリできます。詳細はワークスペース横断クエリの説明を参照してください。
DQL namespace の調査、データソースとフィールドの検出、外部データソースの読み取り専用 SQL、ログインデックスの検出、SLO クエリ、ログパターン分析、同一組織内のワークスペース横断 Trace クエリ、および MCP クライアント向けの簡易データクエリに使用します。現在の MCP 側では簡易クエリとクエリ補助ツールを提供しており、完全な DQL または PromQL のカスタム実行ツールは含まれません。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.data.show_dql_namespace |
現在サポートされている DQL namespace を一覧表示し、index をサポートするかどうかを示す |
現在サポートされている DQL namespace を一覧表示 | なし | 読み取り専用 |
owl.data.simple_query |
簡易パラメータからクエリ文を自動組み立て | 簡易クエリ方式で直近 30 分間の CPU 使用率を集計 | namespace、start_time、end_time、source、select_clause、where_clause、group_by_clause、index、workspace_uuids、target_region, limit |
読み取り専用 |
owl.external_datasource.list |
現在のワークスペースでアクセス可能かつクエリ可能な外部データソースを検出 | 名前が orders の設定済み外部データソースを検索 | keyword、source_type、page_index、page_size |
読み取り専用 |
owl.external_datasource.query |
設定済み外部データソースに対して単一の制限付き読み取り専用 SQL を実行 | orders データソース内の直近 20 件の注文をクエリ | datasource_uuid、sql、timeout_seconds、max_rows |
読み取り専用 |
owl.data.same_org.trace.query |
trace_id で現在または同一組織のワークスペースにある Trace をクエリ |
複数の同一組織ワークスペースにまたがる Trace を 1 件クエリ | trace_id、workspace_uuids、start_time、end_time、where_clause、source、limit, cursor_time, cursor_token |
読み取り専用 |
owl.metric.list |
メトリクスクエリで利用可能な source またはフィールドを検出 |
メトリクス領域で利用可能な source を一覧表示 | mode、start_time、end_time |
読み取り専用 |
owl.rum.list |
RUM クエリで利用可能な source またはフィールドを検出 |
RUM 領域で利用可能なフィールドを一覧表示 | mode、start_time、end_time |
読み取り専用 |
owl.apm.list |
APM クエリで利用可能な source またはフィールドを検出 |
APM 領域で利用可能な source をクエリ | mode、start_time、end_time |
読み取り専用 |
owl.network.list |
Network クエリで利用可能な source またはフィールドを検出 |
Network 領域で利用可能なフィールドを一覧表示 | mode、start_time、end_time |
読み取り専用 |
owl.profile.list |
Profile クエリで利用可能な source またはフィールドを検出 |
Profile 領域で利用可能な source を表示 | mode、start_time、end_time |
読み取り専用 |
owl.logging.list |
ログクエリで利用可能な source またはフィールドを検出 |
ログ領域で利用可能な source を一覧表示 | mode、source、start_time、end_time |
読み取り専用 |
owl.logging.cluster_task.create |
ログパターン分析の非同期タスクを作成し、task_id を返す |
直近のエラーログを類似メッセージごとにパターン化 | timeRange、analysisField、namespace、conditions、query、indexes |
読み取り専用 |
owl.logging.cluster_task.get |
task_id でログパターン分析結果を取得 |
このログパターンタスクの結果をクエリ | task_id |
読み取り専用 |
owl.billing.list |
クラウド請求クエリで利用可能な source またはフィールドを検出 |
クラウド請求で利用可能な source を一覧表示 | mode、source、start_time、end_time |
読み取り専用 |
owl.slo.list |
現在のワークスペースの SLO 一覧をクエリし、名前またはモニター UUID で検索可能 | 現在のワークスペースの SLO を一覧表示 | search, page_size, page_index |
読み取り専用 |
owl.log_index.list |
ログクエリで利用可能なインデックスを一覧表示 | 現在のログインデックスを一覧表示 | なし | 読み取り専用 |
owl.log_index.get |
単一ログインデックスの詳細をクエリ | このログインデックス UUID の詳細をクエリ | index_uuid |
読み取り専用 |
owl.field_schema.get |
現在のフィールドカタログをクエリし、クエリフィールドの補完に使用 | 現在利用可能なフィールドカタログを一覧表示 | なし | 読み取り専用 |
owl.field_schema.search |
必要に応じてフィールド、メトリクス、measurement 設定を検索 | タイプ、単位のソース、ページネーション情報を返す | kind, search, namespace, measurement, page_index, page_size |
読み取り専用 |
owl.data.same_org.trace.queryのworkspace_uuidsを省略するか空配列を渡した場合、現在のワークスペースのみをクエリします。同一組織内のワークスペース横断クエリ機能が無効な場合は、現在のワークスペースのクエリのみが許可されます。他のワークスペース UUID を渡すとパラメータエラーが返されます。
Errors¶
エラーセンターの Issue 一覧クエリ、およびコメントの追加、クエリ、更新に使用します。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.errors.list |
エラーセンターの Issue 一覧をクエリ | 直近 24 時間のエラー Issue 一覧をクエリ | start_time、end_time、page_size、page_index、conditions、assigner、issue_status |
読み取り専用 |
owl.errors.comment.add |
エラー Issue にコメントを追加 | このエラー Issue に調査コメントを 1 件追加 | issue_id、comment、attachment_uuids、extend |
書き込み |
owl.errors.comment.list |
エラー Issue のコメント一覧をクエリ | このエラー Issue のコメント履歴を表示 | issue_id、page_size、page_index |
読み取り専用 |
owl.errors.comment.update |
既存のエラーコメントを更新 | このエラーコメントの内容を更新 | comment_uuid、comment、attachment_uuids、extend |
書き込み |
Event¶
イベントセンターの一覧クエリとイベント詳細取得に使用します。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.event.list |
イベント一覧をクエリ | 直近 1 時間の critical イベントをクエリ | start_time、end_time、status、limit, offset |
読み取り専用 |
owl.event.get |
単一イベントの詳細をクエリ。イベント時間範囲を限定可能 | このイベント doc_id の指定時間範囲内の詳細をクエリ |
doc_id、timeRange |
読み取り専用 |
owl.event.resolve |
イベントドキュメント ID、イベントまたはインシデント ID、リンクからイベント詳細を解決 | イベントドキュメント ID、イベントまたはインシデント ID、リンクからイベント詳細を解決 | doc_id、timeRange |
読み取り専用 |
owl.event.listではstart_timeとend_timeを必ず指定します。statusの選択可能な値はfatal、critical、error、warning、nodataで、limitのデフォルト値は 20、最大値は 100 です。返却項目にはイベントディメンションタグフィールドdf_dimension_tagsが含まれる場合があります。owl.event.getのtimeRangeは任意の 2 要素配列[start, end]で、各要素は 13 桁のミリ秒タイムスタンプであり、endはstartより大きい必要があります。パラメータ名はtimeRangeであり、time_rangeに書き換えないでください。
イベント ID とリンクの解決¶
owl.event.get の doc_id は空または空白のみにできません。owl.event.list が返す data.items[].doc_id の元の値を使用してください。イベント ID、インシデント ID、互換性のある不透明 ID、または HTTP(S) イベントリンクは owl.event.resolve に渡せます。リンクは識別子と時間の抽出にのみ使用され、アクセスされることはなく、ワークスペースや認証情報を切り替えることもありません。リンクの時間と明示的な timeRange は一致している必要があります。
ドキュメント ID と不透明 ID は、まず詳細の直接読み取りを試みます。空の結果が識別された場合にのみ検索を続行し、イベントまたはインシデント ID は直接、正確な識別子検索に進みます。検索で時間を省略した場合は直近 7 日間を使用し、明示的な検索範囲は最大 7 日間、候補は最大 20 件返します。直接の詳細読み取りは 7 日の上限を受けません。範囲が長すぎて詳細が空の場合は停止し、検索範囲を狭めることはありません。resolution_status、candidates、may_have_more を確認してください。multiple_matches は依然としてあいまいさがあることを示し、付随する最新候補の詳細を唯一の解決結果として扱うことはできません。
{
"tool_name": "owl.event.resolve",
"parameters": {
"doc_id": "event-example",
"timeRange": [1792548000000, 1792551600000]
}
}
Incident¶
owl.incident.get はインシデント UUID(incident_*)を受け取り、詳細と related_event_refs を返します。関連参照は 1 ページあたりのデフォルトおよび上限が 100 で、page_info.has_more と next_page_index に従って後続ページを読み取り、イベント参照に基づいて owl.event.get を呼び出します。インシデント UUID をイベントドキュメント ID として扱わないでください。参照の総数とインシデントで報告されたイベントの総数は異なる場合があるため、欠落した証拠を保持して説明する必要があります。
インシデント一覧と詳細、関連イベント参照、インシデントコメント、操作履歴、オンコールシフトのクエリに使用します。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.incident.list |
インシデント一覧をクエリ | 現在のすべてのインシデントをクエリ | search、page_size、page_index |
読み取り専用 |
owl.incident.get |
インシデント詳細とページネーションされた関連イベント参照をクエリ | インシデントのソース、発生時間、関連イベントを取得 | incident_uuid、page_size、page_index |
読み取り専用 |
owl.incident_comment.list |
インシデントコメント一覧をクエリ | このインシデントのコメント履歴を表示 | incident_uuid, page_index, page_size |
読み取り専用 |
owl.incident_comment.add |
インシデントにコメントを追加 | このインシデントに処理経過を 1 件追加 | incident_uuid、comment |
書き込み |
owl.incident_operation.list |
インシデント操作履歴をクエリ | このインシデントの操作履歴を表示 | incident_uuid、page_size、page_index |
読み取り専用 |
owl.incident_schedule.list |
オンコールシフト一覧をクエリ | 現在のオンコールシフト一覧をクエリ | search、page_size、page_index |
読み取り専用 |
owl.incident_schedule.get |
オンコールシフト詳細をクエリ | このオンコールシフトの詳細設定をクエリ | schedule_uuid |
読み取り専用 |
Infrastructure¶
インフラストラクチャオブジェクトの一覧と詳細クエリに使用し、ホスト、コンテナ、プロセスなどのリソースオブジェクトを対象とします。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.infrastructure.list |
インフラストラクチャオブジェクト一覧をクエリ | 現在のすべてのホストオブジェクトをクエリ | resource_type、limit、filters、start_time、end_time, cursor_time, cursor_token |
読み取り専用 |
owl.infrastructure.get |
単一インフラストラクチャオブジェクトの詳細をクエリ | このコンテナオブジェクトの詳細情報をクエリ | resource_type、identity_value、start_time、end_time, cursor_time, cursor_token |
読み取り専用 |
owl.infrastructure.list の limit はデフォルト 20、範囲は 1~100 です。各 filters には field、op、value を含める必要があり、op は =、!=、in のみをサポートします。in の値は空でない配列である必要があります。その他の演算子では、null でない文字列、数値、またはブール値を使用します。値は JSON として渡し、事前に DQL へ結合したりエスケープしたりしないでください。
LLM¶
LLM オブザーバビリティアプリケーション一覧のクエリに使用します。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.llm.list |
LLM アプリケーション一覧をクエリ | 現在のすべての LLM アプリケーションを一覧表示 | search、type、page_size、page_index、start_time、end_time, app_type |
読み取り専用 |
Workspace¶
ワークスペース横断データクエリの認可範囲検出、および現在のワークスペースのメンバーとチームのクエリに使用します。メンバーは名前・メールアドレスのキーワードで検索でき、チームは名前のキーワードで検索できます。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.workspace.data_authorized.list |
現在のワークスペースにデータクエリ権限を付与しているワークスペースを一覧表示 | ワークスペース横断クエリの前に、クエリ可能なワークスペースを確認 | region_code、search、page_index、page_size |
読み取り専用 |
owl.workspace.member.list |
ワークスペースメンバー一覧をクエリ | メールアドレスに alice を含むメンバーを検索 |
search, page_size, page_index |
読み取り専用 |
owl.workspace.member.group_list |
現在のワークスペースのチームをクエリし、チーム名、UUID、メンバー数を返す | エンティティの所属チームに設定できる Platform チームを検索 |
search |
読み取り専用 |
owl.member.list は明示的に呼び出すための互換エイリアスとして保持され、独立したツールとしては一覧表示されません。CLI はエイリアスをサポートするバージョンにアップグレードした後、owl sync を実行する必要があります。
owl.workspace.member.group_list で search を渡さない場合は、表示可能なすべてのチームをページネーションなしで返します。無料プランのワークスペースではこのツールをサポートしません。owl.member.group_list は互換エイリアスです。
Monitor¶
モニター一覧のクエリ、詳細取得、作成または更新、および外部イベント受信に使用します。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.monitor.list |
モニター一覧をクエリ | 現在有効なモニターをクエリ | search、status_list, page_size, page_index |
読み取り専用 |
owl.monitor.upsert |
モニターを作成または既存モニターを更新 | 外部イベントモニターを新規作成 | json_script、rule_uuid、status、secret、alert_policy_uuids、tags |
書き込み |
owl.monitor.receive |
既存の受信エンドポイントに外部イベントを送信、またはレシーバーを作成してからイベントを送信 | このモニターにテストイベントを 1 件送信 | event、target、monitor、extra_data |
書き込み |
owl.monitor.get |
モニター詳細をクエリ | このモニタールールの完全な設定をクエリ | rule_uuid |
読み取り専用 |
ノート¶
現在の API Key アカウントで表示可能なノートを管理するために使用します。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.nbook_note.list |
表示可能なノート概要をクエリし、Markdown 本文は返さない | タイトルまたは本文に指定内容を含むノートを検索、またはタイプ・タグでフィルタ | page_index、page_size、search、tags、tagkv_query、type |
読み取り専用 |
owl.nbook_note.get |
note_uuid でノート詳細と Markdown 本文を取得 |
このノートの完全な Markdown 本文を読み取る | note_uuid |
読み取り専用 |
owl.nbook_note.add |
ノートを作成し、ノート概要を返す | タグ付きの Markdown ノートを作成 | title、content、tags、tag_kv、type |
書き込み |
owl.nbook_note.modify |
note_uuid でノートを変更し、更新後の概要を返す |
このノートのタイトル、本文、タグを更新 | note_uuid、title、content、tags、tag_kv, expected_etag |
書き込み |
owl.nbook_note.delete |
note_uuid でノートを削除 |
このノートを削除 | note_uuid, expected_etag |
書き込み |
owl.nbook_note.listのpage_indexのデフォルト値は 1、page_sizeのデフォルト値は 20、最大値は 100 です。owl.nbook_note.getは Markdown 本文contentを返す唯一のノートツールですが、path、etag、versionは返しません。list、add、modifyは概要のみを返し、content、path、ETag、バージョン情報は返しません。deleteの応答はバックエンド本来の簡素な構造を維持します。typeはnormalとrunbookをサポートします。owl.nbook_note.listはtypeでフィルタでき、省略時はタイプでフィルタしません。owl.nbook_note.addはtypeを設定でき、省略時はバックエンドがnormalノートを作成します。getとmodifyの応答にはtypeが含まれますが、get、modify、deleteはいずれもtypeを入力パラメータとして受け付けず、既存ノートのタイプは変更できません。owl.nbook_note.addはtitleとcontentを必ず指定し、pathは受け付けません。created_sourceはサーバー側で固定してaiに設定され、作成アカウントは現在の API Key から取得されます。owl.nbook_note.modifyはnote_uuid以外に、title、content、tags、tag_kvのうち少なくとも 1 項目を指定する必要があります。contentを省略した場合は元の本文を保持します。- 取得、変更、削除には一覧で返された
note_uuidを使用します。path、etag、if_match、version、creator、created_sourceなど、バックエンドが管理するフィールドは渡さないでください。 tagkv_queryは一覧ツールで使用する TagKV 式の文字列です。tag_kvは作成・変更ツールで使用するキーと値のオブジェクトであり、両者を混在させないでください。
Pipeline¶
Pipeline 一覧のクエリとサンプル検証に使用します。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
owl.pipeline.list |
Pipeline 一覧をクエリし、デコード後の内容を返す | 名前に nginx を含む Pipeline を一覧表示 | search、scope、categories |
読み取り専用 |
owl.pipeline.validate |
サンプルデータで Pipeline の処理結果を検証 | このログサンプルで、この Pipeline が正しく解析できるか検証 | content、testData、dataType |
読み取り専用 |
mdsearch¶
統合ドキュメントコーパスの検索、ID または path による完全なドキュメントの読み取り、コーパスのディレクトリ構造の閲覧に使用し、中国語、英語、および混在クエリをサポートします。
| ツール名 | 機能 | 質問例 | 主要パラメータ | 権限 |
|---|---|---|---|---|
mdsearch_search |
統合ドキュメントコーパスを検索し、並べ替え済みの候補ドキュメントを返す | 「DQL 時間範囲」を含むドキュメントを検索 | q、top、path_prefix、tags、mode、sort |
読み取り専用 |
mdsearch_document |
id または path で完全なドキュメントを読み取る |
このドキュメント ID の完全な内容を読み取る | id、meta |
読み取り専用 |
mdsearch_catalog |
ドキュメントコーパスのトップレベルディレクトリと代表ドキュメントを閲覧 | ドキュメントコーパスにどのようなディレクトリがあるか確認 | なし | 読み取り専用 |
MCP 利用パス¶
以下の手順はデフォルトの facade モードを例にしています。サーバー側で static モードが有効な場合は、exec_tool を経由せずに同名のビジネスツールを直接呼び出せます。
データクエリ系の質問¶
「メトリクス、ログ、RUM、APM、Network、Profile データをクエリする」などの質問に適用されます。
exec_tool経由でowl.data.show_dql_namespaceを呼び出し、データ namespace を確認します。- データドメインに応じて、
exec_tool経由で検出系ツールを呼び出します。 - メトリクス:
owl.metric.list - RUM:
owl.rum.list - APM:
owl.apm.list - Network:
owl.network.list - Profile:
owl.profile.list - ログ:
owl.logging.list - クラウド請求:
owl.billing.list - ログインデックス:
owl.log_index.list - フィールドカタログ:
owl.field_schema.get - 必要な
source、field、indexを取得した後、exec_tool経由でowl.data.simple_queryを呼び出し、クエリを実行します。
外部データソースクエリ¶
- connector データソースの ID または名前しかない場合は、先に
owl.external_datasource.listを呼び出します。datasource_idの完全一致を優先し、一致しない場合は名前の完全一致を行い、一意のdatasource_uuidを特定します。0 件一致または複数一致の場合は推測しないでください。 - テーブルまたはフィールドが不明な場合は、データソースが返す機能で許可されている場合にのみ、制限付きの検出ステートメントを実行します。Func MySQL は現在
select/withのみを宣言しているため、フィールドと行数を限定したinformation_schema.tables/columnsクエリを使用し、宣言されていないSHOW/DESCRIBE/EXPLAINを試さないでください。 - 生の行をクエリする場合は、決定的な
ORDER BYと SQLLIMITを使用します。max_rowsは応答保護にすぎません。truncated=trueは結果が不完全であることを示します。 datasource_idは検出にのみ使用し、クエリでは一覧が返すdatasource_uuidを必ず送信します。DSN、パスワード、接続 URL、server ID、workspace 識別子を送信しないでください。
インシデント調査系の質問¶
「インシデントをクエリする」「インシデントの処理過程を追跡する」「インシデントコメントを追加する」などの質問に適用されます。
- インシデント UUID が既知の場合は、
exec_tool経由でowl.incident.getを呼び出します。対象が未確定の場合は、先にowl.incident.listを呼び出します。 - 返されたページネーション情報に従ってすべての関連イベント参照を読み取り、次に
owl.event.getを呼び出してイベント内容を取得します。 owl.incident_comment.listでコメントを表示し、owl.incident_operation.listで操作履歴を表示します。- 処理情報を追加する必要がある場合は、
exec_tool経由でowl.incident_comment.addを呼び出します。
リソースオブジェクト特定系の質問¶
「ホスト、コンテナ、プロセスなどのインフラストラクチャオブジェクトの詳細をクエリする」質問に適用されます。
exec_tool経由でowl.infrastructure.listを呼び出し、対象オブジェクトを検索します。- 返却結果の識別情報に基づき、
exec_tool経由でowl.infrastructure.getを呼び出してオブジェクト詳細を取得します。
ワークスペース横断 Trace クエリ系の質問¶
「trace_id で同一組織の複数ワークスペースにまたがる Trace を 1 件クエリする」質問に適用されます。
- 現在のワークスペースの Trace は直接クエリします。他の同一組織ワークスペースが必要で UUID が未確定の場合は、
exec_tool経由でowl.account.workspace.same_org.listを呼び出し、候補ワークスペースを検出します。 - 返却結果から
workspace_uuidを取得します(workspace_idは取得しないでください)。 exec_tool経由でowl.data.same_org.trace.queryを呼び出し、必須のtrace_idを渡し、選択したworkspace_uuidをworkspace_uuidsとして渡します。省略または空配列の場合は、現在のワークスペースのみをクエリします。- 追加のフィルタが必要な場合は、外側の中括弧を含まない
where_clauseを使用し、trace_id条件を重複して追加しないでください。ワークスペース横断 Trace クエリではowl.data.simple_queryにフォールバックしないでください。
ノート管理系の質問¶
「ノートを検索する、読み取る、作成する、変更する、または削除する」などの質問に適用されます。
exec_tool経由でowl.nbook_note.listを呼び出し、ノートを検索してnote_uuidを取得します。- Markdown 本文を読み取る必要がある場合は、
owl.nbook_note.getを呼び出します。 - ノートを作成する場合は
owl.nbook_note.addを呼び出し、更新する場合はowl.nbook_note.modifyを呼び出します。 - 削除する場合は
owl.nbook_note.deleteを呼び出します。add、modify、deleteは書き込みツールであるため、実行前にクライアント側で人手による確認を行う必要があります。
モニター管理系の質問¶
「モニターをクエリする、モニターを作成または更新する、外部イベントを送信する」などの質問に適用されます。
exec_tool経由でowl.monitor.listを呼び出し、モニターをクエリします。- 返却結果の
rule_uuidに基づき、exec_tool経由でowl.monitor.getを呼び出し、モニター詳細を表示します。 - モニターを作成または更新する必要がある場合は、
exec_tool経由でowl.monitor.upsertを呼び出します。 - 外部イベントを送信する必要がある場合は、
exec_tool経由でowl.monitor.receiveを呼び出します。