# mon-list-metrics
<a name="cli-mon-list-metrics"></a>

## 说明
<a name="w2aab9c43b3"></a>

列出与您的 AWS 账户关联的指标的名称、命名空间和维度。可以使用指标名称、命名空间或维度的任意组合筛选指标。如果不指定筛选条件，则会返回针对该属性的所有可能的匹配项目。

**注意**  
mon-list-metrics 命令可能最多需要 15 分钟的时间才能报告由对 `mon-put-data` 的调用添加的新指标名称、命名空间和维度。`mon-put-data` 或其他方法放置的数据点将在不到 5 分钟的时间内可供 `mon-get-statistics` 使用。

## 语法
<a name="w2aab9c43b5"></a>

 ****mon-list-metrics** [--dimensions "key1={{value1}},key2={{value2}}..."] [--metric-name {{value}}] [--namespace {{value}}] [Common Options] ** 

## 选项
<a name="w2aab9c43b7"></a>


| 名称 | 描述 | 
| --- | --- | 
| -d, --dimensions `"key1=value1,key2=value2..."`  | 要检索的指标的维度。可以两种方式指定维度，且格式可结合使用或互换使用：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/AmazonCloudWatch/latest/cli/cli-mon-list-metrics.html)<br />如果未指定任何维度，将无法执行维度筛选。将仍应用所有其他请求的筛选条件。要包含在结果中，指标必须包含所有指定的维度，尽管该指标可能包含请求的指标之外的其他维度。<br />类型：映射<br />有效值：格式为 name=value 的字符串，其中，键是维度的名称，值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。<br />默认值：不适用<br />必需：否 | 
| `-m, --metric-name` `VALUE`  | 指标的名称。要包含在结果中，该指标名称必须与请求的指标名称完全匹配。如果未指定指标名称，则不会执行筛选。将应用所有其他请求的筛选条件。<br />类型：简单<br />有效值：长度介于 1 到 250 个字符之间的任何有效指标名称。<br />默认值：不适用<br />必需：否 | 
| `-n, --namespace` ` VALUE`  | 要用于筛选指标的命名空间。有关命名空间的更多信息，请参阅 [AWS 命名空间](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html)。<br />类型：字符串<br />有效值：长度介于 1 到 250 个字符之间的有效命名空间。<br />默认值：不适用<br />必需：否 | 

## 常用选项
<a name="w2aab9c43b9"></a>


| 名称 | 描述 | 
| --- | --- | 
| `--aws-credential-file` `VALUE`  | 带有 AWS 凭证的文件的位置。您可以使用环境变量 `AWS_CREDENTIAL_FILE` 设置此值。如果您定义了环境变量或提供了凭证文件的路径，则该文件必须存在，否则请求将失败。必须使用访问密钥 ID 和秘密访问密钥签署所有 CloudWatch 请求。<br />类型：字符串<br />有效值：包含访问密钥 ID 和秘密访问密钥的文件的有效路径。<br />默认值：使用环境变量 `AWS_CREDENTIAL_FILE`（如果已设置）。 | 
| `-C, --ec2-cert-file-path` `VALUE`  | 用于签署请求的 EC2 证书文件的位置。您可以使用环境变量 `EC2_CERT` 指定此值。<br />类型：字符串<br />有效值：由 Amazon EC2 或 AWS Identity and Access Management 提供的 PEM 文件的有效路径。<br />默认值：使用环境变量 `EC2_CERT`（如果已设置）。 | 
|  `--connection-timeout` `VALUE`  | 连接超时值（以秒为单位）。<br />类型：整数<br />有效值：任何正数。<br />默认：30 | 
|  `--delimiter` `VALUE`  | 显示经分隔（长）结果时使用的分隔符。<br />类型：字符串<br />有效值：任意字符串。<br />默认值：逗号 (,) | 
|  `--headers` ``  | 如果要显示表格结果或分隔结果，请包括列标题。如果要显示 XML 结果，请从服务请求返回 HTTP 标头（如果适用）。<br />类型：标记<br />有效值：如果存在，则显示标头。<br />默认值：默认情况下，`--headers` 选项为关闭状态。 | 
|  `-I, --access-key-id` `VALUE`  | 访问密钥 ID 将与私有密钥共同用于签署请求。其必须与私有密钥结合使用，否则此选项将被忽略。对 CloudWatch 的所有请求都必须签署，否则请求将被拒绝。<br />类型：字符串<br />有效值：有效访问密钥 ID。<br />默认值：无 | 
|  `-K, --ec2-private-key-file-path` `VALUE`  | 将用于签署请求的私有密钥。使用公有/私有密钥会导致 CLI 使用 SOAP。此请求通过公有证书和私有密钥签署。此参数必须与 `EC2_CERT` 结合使用，否则此值将被忽略。环境变量 `EC2_PRIVATE_KEY` 的值将在设置时使用，并且未指定此选项。如果环境变量 `AWS_CREDENTIAL_FILE` 已设置，或 `--aws-credentials-file` 已使用，则此选项将被忽略。对 CloudWatch 的所有请求都必须签署，否则请求将被拒绝。<br />类型：字符串<br />有效值：有效 ASN.1 私有密钥的路径。<br />默认值：无 | 
|  `--region` `VALUE`  | 定向到区域请求。您可以使用环境变量 `EC2_REGION` 指定该值。该区域用于创建用于调用 CloudWatch 的 URL，并且必须是有效的亚马逊云科技 (AWS）区域。<br />类型：字符串<br />有效值：任意 AWS 区域，例如 us-east-1。<br />默认值：除非 `EC2_REGION` 环境变量已设置，否则为 us-east-1。 | 
|  `S, --secret-key` `VALUE`  | 将与访问密钥 ID 共同用于签署请求的秘密访问密钥。此参数必须与 `--access-key-id` 结合使用，否则此选项将被忽略。<br />类型：字符串<br />有效值：您的访问密钥 ID。<br />默认值：无 | 
|  `--show-empty-fields` ``  | 使用 (nil) 作为占位符显示空字段，以指示未请求此数据。<br />类型：标记<br />有效值：无<br />默认值：默认情况下不显示空字段。 | 
|  `--show-request` ``  | 显示 CLI 用于调用 AWS 的 URL。<br />类型：标记<br />有效值：无<br />默认：false | 
|  `--show-table, --show-long, --show-xml, --quiet` ``  | 指定结果的显示方式：表格、分隔（长）、XML 或无输出（无提示）。`--show-table` 显示以固定列宽形式显示数据的子集；`--show-long` 显示以字符分隔的所有返回值；`--show-xml` 是服务的原始返回值；`--quiet` 将抑制所有标准输出。所有选项是互斥的，优先级：`--show-table`、`--show-long`、`--show-xml` 和 `--quiet`。<br />类型：标记<br />有效值：无<br />默认值：`--show-table` | 
|  `-U, --url` `VALUE`  | 用于联系 CloudWatch 的 URL。您可以使用环境变量 `AWS_CLOUDWATCH_URL` 设置此值。此值与 `--region` 共同用于创建预期的 URL。此选项将覆盖用于服务调用的 URL。<br />类型：字符串<br />有效值：有效 HTTP 或 HTTPS URL。<br />默认值：使用 `AWS_CLOUDWATCH_URL`（如果已设置）中指定的值。 | 

## Output
<a name="w2aab9c43c11"></a>

此命令将返回包含以下内容的表格：
+ 指标名称 - 与该指标连接的指标的名称。
+ 命名空间 - 与该指标关联的命名空间。
+ 维度 - 与该指标关联的维度名称和值。

Amazon CloudWatch CLI 在 stderr 上显示错误。

## 示例
<a name="w2aab9c43c13"></a>

### 示例请求
<a name="w2aab9c43c13b2"></a>

此示例返回所有指标的列表。

```
mon-list-metrics 
```

此示例展示了对“mon-list-metrics”的调用的输出。

```
Metric Name                 Namespace  Dimensions
CPUUtilization               AWS/EC2    {InstanceId=i-e7e48a8e}
CPUUtilization               AWS/EC2    {InstanceId=i-231d744a}
CPUUtilization               AWS/EC2    {InstanceId=i-22016e4b}
CPUUtilization               AWS/EC2    {InstanceId=i-b0345cd9}
CPUUtilization               AWS/EC2    {InstanceId=i-539dff3a}
CPUUtilization               AWS/EC2    {InstanceId=i-af3544c6}
CPUUtilization               AWS/EC2    {InstanceId=i-d4f29ebd}
CPUUtilization               AWS/EC2    {ImageId=ami-de4daab7}
...
```

### 示例请求
<a name="w2aab9c43c13b4"></a>

此示例列出了具有指定名称的指标。

```
mon-list-metrics --metric-name RequestCount
```

### 示例请求
<a name="w2aab9c43c13b6"></a>

此示例列出了属于指定命名空间的指标。

```
mon-list-metrics --namespace MyService
```

### 示例请求
<a name="w2aab9c43c13b8"></a>

此示例列出具有指定维度名称和值的指标。

```
mon-list-metrics --dimensions "User=SomeUser,Stack=Test"
```

## 相关主题
<a name="w2aab9c43c15"></a>

### 下载
<a name="w2aab9c43c15b2"></a>
+ [设置命令行界面](SetupCLI.md)

### 相关操作
<a name="w2aab9c43c15b4"></a>
+ [ListMetrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListMetrics.html)

### 相关命令
<a name="w2aab9c43c15b6"></a>
+  [mon-describe-alarms](cli-mon-describe-alarms.md)