DII MCPツールリファレンス
DII MCPサーバーは現在、9つのドメインにわたる26種類の読み取り専用製品ツールを公開しています。接続されたクライアントが認証を必要とする場合、別の mcp_auth ヘルパーが表示されることがあります。
|
|
DII MCPは"プレビュー"機能であるため、変更される可能性があります。 |
ツールの利用可否および結果は、認証されたテナント、有効になっているDII機能、構成済みのコレクター、およびユーザー権限によって異なります。
クエリ規約
-
動的フィールドをクエリする前に、型とメタデータを確認してください。
-
メタデータから返される属性名とメトリック名は、大文字と小文字を区別して正確に使用してください。
-
必要に応じて、ISO-8601タイムスタンプとIANAタイムゾーン名を使用してください。
-
クエリの期間は30日以内にしてください。
-
オブジェクトとアラートのページネーションには、 `limit`と `offset`を使用します。
-
ログイベントのページネーションには、返されたカーソルを使用してください。
-
ウェブフックのエンドポイントアドレス全体を表示しないでください。
Acquisition Unit
取得ユニットの一覧
AcquisitionUnitsService_getAcquisitionUnits
接続状態、レポートの鮮度、オペレーティングシステム、バージョン、IPアドレス、および割り当てられたデータソース数を含む、すべての取得ユニットを返します。
例:
Acquisition Unitを一覧表示します。IPアドレスやUUIDを表示せずに、接続済み、障害発生、および未報告のユニットの概要を示します。
Acquisition Unitを取得する
AcquisitionUnitsService_getAcquisitionUnitByUuid
1つの取得ユニットに関する詳細情報を取得します。ユーザーが名前を指定した場合、まず取得ユニットを一覧表示してそのUUIDを解決します。
必須入力項目: uuid
アラート
アラートメタデータを取得する
AlertsService_getMetadata
有効なアラートフィールド名とデータ型を返します。アラートを照会する前にこれを呼び出してください。
クエリアラート
AlertsService_queryForAlerts
選択した属性、フィルタ、並べ替え、時間範囲、オフセットページネーションを使用して、アクティブまたは非アクティブなアラートを照会します。
必須入力項目:
-
active -
attributeNames -
fromTime -
toTime -
timezone
オプションの入力には、 filter、 sortField、 sortAscending、 limit、および `offset`が含まれます。 `limit`は1-500、 `offset`は0-1000です。期間は30日以内にしてください。
例:
過去7日間の重要なアクティブストレージアラートを取得します。アラートID、モニター名、重要度、ステータス、および関連するストレージ名を返します。
名前でアラートを取得する
AlertsService_getAlertByName
`AL-123456` 形式のアラート ID を使用して 1 つのアラートを取得します。
必須入力項目: name
UUIDでアラートを取得する
AlertsService_getAlertByUUID
UUIDを使用してアラートを1件取得します。
必須入力項目: uuid
データコレクター
データソースの一覧
CollectorService_getDataSources
設定済みのコレクターを、名前、ステータス、ベンダー、モデル、取得ユニット、バージョン、および最後に正常に取得できたデータとともに一覧表示します。必要に応じて、AU UUIDでフィルタリングできます。
例:
設定済みのデータソースをステータスとベンダーごとにグループ化します。失敗した取得と、成功したものの古くなった取得をハイライトします。
データソースを取得する
CollectorService_getDataSourceById
構成、収集パッケージの状態、ポーリング活動、検出されたデバイス、パッチ情報、および取得ユニットのコンテキストを含むコレクターを1つ取得します。
必須入力項目: id
このツールは、ポーリング間隔、設定済みメトリック、収集設定、または障害調査に使用します。
サポートされているデータソースの種類を一覧表示します
CollectorService_getDataSourceTypes
DIIコレクターカタログでサポートされている製品タイプの一覧です。これは、テナントに設定されているコレクターのリストではありません。
Logs
ログの種類を一覧表示します
LogService_getLogTypes
テナントで現在利用可能なログの種類を一覧表示します。
ログタイプのメタデータを取得する
LogService_getLogTypeMetadata
ログタイプに対して有効な属性を返します。イベントの検索やグループ化を行う前に呼び出してください。
必須入力項目: type
クエリログイベント
LogService_queryLogEvents
ログイベントをタイムスタンプの降順で返します。
必須入力項目:
-
type -
fromTime -
toTime -
timezone
オプションの入力には、 attributes、 filter、 limit、および `cursor`が含まれます。 `limit`は1~200です。イベント期間は30日を超えることはできません。前の応答のカーソルを渡して、次のページを取得します。
時間の経過に伴うログイベントのカウント
LogService_queryLogEventsCountHistogram
イベント数を固定サイズの時間バケットに分割して返します。オプションで、有効なグループ化可能な属性に基づいて各バケットをグループ化できます。グループ化された結果には、上位セグメントと __other__ セグメントが返されます。
必須入力項目:
-
type -
fromTime -
toTime -
timezone
オプション入力: filter、 groupBy
メンテナンス時間帯
メンテナンス期間の一覧
MaintenanceWindowService_getMaintenanceWindows
有効で期限切れでないアラート抑制ウィンドウを一覧表示します。期限切れのウィンドウを含めるには、 `includeExpired`を `true`に設定します。
正常な空の応答は、該当するメンテナンス期間が存在しないことを意味します。
メンテナンスウィンドウを取得する
MaintenanceWindowService_getMaintenanceWindowById
メンテナンスウィンドウを1つ取得します。
必須入力項目: id
モニター
モニター一覧
MonitorsService_queryMonitors
DIIモニターを一覧表示します。システムモニターのみを返す、システムモニターを除外する、またはすべてのモニターを返すには、 `isSystem`を使用します。
モニターを入手してください
MonitorsService_getMonitorById
モニター1台分の情報を取得し、その説明と、利用可能な場合は修正ガイダンスも取得します。
必須入力項目: id
通知
通知ルールの一覧
NotificationService_getNotificationRules
一致するアラートを通知先にルーティングするルールを一覧表示します。空の応答が成功したということは、一致するルールが存在しないことを意味します。
通知ルールを取得する
NotificationService_getNotificationRuleById
ルーティングルールを1つ取得します。
必須入力項目: id
ウェブフックのターゲット一覧
NotificationService_getWebhooks
Slack、Microsoft Teams、Discord、PagerDuty、およびカスタムHTTP統合のWebhookターゲットメタデータを一覧表示します。必要に応じて、カンマ区切りのエンジンタイプでフィルタリングできます。
セキュリティ要件:完全なエンドポイントアドレスには認証情報が含まれる可能性があります。アプリケーションとエージェントは、表示または転送される結果からアドレスフィールドを省略または編集する必要があります。
安全な例:
エンジンタイプ別にWebhookターゲットをカウントし、ターゲット名とステータスのみを一覧表示します。エンドポイントアドレスを返さないでください。
オブジェクトとメトリクス
オブジェクトタイプの一覧
ObjectService_getObjectTypes
テナント内で現在利用可能なオブジェクトの種類を一覧表示します。
オブジェクトのメタデータを取得する
ObjectService_getMetadataForObjectType
1つのオブジェクトタイプに対して有効な属性、メトリクス、タイプ、およびグループ化機能を返します。
必須入力項目: objectType
クエリオブジェクト
ObjectService_query
オブジェクト、選択した属性、およびオプションのメトリックを取得します。メトリックを参照するフィルタは、時間枠の集計前の生の値に適用されます。
必須入力項目:
-
objectType -
attributeNames
オプションの入力には、 metricNames、 filter、 sortFieldName、 isSortAscending、 fromTime、 toTime、 aggregateFunctions、 limit、および `offset`が含まれます。
サポートされているクエリ集計: MAX、 MIN、 AVG、 SUM、 LAST。 `limit`は1~500です。時間範囲を指定しない場合、ツールはデフォルトで直近3時間の範囲を使用します。
グループオブジェクト
ObjectService_groupObjects
オブジェクトを有効なグループ化可能な属性1つでグループ化し、選択されたメトリックを集計します。フィルターは集計前の生データに適用されます。
必須入力項目:
-
objectType -
groupByAttribute -
metricNames
オプションの入力には、 aggregateFunctions、 filter、ソート、時間制限、 limit、および `offset`が含まれます。
サポートされているグループ集計: MAX、 MIN、 AVG、 SUM、 FIRST、 CHANGE、CHANGE_RATIO。
クエリパフォーマンスの時系列データ
ObjectService_queryPerformanceMetricsForObjects
1つのメトリックと一致するオブジェクトについて、バケット化された時系列データを返します。
必須入力項目:
-
objectType -
metricName -
fromTime -
toTime -
timezone
オプションの入力には、 filter、 aggregationFunction、 limit、および `isSortAscending`が含まれます。 `limit`は返される系列の数を制御し、1~50の範囲で指定する必要があります。
サポートされているバケット集計: MAX、 MIN、 AVG、 SUM、 FIRST、 CHANGE、CHANGE_RATIO。
Kubernetesコレクター
Kubernetesコレクターの一覧を表示する
OperatorsManagement_getKubernetesCollectors
クラスタ名、全体的な最新ステータス、オペレータバージョン、Network Performance and Mapコンポーネントのバージョン、Change Analysisコンポーネントのバージョン、および最後に報告されたタイムスタンプを返します。
例:
古いKubernetesコレクターを特定し、どのコンポーネントに注意が必要かをまとめます。
フィルタ演算子
アラート、ログ、およびオブジェクトクエリは、ネストされた条件をサポートしています:
-
EQ,NE -
GT、LT、GE、LE -
WILDCARD`*`および `?`を使用して -
EXISTS -
ネストされた
and、or、およびnot
接続されたサーバーは、メタデータに対してフィールドの妥当性を検証します。クエリが拒否された場合は、関連するメタデータを更新し、フィルタを再構築します。