mon-list-metrics
描述
列出与您的 Amazon 账户关联的指标的名称、命名空间和维度。可以使用指标名称、命名空间或维度的任意组合筛选指标。如果不指定筛选条件，则会返回针对该属性的所有可能的匹配项目。
注意
mon-list-metrics 命令可能最多需要 15 分钟的时间才能报告由对 mon-put-data 的调用添加的新指标名称、命名空间和维度。mon-put-data 或其他方法放置的数据点将在不到 5 分钟的时间内可供 mon-get-statistics 使用。
语法
mon-list-metrics [--dimensions
"key1=
value1,key2=value2..."] [--metric-name value] [--namespace value] [Common Options]
Options
| 名称 | 描述 |
|---|---|
|
-d, --dimensions |
要检索的指标的维度。可以两种方式指定维度，且格式可结合使用或互换使用：
如果未指定任何维度，将无法执行维度筛选。将仍应用所有其他请求的筛选条件。要包含在结果中，指标必须包含所有指定的维度，尽管该指标可能包含请求的指标之外的其他维度。 类型：映射 有效值：格式为 name=value 的字符串，其中，键是维度的名称，值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。 默认值：不适用 必需：否 |
|
|
指标的名称。要包含在结果中，该指标名称必须与请求的指标名称完全匹配。如果未指定指标名称，则不会执行筛选。将应用所有其他请求的筛选条件。 类型：简单 有效值：长度介于 1 到 250 个字符之间的任何有效指标名称。 默认值：不适用 必需：否 |
|
|
要用于筛选指标的命名空间。有关命名空间的更多信息，请参阅 Amazon 命名空间。 类型：字符串 有效值：长度介于 1 到 250 个字符之间的有效命名空间。 默认值：不适用 必需：否 |
常用选项
| 名称 | 描述 |
|---|---|
|
|
带有 Amazon 凭证的文件的位置。您可以使用环境变量 类型：字符串 有效值：包含访问密钥 ID 和秘密访问密钥的文件的有效路径。 默认值：使用环境变量 |
|
|
用于签署请求的 EC2 证书文件的位置。您可以使用环境变量 类型：字符串 有效值：由 Amazon EC2 或 Amazon Identity and Access Management 提供的 PEM 文件的有效路径。 默认值：使用环境变量 |
|
|
连接超时值（以秒为单位）。 类型：整数 有效值：任何正数。 默认：30 |
|
|
显示经分隔（长）结果时使用的分隔符。 类型：字符串 有效值：任意字符串。 默认值：逗号 (,) |
|
|
如果要显示表格结果或分隔结果，请包括列标题。如果要显示 XML 结果，请从服务请求返回 HTTP 标头（如果适用）。 类型：标记 有效值：如果存在，则显示标头。 默认值：默认情况下， |
|
|
访问密钥 ID 将与私有密钥共同用于签署请求。其必须与私有密钥结合使用，否则此选项将被忽略。对 CloudWatch 的所有请求都必须签署，否则请求将被拒绝。 类型：字符串 有效值：有效访问密钥 ID。 默认值：无 |
|
|
将用于签署请求的私有密钥。使用公有/私有密钥会导致 CLI 使用 SOAP。此请求通过公有证书和私有密钥签署。此参数必须与 类型：字符串 有效值：有效 ASN.1 私有密钥的路径。 默认值：无 |
|
|
定向到区域请求。您可以使用环境变量 类型：字符串 有效值：任意 Amazon 区域，例如 us-east-1。 默认值：除非 |
|
|
将与访问密钥 ID 共同用于签署请求的秘密访问密钥。此参数必须与 类型：字符串 有效值：您的访问密钥 ID。 默认值：无 |
|
|
使用 (nil) 作为占位符显示空字段，以指示未请求此数据。 类型：标记 有效值：无 默认值：默认情况下不显示空字段。 |
|
|
显示 CLI 用于调用 Amazon 的 URL。 类型：标记 有效值：无 默认：false |
|
|
指定结果的显示方式：表格、分隔（长）、XML 或无输出（无提示）。 类型：标记 有效值：无 默认： |
|
|
用于联系 CloudWatch 的 URL。您可以使用环境变量 类型：字符串 有效值：有效 HTTP 或 HTTPS URL。 默认值：使用 |
输出
此命令将返回包含以下内容的表格：
-
指标名称 - 与该指标连接的指标的名称。
-
命名空间 - 与该指标关联的命名空间。
-
维度 - 与该指标关联的维度名称和值。
Amazon CloudWatch CLI 在 stderr 上显示错误。
示例
示例请求
此示例返回所有指标的列表。
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} ...
示例请求
此示例列出了具有指定名称的指标。
mon-list-metrics --metric-name RequestCount
示例请求
此示例列出了属于指定命名空间的指标。
mon-list-metrics --namespace MyService
示例请求
此示例列出具有指定维度名称和值的指标。
mon-list-metrics --dimensions "User=SomeUser,Stack=Test"