DII MCP 工具参考
DII MCP 服务器目前在九个域中公开了 26 个只读产品工具。当连接的客户端需要进行身份验证时,可能会出现单独的 mcp_auth 帮助程序。
|
|
DII MCP 是一项 "预览" 功能,因此可能会发生变化。 |
工具可用性和结果取决于经过身份验证的租户、启用的 DII 功能、配置的收集器和用户权限。
查询约定
-
在查询动态字段之前发现类型和元数据。
-
使用元数据返回的精确、区分大小写的属性和指标名称。
-
必要时使用 ISO-8601 时间戳和 IANA 时区名称。
-
将查询窗口保持为 30 天或更短。
-
将 `limit`和 `offset`用于对象和警报分页。
-
使用返回的游标进行日志事件分页。
-
不显示完整的 Webhook 端点地址。
采集单元
列出采集单元
AcquisitionUnitsService_getAcquisitionUnits
返回所有具有连接状态、报告新鲜度、操作系统、版本、IP 地址和分配的数据源计数的采集单元。
示例:
列出采集单元。在不显示 IP 地址或 UUID 的情况下汇总已连接、失败和从未报告的单元。
获取采集单元
AcquisitionUnitsService_getAcquisitionUnitByUuid
检索一个采集单元的完整详细信息。如果用户提供了名称,请先列出采集单元以解析其 UUID。
需要输入: uuid
警报
获取警报元数据
AlertsService_getMetadata
返回有效的警报字段名称和数据类型。在查询警报之前调用此选项。
查询警报
AlertsService_queryForAlerts
使用所选属性、筛选器、排序、时间限制和偏移分页查询活动或非活动警报。
必需输入:
-
active -
attributeNames -
fromTime -
toTime -
timezone
可选输入包括 filter、 sortField、 sortAscending、 limit`和 `offset。 `limit`为1-500; `offset`为0-1000。请将时间窗口保持在30天以内。
示例:
检索过去七天的关键活动存储警报。返回警报 ID、监视器名称、严重性、状态和相关存储名称。
按名称获取警报
AlertsService_getAlertByName
使用采用 `AL-123456`格式的警报 ID 检索一个警报。
需要输入: name
按 UUID 获取提醒
AlertsService_getAlertByUUID
使用其 UUID 检索一个警报。
需要输入: uuid
数据收集器
列出数据源
CollectorService_getDataSources
列出已配置的收集器,包括名称、状态、供应商、型号、采集单元、版本和最后一次成功采集。可以选择按 AU UUID 过滤。
示例:
按状态和供应商对已配置的数据源进行分组。突出显示失败和过时的成功采集。
获取数据源
CollectorService_getDataSourceById
检索一个具有配置、收集包状态、轮询活动、发现的设备、修补程序信息和采集单元上下文的收集器。
需要输入: id
将此工具用于轮询间隔、配置的指标、收集设置或故障调查。
列出支持的数据源类型
CollectorService_getDataSourceTypes
列出 DII 收集器目录支持的产品类型。这不是在租户中配置的收集器列表。
日志
列出日志类型
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
检索一个维护窗口。
需要输入: id
监视器
列出监视器
MonitorsService_queryMonitors
列出 DII 监视器。使用 `isSystem`仅返回系统监视器、排除系统监视器或返回所有监视器。
获取监控器
MonitorsService_getMonitorById
检索一个监控器,包括其说明和纠正指导(如果可用)。
需要输入: id
通知
列出通知规则
NotificationService_getNotificationRules
列出将匹配警报路由到通知目标的规则。成功的空响应意味着不存在匹配的规则。
获取通知规则
NotificationService_getNotificationRuleById
检索一个路由规则。
需要输入: id
列出 Webhook 目标
NotificationService_getWebhooks
列出 Slack、Microsoft Teams、Discord、PagerDuty 和自定义 HTTP 集成的 Webhook 目标元数据。可选择按逗号分隔的引擎类型进行筛选。
安全要求:完整的端点地址可能包含凭据。应用程序和代理必须从显示或转发的结果中省略或隐去地址字段。
安全示例:
按引擎类型统计 Webhook 目标数量,并仅列出目标名称和状态。不返回端点地址。
对象和指标
列出对象类型
ObjectService_getObjectTypes
列出租户中当前可用的对象类型。
获取对象元数据
ObjectService_getMetadataForObjectType
返回一个对象类型的有效属性、指标、类型和分组功能。
需要输入: objectType
查询对象
ObjectService_query
检索对象、所选属性和可选指标。引用指标的筛选器在时间窗口聚合之前应用于原始值。
必需输入:
-
objectType -
attributeNames
可选输入包括 metricNames、 filter、 sortFieldName、 isSortAscending、 fromTime、 toTime、 aggregateFunctions、 limit`和 `offset。
支持的查询聚合: MAX、 MIN、 AVG、 SUM、 LAST。 limit 为 1-500。如果省略时间限制,工具将默认为最近的三小时窗口。
组对象
ObjectService_groupObjects
按一个有效的可分组属性对对象进行分组,并聚合所选指标。过滤器适用于聚合前的原始值。
必需输入:
-
objectType -
groupByAttribute -
metricNames
可选输入包括 aggregateFunctions、 filter、排序、时间限制、 limit`和 `offset。
支持的组聚合: MAX、 MIN、 AVG、 SUM、 FIRST、 CHANGE、CHANGE_RATIO。
查询性能时间序列
ObjectService_queryPerformanceMetricsForObjects
返回一个指标和匹配对象的分桶时间序列数据。
必需输入:
-
objectType -
metricName -
fromTime -
toTime -
timezone
可选输入包括 filter、 aggregationFunction、 limit`和 `isSortAscending。 `limit`控制返回序列的数量,必须为 1-50。
支持的存储桶聚合: MAX、 MIN、 AVG、 SUM、 FIRST、 CHANGE、CHANGE_RATIO。
Kubernetes 收集器
列出 Kubernetes 收集器
OperatorsManagement_getKubernetesCollectors
返回集群名称、总体时效状态、Operator 版本、网络性能和映射组件版本、变更分析组件版本以及最后报告的时间戳。
示例:
识别过时的 Kubernetes 收集器,并总结需要注意的组件。
筛选运算符
警报、日志和对象查询支持嵌套条件:
-
EQ,NE -
GT,LT,GE,LE -
WILDCARD使用*`和 `? -
EXISTS -
嵌套
and、or`和 `not
连接的服务器根据元数据验证字段。如果查询被拒绝,请刷新相关元数据并重构筛选器。