Azure MCP 服务器允许使用自然语言提示管理 Azure Monitor 资源。 可以查询 Log Analytics 工作区、分析作数据、监视资源运行状况、检索性能指标和管理 Azure Monitor 工作簿,而无需了解复杂的 KQL 语法。
Azure Monitor 可帮助你最大程度地提高应用程序和服务的可用性和性能。 它提供了一个全面的解决方案,用于从云和本地环境收集、分析和处理遥测数据。
注释
Azure MCP 服务器工具为完成任务所需的数据定义参数。 其中一些参数特定于每个工具,如下所示。 其他参数是全局参数,由所有工具共享。 有关详细信息,请参阅 工具参数。
活动日志:列出活动日志
列出指定 Azure 资源在给定的小时数内的活动日志。
示例提示包括:
- 最近的关键事件:“显示过去 4 小时内”Web-app-prod“资源的活动日志,仅显示”严重和错误“事件”
- 存储帐户活动:“从过去 24 小时内获取类型为”Microsoft.Storage/storageAccounts“的”mystorageaccount“资源的活动日志,限制为前 50 个条目”
- VM 监视:“列出过去 12 小时内”生产 vm01“虚拟机的所有活动日志”
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 资源名称 | 必选 | 要为其检索活动日志的 Azure 资源的名称。 |
| 资源类型 | 可选 | Azure 资源的类型(例如“Microsoft.Storage/storageAccounts”)。 仅当需要消除具有相同名称的多个资源之间时,才提供此功能。 |
| Hours | 可选 | 检索其活动日志之前的小时数。 |
| 事件级别 | 可选 | 要检索的活动日志级别。 有效级别为:严重、错误、信息、详细、警告。 如果未提供,则返回所有级别。 |
| 顶部 | 可选 | 要检索的活动日志的最大数目。 |
Web 测试:创建 Web 测试
在 Azure Monitor 中创建新的标准 Web 测试。 Ping/Multistep Web 测试已弃用,不支持。
示例提示包括:
- 基本 Web 测试:“为美国东部位置的 Application Insights '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/components/myapp-insights' 创建 Web 测试'api-health-check',从位置'us-east-2-azr,us-west-2-azr'”测试 URL'https://api.mycompany.com/health”
- 自定义频率测试:“为西欧的 Application Insights '/subscriptions/xyz789/resourceGroups/prod/providers/Microsoft.Insights/components/web-insights' 创建 Web 测试'主页-monitor',从'eu-west-1-azr,eu-north-1-azr'位置测试'https://www.mysite.com',频率为 300 秒,超时 60 秒”
- POST 请求测试:“为美国中部的 Application Insights '/subscriptions/def456/resourceGroups/test/providers/Microsoft.Insights/components/test-insights' 创建 Web 测试'login-endpoint',使用 HTTP 谓词'post'、请求正文'{”username“:”test“}”和标头“Content-Type=application/json”测试https://api.myapp.com/login''
- SSL 监视测试:“为澳大利亚东部的 Application Insights '/subscriptions/ghi789/resourceGroups/security/providers/Microsoft.Insights/components/security-insights' 创建 Web 测试'secure-api-check',测试https://secure.myservice.com/api”au-east-azr,au-southeast-azr“,并启用 SSL 检查,SSL 生存期检查 30 天,预期状态代码 200”
- 综合测试:“为北欧的 Application Insights '/subscriptions/jkl012/resourceGroups/ecommerce/providers/Microsoft.Insights/components/shop-insights' 创建 Web 测试 'ecommerce-checkout', 通过”eu-north-1-azr,eu-west-1-azr,eu-central-1-azr“测试https://shop.mystore.com/checkout”,说明“监视签出过程”,频率 900 秒,跟踪已启用重定向,分析已启用请求,重试已启用,超时 120 秒”
| 参数 | 必需还是可选 | Description |
|---|---|---|
| Webtest 资源 | 必选 | 要作的 Web 测试资源的名称。 |
| Appinsights 组件 | 必选 | 要与 Web 测试关联的 Application Insights 组件的资源 ID。 |
| 位置 | 必选 | 创建 Web 测试资源的位置。 这应与 AppInsights 组件位置相同。 |
| Webtest 位置 | 必选 | 要从(逗号分隔值)运行测试的位置列表。 位置是指特定于可用性测试的地理位置填充标记。 |
| 请求 URL | 必选 | 要测试的绝对 URL。 |
| Webtest | 可选 | Web 测试资源中测试的名称。 |
| 说明 | 可选 | Web 测试的说明。 |
| 已启用 | 可选 | 是否启用 Web 测试。 |
| 预期状态代码 | 可选 | 预期的 HTTP 状态代码。 |
| 遵循重定向 | 可选 | 是否遵循重定向。 |
| 频率 | 可选 | 测试频率(以秒为单位)。 支持的值300,600900秒。 |
| Headers | 可选 | 要包含在请求中的 HTTP 标头。 逗号分隔的 KEY=VALUE。 |
| HTTP 谓词 | 可选 | HTTP 方法 (示例为: get, post)。 |
| 忽略状态代码 | 可选 | 是否忽略状态代码验证。 |
| 分析请求 | 可选 | 是否分析依赖请求。 |
| 请求正文 | 可选 | 请求的正文。 |
| 已启用重试 | 可选 | 是否启用重试。 |
| SSL 检查 | 可选 | 是否检查 SSL 证书。 |
| SSL 生存期检查 | 可选 | 检查 SSL 证书生存期的天数。 |
| 超时 | 可选 | 请求超时(最多 2 分钟)。 支持的值:30、、60、90120秒。 |
Web 测试:获取 Web 测试
根据 Webtest 资源名称获取提供的资源组中特定 Web 测试的详细信息。
示例提示包括:
- 获取测试详细信息:“获取 Web 测试'api-health-check'的详细信息”
- 查看测试配置:“显示 Web 测试”主页-monitor“的配置
- 检查测试状态:“获取有关 Web 测试'login-endpoint'的信息”
| 参数 | 必需还是可选 | Description |
|---|---|---|
| Webtest 资源 | 必选 | 要作的 Web 测试资源的名称。 |
Web 测试:列出 Web 测试
列出指定订阅中的所有 Web 测试,还可以选择列出资源组。
示例提示包括:
- 列出所有测试:“列出订阅中的所有 Web 测试”
- 按资源组查看测试:“在”监视“资源组中显示 Web 测试”
- 获取测试清单:“我配置了哪些 Web 测试?”
Web 测试:更新 Web 测试
更新 Azure Monitor 中的现有标准 Web 测试。 Ping/Multistep Web 测试已弃用,不支持。
示例提示包括:
- 更新测试频率:“更新 Web 测试”api-health-check“以每 300 秒运行一次”
- 更改测试 URL:“更新 Web 测试”主页-monitor“以测试 URL”https://www.newsite.com,超时 90 秒”
- 修改测试配置:“使用新的标头”Authorization=Bearer token123“和预期状态代码 201 更新 Web 测试”login-endpoint”
| 参数 | 必需还是可选 | Description |
|---|---|---|
| Webtest 资源 | 必选 | 要作的 Web 测试资源的名称。 |
| Appinsights 组件 | 可选 | 要与 Web 测试关联的 Application Insights 组件的资源 ID。 |
| 位置 | 可选 | 创建 Web 测试资源的位置。 这应与 AppInsights 组件位置相同。 |
| Webtest 位置 | 可选 | 要从(逗号分隔值)运行测试的位置列表。 位置是指特定于可用性测试的地理位置填充标记。 |
| 请求 URL | 可选 | 要测试的绝对 URL。 |
| Webtest | 可选 | Web 测试资源中测试的名称。 |
| 说明 | 可选 | Web 测试的说明。 |
| 已启用 | 可选 | 是否启用 Web 测试。 |
| 预期状态代码 | 可选 | 预期的 HTTP 状态代码。 |
| 遵循重定向 | 可选 | 是否遵循重定向。 |
| 频率 | 可选 | 测试频率(以秒为单位)。 支持的值 300、600、900 秒。 |
| Headers | 可选 | 要包含在请求中的 HTTP 标头。 逗号分隔的 KEY=VALUE。 |
| HTTP 谓词 | 可选 | HTTP 方法(get、post 等)。 |
| 忽略状态代码 | 可选 | 是否忽略状态代码验证。 |
| 分析请求 | 可选 | 是否分析依赖请求。 |
| 请求正文 | 可选 | 请求的正文。 |
| 已启用重试 | 可选 | 是否启用重试。 |
| SSL 检查 | 可选 | 是否检查 SSL 证书。 |
| SSL 生存期检查 | 可选 | 检查 SSL 证书生存期的天数。 |
| 超时 | 可选 | 请求超时(最多 2 分钟)。 支持的值:30、60、90、120 秒。 |
Log Analytics:列出工作区
Azure MCP 服务器列出了订阅中的所有 Log Analytics 工作区。 这概述了监视资源。
示例提示包括:
- 列出工作区:“显示我的订阅中的所有 Log Analytics 工作区。
- 查看工作区:“我拥有哪些工作区?”
- 查找工作区:“列出监视工作区”。
Log Analytics:列出表类型
列出 Log Analytics 工作区中的可用表类型。
示例提示包括:
- 列出表类型:“在中央监视工作区中显示表类型。
- 查看可用类型:“我的 Log Analytics 工作区中提供了哪些表类型?”
- 查找表类别:“列出安全日志工作区的表类型”。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| Workspace | 必选 | Log Analytics 工作区 ID 或名称。 这可以是唯一标识符(GUID)或工作区的显示名称。 |
Log Analytics:列出表
Azure MCP 服务器列出 Log Analytics 工作区中的所有表。 这有助于了解可用于查询的数据。
示例提示包括:
- 列出表:“在 centralmonitoring 工作区中显示表”。
- 查看表:“工作区应用监视中有哪些表?”
- 查找表:“列出安全日志工作区中的表”。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| Workspace | 必选 | Log Analytics 工作区 ID 或名称。 |
Log Analytics:查询工作区日志
Azure MCP 服务器可以针对 Log Analytics 工作区执行 Kusto 查询语言(KQL)查询。 借助此功能,可以分析作数据。
示例提示包括:
- 简单查询:“查询过去一个小时的错误。
- 筛选查询:“在 SecurityEvent 表中查找失败的登录尝试。
- 复杂查询:“显示过去 24 小时内 Web 服务器的 CPU 使用率趋势。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| Workspace | 必选 | Log Analytics 工作区 ID 或名称。 |
| 表 | 必选 | 要查询的表的名称。 |
| 查询 | 必选 | 要针对 Log Analytics 工作区执行的 KQL 查询。 |
| Hours | 可选 | 从现在开始查询的小时数。 |
| Limit | 可选 | 要返回的最大结果数。 |
Log Analytics:查询资源日志
使用 Kusto 查询语言(KQL)查询 Log Analytics 工作区中特定 Azure 资源的诊断和活动日志。
示例提示包括:
- 查询最近的日志:“显示资源 /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Web/sites/myapp 的最新日志。
- 查找错误:“过去 4 小时内我的 Web 应用资源的查询错误。
- 资源诊断:“显示限制为 100 的存储帐户资源的诊断日志。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 资源标识符 | 必选 | 用于查询日志的 Azure 资源 ID。 示例:/subscriptions/<YOUR-SUBSCRIPTION-ID>/resourceGroups/<YOUR-RESOURCE-GROUP>/providers/Microsoft.OperationalInsights/workspaces/<YOUR-WORKSPACE>。 |
| 表 | 必选 | 要查询的表的名称。 这是工作区中的特定表。 |
| 查询 | 必选 | 要针对 Log Analytics 工作区执行的 KQL 查询。 可以按名称使用预定义查询,例如 recent 显示由 TimeGenerated 排序的最新日志,以及 errors 按 TimeGenerated 排序的错误级别日志。 否则,请提供自定义 KQL 查询。 |
| Hours | 可选 | 从现在开始查询的小时数。 |
| Limit | 可选 | 要返回的最大结果数。 |
运行状况:获取实体运行状况
Azure MCP 服务器使用 Azure Monitor 运行状况模型获取实体的运行状况。 这为 Azure 资源和应用程序提供全面的运行状况信息和监视状态。
示例提示包括:
- 检查实体运行状况:“使用 webapp-health 模型获取 app-prod-001 的运行状况。
- 监视资源运行状况:“使用 application-model 的 Web-app-prod 运行状况是多少?
- 检查系统状态:“获取 sql-prod 数据库实体的运行状况信息。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 型号 | 必选 | 运行状况模型的名称。 |
| 实体 | 必选 | 要获取其运行状况的实体 ID。 |
指标:查询指标
Azure MCP 服务器查询 Azure Monitor 资源指标。 这样,就可以在指定的时间段内检索 Azure 资源的性能指标、使用情况统计信息和监视数据。
示例提示包括:
- 查询 VM 指标:“从 1 月 1 日到 1 月 2 日获取 prod-vm01 的 CPU 和内存。
- 查询存储指标:“在存储组中显示 mystorageaccount 的事务指标。
- 查询应用指标:“获取 mywebapp 过去 24 小时的响应时间。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 资源 | 必选 | 要查询其指标的资源的名称。 |
| 指标命名空间 | 必选 | 指标命名空间。 |
| Metrics | 必选 | 要查询的指标名称。 |
| 资源类型 | 可选 | 资源类型。 |
| 开始时间 | 可选 | 查询的开始时间。 |
| 结束时间 | 可选 | 查询的结束时间。 |
| Interval | 可选 | 聚合的间隔。 |
| 合并 | 可选 | 聚合方法。 |
| 滤波器 | 可选 | 筛选指标查询。 |
| 最大存储桶数 | 可选 | 最大存储桶数。 |
指标:列出指标定义
Azure MCP 服务器列出了资源的可用指标定义。 这有助于在查询特定指标数据之前发现可用于监视的指标。
示例提示包括:
- 列出存储指标:“显示 mystorageaccount 的指标。
- 查找事务指标:“查找 storageacct 的事务指标”。
- 列出 VM 指标:“列出生产组中 prod-vm 的指标。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 资源名称 | 必选 | 资源的名称。 |
| 资源类型 | 可选 | 资源类型。 |
| 指标命名空间 | 可选 | 指标命名空间。 |
| 搜索字符串 | 可选 | 搜索字符串以筛选指标。 |
| Limit | 可选 | 要返回的最大结果数。 |
工作簿:列出工作簿
Azure MCP 服务器列出了资源组中的 Azure Monitor 工作簿。 这有助于发现和管理监视仪表板和交互式报表。
示例提示包括:
- 列出工作簿:“在监视组中显示工作簿”。
- 按类别列出:“在 Insights 类别中列出工作簿”。
- 列出共享工作簿:“在监视中显示共享工作簿”。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 资源组 | 必选 | Azure 资源组的名称。 |
| 类别 | 可选 | 要筛选工作簿依据的类别。 |
| Kind | 可选 | 工作簿类型(例如 shared, user)。 |
| 源 ID | 可选 | 要按其筛选工作簿的源资源 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 的信息。
- 查看工作簿:“显示我的性能工作簿的工作簿详细信息”。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 工作簿 ID | 必选 | 要检索的工作簿的完整 Azure 资源 ID。 |
工作簿:创建工作簿
Azure MCP 服务器可以创建新的 Azure Monitor 工作簿。 这样,就可以以编程方式创建监视仪表板和交互式报表。
示例提示包括:
- 创建工作簿:“在监视组中创建工作簿性能仪表板”。
- 使用源创建:“创建链接到 Application Insights 的工作簿 App Insights 分析”。
- 创建监视工作簿:“创建新的工作簿基础结构概述”。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 显示 | 必选 | 新工作簿的显示名称。 |
| 序列化的内容 | 必选 | 定义工作簿结构和查询的 JSON 内容。 |
| 源 ID | 可选 | 要与工作簿关联的源资源 ID。 |
工作簿:更新工作簿
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 的名称和内容。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 工作簿 ID | 必选 | 要更新的工作簿的完整 Azure 资源 ID。 |
| 显示 | 可选 | 工作簿的新显示名称。 |
| 序列化的内容 | 可选 | 工作簿的更新 JSON 内容。 |
工作簿:删除工作簿
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 的工作簿。
| 参数 | 必需还是可选 | Description |
|---|---|---|
| 工作簿 ID | 必选 | 要删除的工作簿的完整 Azure 资源 ID。 |