Azure Monitor CLI 示例Azure Monitor CLI samples

本文演示有助于访问 Azure 监视器功能的示例命令行接口 (CLI) 命令。This article shows you sample command-line interface (CLI) commands to help you access Azure Monitor features. Azure Monitor 允许基于配置的遥测数据值自动缩放云服务、虚拟机和 Web 应用,以及发送警报通知或调用 Web URL。Azure Monitor allows you to AutoScale Cloud Services, Virtual Machines, and Web Apps and to send alert notifications or call web URLs based on values of configured telemetry data.

先决条件Prerequisites

如果尚未安装 Azure CLI,请按照安装 Azure CLI 的说明进行操作。If you haven't already installed the Azure CLI, follow the instructions for Install the Azure CLI. 请参阅 Azure Monitor CLI 参考中的所有可用命令的完整参考。See a full reference of all available commands in the Azure Monitor CLI reference.

登录 AzureLog in to Azure

第一步是登录 Azure 帐户。The first step is to log in to your Azure account.

az login

运行此命令后,必须按照屏幕上的说明进行登录。After running this command, you have to sign in via the instructions on the screen. 所有命令都在默认订阅的上下文中工作。All commands work in the context of your default subscription.

列出当前订阅的详细信息。List the details of your current subscription.

az account show

将工作上下文更改为其他订阅。Change working context to a different subscription.

az account set -s <Subscription ID or name>

查看所有受支持的 Azure Monitor 命令的列表。View a list of all supported Azure Monitor commands.

az monitor -h

查看活动日志View activity log

查看活动日志事件的列表。View a list of activity log events.

az monitor activity-log list

查看所有可用选项。View all available options.

az monitor activity-log list -h

按 resourceGroup 列出日志。List logs by a resourceGroup.

az monitor activity-log list --resource-group <group name>

按调用方列出日志。List logs by caller.

az monitor activity-log list --caller myname@company.com

在日期范围内,按调用方列出资源类型的日志。List logs by caller on a resource type, within a date range.

az monitor activity-log list --resource-provider Microsoft.Web \
    --caller myname@company.com \
    --start-time 2016-03-08T00:00:00Z \
    --end-time 2016-03-16T00:00:00Z

使用警报Work with alerts

备注

目前,仅在 CLI 中支持警报(经典)。Only alerts (classic) is supported in CLI at this time.

在资源组中获取警报(经典)规则Get alert (classic) rules in a resource group

az monitor activity-log alert list --resource-group <group name>
az monitor activity-log alert show --resource-group <group name> --name <alert name>

创建指标警报(经典)规则Create a metric alert (classic) rule

az monitor alert create --name <alert name> --resource-group <group name> \
    --action email <email1 email2 ...> \
    --action webhook <URI> \
    --target <target object ID> \
    --condition "<METRIC> {>,>=,<,<=} <THRESHOLD> {avg,min,max,total,last} ##h##m##s"

删除警报(经典)规则Delete an alert (classic) rule

az monitor alert delete --name <alert name> --resource-group <group name>

日志配置文件Log profiles

可以按照此部分中的信息使用日志配置文件。Use the information in this section to work with log profiles.

获取日志配置文件Get a log profile

az monitor log-profiles list
az monitor log-profiles show --name <profile name>

添加具有保留期的日志配置文件Add a log profile with retention

az monitor log-profiles create --name <profile name> --location <location of profile> \
    --locations <locations to monitor activity in: location1 location2 ...> \
    --categories <categoryName1 categoryName2 ...> \
    --days <# days to retain> \
    --enabled true \
    --storage-account-id <storage account ID to store the logs in>

添加具有保留期和 EventHub 的日志配置文件Add a log profile with retention and EventHub

az monitor log-profiles create --name <profile name> --location <location of profile> \
    --locations <locations to monitor activity in: location1 location2 ...> \
    --categories <categoryName1 categoryName2 ...> \
    --days <# days to retain> \
    --enabled true
    --storage-account-id <storage account ID to store the logs in>
    --service-bus-rule-id <service bus rule ID to stream to>

删除日志配置文件Remove a log profile

az monitor log-profiles delete --name <profile name>

诊断Diagnostics

可以按照此部分中的信息使用诊断设置。Use the information in this section to work with diagnostic settings.

获取诊断设置Get a diagnostic setting

az monitor diagnostic-settings list --resource <target resource ID>

创建诊断设置Create a diagnostic setting

az monitor diagnostic-settings create --name <diagnostic name> \
    --storage-account <storage account ID> \
    --resource <target resource object ID> \
    --logs '[
    {
        "category": <category name>,
        "enabled": true,
        "retentionPolicy": {
            "days": <# days to retain>,
            "enabled": true
        }
    }]'

删除诊断设置Delete a diagnostic setting

az monitor diagnostic-settings delete --name <diagnostic name> \
    --resource <target resource ID>

自动缩放Autoscale

按照此部分中的信息使用自动缩放设置。Use the information in this section to work with autoscale settings. 需要修改这些示例。You need to modify these examples.

获取资源组的自动缩放设置Get autoscale settings for a resource group

az monitor autoscale list --resource-group <group name>

按名称获取资源组的自动缩放设置Get autoscale settings by name in a resource group

az monitor autoscale show --name <settings name> --resource-group <group name>

设置自动缩放设置Set autoscale settings

az monitor autoscale create --name <settings name> --resource-group <group name> \
    --count <# instances> \
    --resource <target resource ID>