コンテンツにスキップ

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 クライアントは次の順序で呼び出します。

  1. list_catalogs を呼び出して利用可能な分類を確認します。
  2. list_tools を呼び出し、catalog_id を渡して、その分類下のビジネスツールとパラメータを確認します。
  3. 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 データをクエリする」などの質問に適用されます。

  1. exec_tool 経由で owl.data.show_dql_namespace を呼び出し、データ namespace を確認します。
  2. データドメインに応じて、exec_tool 経由で検出系ツールを呼び出します。
  3. メトリクス: owl.metric.list
  4. RUM: owl.rum.list
  5. APM: owl.apm.list
  6. Network: owl.network.list
  7. Profile: owl.profile.list
  8. ログ: owl.logging.list
  9. クラウド請求: owl.billing.list
  10. ログインデックス: owl.log_index.list
  11. フィールドカタログ: owl.field_schema.get
  12. 必要な source、field、index を取得した後、exec_tool 経由で owl.data.simple_query を呼び出し、クエリを実行します。

外部データソースクエリ

  1. connector データソースの ID または名前しかない場合は、先に owl.external_datasource.list を呼び出します。datasource_id の完全一致を優先し、一致しない場合は名前の完全一致を行い、一意の datasource_uuid を特定します。0 件一致または複数一致の場合は推測しないでください。
  2. テーブルまたはフィールドが不明な場合は、データソースが返す機能で許可されている場合にのみ、制限付きの検出ステートメントを実行します。Func MySQL は現在 select/with のみを宣言しているため、フィールドと行数を限定した information_schema.tables/columns クエリを使用し、宣言されていない SHOW/DESCRIBE/EXPLAIN を試さないでください。
  3. 生の行をクエリする場合は、決定的な ORDER BY と SQL LIMIT を使用します。max_rows は応答保護にすぎません。truncated=true は結果が不完全であることを示します。
  4. datasource_id は検出にのみ使用し、クエリでは一覧が返す datasource_uuid を必ず送信します。DSN、パスワード、接続 URL、server ID、workspace 識別子を送信しないでください。

インシデント調査系の質問

「インシデントをクエリする」「インシデントの処理過程を追跡する」「インシデントコメントを追加する」などの質問に適用されます。

  1. インシデント UUID が既知の場合は、exec_tool 経由で owl.incident.get を呼び出します。対象が未確定の場合は、先に owl.incident.list を呼び出します。
  2. 返されたページネーション情報に従ってすべての関連イベント参照を読み取り、次に owl.event.get を呼び出してイベント内容を取得します。
  3. owl.incident_comment.list でコメントを表示し、owl.incident_operation.list で操作履歴を表示します。
  4. 処理情報を追加する必要がある場合は、exec_tool 経由で owl.incident_comment.add を呼び出します。

リソースオブジェクト特定系の質問

「ホスト、コンテナ、プロセスなどのインフラストラクチャオブジェクトの詳細をクエリする」質問に適用されます。

  1. exec_tool 経由で owl.infrastructure.list を呼び出し、対象オブジェクトを検索します。
  2. 返却結果の識別情報に基づき、exec_tool 経由で owl.infrastructure.get を呼び出してオブジェクト詳細を取得します。

ワークスペース横断 Trace クエリ系の質問

「trace_id で同一組織の複数ワークスペースにまたがる Trace を 1 件クエリする」質問に適用されます。

  1. 現在のワークスペースの Trace は直接クエリします。他の同一組織ワークスペースが必要で UUID が未確定の場合は、exec_tool 経由で owl.account.workspace.same_org.list を呼び出し、候補ワークスペースを検出します。
  2. 返却結果から workspace_uuid を取得します(workspace_id は取得しないでください)。
  3. exec_tool 経由で owl.data.same_org.trace.query を呼び出し、必須の trace_id を渡し、選択した workspace_uuid を workspace_uuids として渡します。省略または空配列の場合は、現在のワークスペースのみをクエリします。
  4. 追加のフィルタが必要な場合は、外側の中括弧を含まない where_clause を使用し、trace_id 条件を重複して追加しないでください。ワークスペース横断 Trace クエリでは owl.data.simple_query にフォールバックしないでください。

ノート管理系の質問

「ノートを検索する、読み取る、作成する、変更する、または削除する」などの質問に適用されます。

  1. exec_tool 経由で owl.nbook_note.list を呼び出し、ノートを検索して note_uuid を取得します。
  2. Markdown 本文を読み取る必要がある場合は、owl.nbook_note.get を呼び出します。
  3. ノートを作成する場合は owl.nbook_note.add を呼び出し、更新する場合は owl.nbook_note.modify を呼び出します。
  4. 削除する場合は owl.nbook_note.delete を呼び出します。add、modify、delete は書き込みツールであるため、実行前にクライアント側で人手による確認を行う必要があります。

モニター管理系の質問

「モニターをクエリする、モニターを作成または更新する、外部イベントを送信する」などの質問に適用されます。

  1. exec_tool 経由で owl.monitor.list を呼び出し、モニターをクエリします。
  2. 返却結果の rule_uuid に基づき、exec_tool 経由で owl.monitor.get を呼び出し、モニター詳細を表示します。
  3. モニターを作成または更新する必要がある場合は、exec_tool 経由で owl.monitor.upsert を呼び出します。
  4. 外部イベントを送信する必要がある場合は、exec_tool 経由で owl.monitor.receive を呼び出します。

フィードバック

このページは役に立ちましたか?