适用于 Azure MCP 服务器的 Azure Monitor 工具

Azure MCP 服务器允许使用自然语言提示管理 Azure Monitor 资源。 可以查询 Log Analytics 工作区、分析作数据、监视资源运行状况、检索性能指标和管理 Azure Monitor 工作簿,而无需了解复杂的 KQL 语法。

Azure Monitor 可帮助你最大程度地提高应用程序和服务的可用性和性能。 它提供了一个全面的解决方案,用于从云和本地环境收集、分析和处理遥测数据。

Note

Azure MCP 服务器工具为完成任务所需的数据定义参数。 其中一些参数特定于每个工具,如下所示。 其他参数是全局参数,由所有工具共享。 有关详细信息,请参阅 工具参数

Log Analytics:列出工作区

Azure MCP 服务器可以列出订阅中的所有 Log Analytics 工作区。 这概述了监视资源。

示例提示包括:

  • 列出工作区:“显示我的订阅中的所有 Log Analytics 工作区。
  • 查看工作区:“我拥有哪些工作区”
  • 查找工作区:“列出监视工作区”
  • 查询工作区:“显示工作区”
  • 检查工作区:“获取订阅 abc123 中的所有监视工作区”
Parameter 必需还是可选 Description
Subscription Required Azure 订阅 ID 或名称。

Log Analytics:列出表

Azure MCP 服务器可以列出 Log Analytics 工作区中的所有表。 这有助于了解可用于查询的数据。

示例提示包括:

  • 列出表:“显示 centralmonitoring 工作区中的表”
  • 查看表:“工作区应用监视中的哪些表?”
  • 查找表:“列出安全日志中的表”
  • 查询表:“显示工作区中的表”
  • 检查表:“请获取作工作区中的所有日志表”
Parameter 必需还是可选 Description
Subscription Required Azure 订阅 ID 或名称。
Workspace Required Log Analytics 工作区 ID 或名称。
Resource group Required Azure 资源组的名称。

Log Analytics:查询日志

Azure MCP 服务器可以针对 Log Analytics 工作区执行 Kusto 查询语言(KQL)查询。 借助此功能,可以分析作数据。

示例提示包括:

  • 简单查询:“过去一个小时的查询错误”
  • 筛选查询:“在 SecurityEvent 表中查找失败的登录尝试,
  • 复杂查询:“显示过去 24 小时内 Web 服务器的 CPU 使用率趋势”
  • 联接查询:“查询错误和性能指标”
  • 聚合查询:“按应用程序计算监视工作区中的错误”
Parameter 必需还是可选 Description
Subscription Required Azure 订阅 ID 或名称。
Workspace Required Log Analytics 工作区 ID 或名称。
Table name Required 要查询的表的名称。
Query Required 要针对 Log Analytics 工作区执行的 KQL 查询。
Hours Optional 从现在开始查询的小时数。
Limit Optional 要返回的最大结果数。

运行状况:获取实体运行状况

Azure MCP 服务器可以使用 Azure Monitor 运行状况模型获取实体的运行状况。 这为 Azure 资源和应用程序提供全面的运行状况信息和监视状态。

示例提示包括:

  • 检查实体运行状况:“使用 webapp-health 模型获取 app-prod-001 的运行状况”
  • 监视资源运行状况:“使用 application-model 的 Web-app-prod 运行状况是多少?
  • 检查系统状态:“获取 sql-prod 数据库实体的运行状况信息”
  • 监视服务运行状况:“显示 api-service 的运行状况状态”
  • 检查应用程序状态:“使用工作负荷运行状况模型获取生产工作负荷的运行状况数据”
Parameter 必需还是可选 Description
Subscription Required Azure 订阅 ID 或名称。
Resource group Required Azure 资源组的名称。
Model name Required 运行状况模型的名称。
Entity Required 要获取其运行状况的实体 ID。

指标:查询指标

Azure MCP 服务器可以查询 Azure Monitor 资源的指标。 这样,就可以在指定的时间段内检索 Azure 资源的性能指标、使用情况统计信息和监视数据。

示例提示包括:

  • 查询 VM 指标:“从 jan 1 到 jan 2 获取 prod-vm01 的 CPU 和内存”
  • 查询存储指标:“在存储组中显示 mystorageaccount 的事务指标”
  • 查询应用指标:“获取 mywebapp 过去 24 小时的响应时间”
  • 筛选查询:“仅显示 prod-vm 高使用率的 CPU 指标”
  • 查询性能:“从昨天每小时获取 vm-prod-001 的 CPU 和内存”
Parameter 必需还是可选 Description
Subscription Required Azure 订阅 ID 或名称。
Resource name Required 要查询其指标的资源的名称。
Metric namespace Required 指标命名空间。
Metric names Required 要查询的指标名称。
Resource group Optional Azure 资源组的名称。
Resource type Optional 资源类型。
Start time Optional 查询的开始时间。
End time Optional 查询的结束时间。
Interval Optional 聚合的间隔。
Aggregation Optional 聚合方法。
Filter Optional 筛选指标查询。
Max buckets Optional 最大存储桶数。

指标:列出指标定义

Azure MCP 服务器可以列出资源的可用指标定义。 这有助于在查询特定指标数据之前发现可用于监视的指标。

示例提示包括:

  • 列出存储指标:“显示 mystorageaccount 的指标”
  • 查找事务指标:“查找 storageacct 的事务指标”
  • 列出 VM 指标:“列出生产组中 prod-vm 的指标”
  • 按关键字搜索:“显示包含响应词的 mywebapp 指标,限制 50”
  • 列出数据库指标:“显示数据库组中 proddb 的指标”
Parameter 必需还是可选 Description
Subscription Required Azure 订阅 ID 或名称。
Resource name Required 资源的名称。
Resource group Optional Azure 资源组的名称。
Resource type Optional 资源类型。
Metric namespace Optional 指标命名空间。
Search string Optional 搜索字符串以筛选指标。
Limit Optional 要返回的最大结果数。

工作簿

List workbooks

Azure MCP 服务器可以列出资源组中的 Azure Monitor 工作簿。 这有助于发现和管理监视仪表板和交互式报表。

示例提示 包括:

  • 列出工作簿:“在监视组中显示工作簿”
  • 按类别列出:“在 Insights 类别中列出工作簿”
  • 列出共享工作簿:“在监视中显示共享工作簿”
  • 包含源的列表:“查找链接到 Application Insights 的工作簿”
  • 查询工作簿:“请列出监视工作簿”
Parameter 必需还是可选 Description
Subscription Required Azure 订阅 ID 或名称。
Resource group Required Azure 资源组的名称。
Category Optional 要筛选工作簿依据的类别。
Kind Optional 工作簿类型(例如“shared”、“user”)。
Source ID Optional 要按其筛选工作簿的源资源 ID。

显示工作簿详细信息

Azure MCP 服务器可以通过其资源 ID 显示特定 Azure Monitor 工作簿的详细信息。 这提供了有关工作簿配置和内容的综合信息。

示例提示 包括:

  • 显示工作簿:“显示 /subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/workbook-guid 的工作簿详细信息”
  • 获取工作簿信息:“获取有关工作簿 /subscriptions/xyz/resourceGroups/rg/providers/Microsoft.Insights/workbooks/my-workbook 的信息”
  • 查看工作簿:“显示工作簿详细信息”
  • 检查工作簿:“显示工作簿 /subscriptions/123/resourceGroups/prod/providers/Microsoft.Insights/workbooks/analytics 的配置”
  • 检索工作簿:“获取工作簿 /subscriptions/456/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/performance”
Parameter 必需还是可选 Description
Workbook ID Required 要检索的工作簿的完整 Azure 资源 ID。

Create workbook

Azure MCP 服务器可以创建新的 Azure Monitor 工作簿。 这样,就可以以编程方式创建监视仪表板和交互式报表。

示例提示 包括:

  • 创建工作簿:“在监视组中创建工作簿性能仪表板”
  • 使用源创建:“创建链接到 Application Insights 的工作簿 App Insights 分析”
  • 创建监视工作簿:“创建新工作簿基础结构概述”
  • 创建仪表板:“使用自定义 JSON 创建安全仪表板”
  • 创建分析工作簿:“在财务组中创建成本分析工作簿”
Parameter 必需还是可选 Description
Subscription Required Azure 订阅 ID 或名称。
Resource group Required Azure 资源组的名称。
Display name Required 新工作簿的显示名称。
Serialized content Required 定义工作簿结构和查询的 JSON 内容。
Source ID Optional 要与工作簿关联的源资源 ID。

Update workbook

Azure MCP 服务器可以更新现有的 Azure Monitor 工作簿。 这样,就可以以编程方式修改工作簿属性和内容。

示例提示 包括:

  • 更新名称:“将工作簿 /subscriptions/abc/resourceGroups/rg/providers/Microsoft.Insights/workbooks/wb1 名称更新为更新的仪表板”
  • 更新内容:“更新 /subscriptions/xyz/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/dashboard 的工作簿内容”
  • 修改工作簿:“更改工作簿 /subscriptions/123/resourceGroups/prod/providers/Microsoft.Insights/workbooks/analytics”
  • 更新仪表板:“使用新的性能指标更新工作簿”
  • 刷新工作簿:“更新工作簿 /subscriptions/789/resourceGroups/ops/providers/Microsoft.Insights/workbooks/operations 的内容”
Parameter 必需还是可选 Description
Workbook ID Required 要更新的工作簿的完整 Azure 资源 ID。
Display name Optional 工作簿的新显示名称。
Serialized content Optional 工作簿的更新 JSON 内容。

Delete workbook

Azure MCP 服务器可以删除 Azure Monitor 工作簿。 这会永久删除工作簿及其所有关联内容。

示例提示 包括:

  • 删除工作簿:“删除工作簿 /subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/old-dashboard”
  • 删除工作簿:“删除工作簿 /subscriptions/xyz/resourceGroups/rg/providers/Microsoft.Insights/workbooks/unused-workbook”
  • 清理:“删除 /subscriptions/123/resourceGroups/prod/providers/Microsoft.Insights/workbooks/deprecated”
  • 删除仪表板:“请删除监视工作簿”
  • 删除未使用的:“删除 /subscriptions/789/resourceGroups/test/providers/Microsoft.Insights/workbooks/test-dashboard”
Parameter 必需还是可选 Description
Workbook ID Required 要删除的工作簿的完整 Azure 资源 ID。