mon-list-metrics

Descrição

Lista os nomes, os namespaces e as dimensões das métricas associados à conta da AWS. Filtre as métricas usando qualquer combinação de nome da métrica, namespace ou dimensões. Se você não especificar um filtro, todas as correspondências possíveis do atributo serão retornadas.

nota

O comando mon-list-metrics pode levar até quinze minutos para relatar nomes de métricas novos, namespaces e dimensões adicionados por chamadas para mon-put-data. Os pontos de dados colocados por mon-put-data, ou outros métodos, serão disponibilizados por mon-get-statistics em menos de cinco minutos.

Sintaxe

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

Opções

Name (Nome)	Descrição
-d, --dimensions "key1=value1,key2=value2..."	As dimensões da métrica a ser recuperada. Especifique dimensões de duas maneiras, e os formatos podem ser combinados ou usados de maneira intercambiável: Uma opção por dimensão: --dimensions "key1=value1" --dimensions "key2=value2" Opção multifuncional: --dimensions "key1=value1,key2=value2" Se nenhuma dimensão for especificada, nenhuma filtragem de dimensões será feita. Todos os outros filtros solicitados continuarão sendo aplicados. Para ser incluída no resultado uma métrica deve conter todas as dimensões especificadas, embora a métrica possa conter dimensões adicionais além das métricas solicitadas. Tipo: mapa Valores válidos: uma string do formato nome = valor, em que a chave é o nome da dimensão e o valor é o valor da dimensão. Os nomes de dimensão e os valores devem ser uma string ANSI entre 1 e 250 caracteres. Um máximo de 10 dimensões é permitido. Padrão: n/d Obrigatório: não
-m, --metric-name VALUE	O nome da métrica. Para ser incluído nos resultados, o nome da métrica deve corresponder ao nome da métrica solicitado exatamente. Se nenhum nome da métrica for especificado, nenhuma filtragem será feita. Todos os outros filtros solicitados são aplicados. Tipo: simples Valores válidos: qualquer nome da métrica válido entre 1 e 250 caracteres de comprimento. Padrão: n/d Obrigatório: não
-n, --namespace VALUE	O namespace a ser usado para filtrar métricas. Para obter mais informações sobre namespaces, consulte Namespaces do AWS. Tipo: sequência Valores válidos: um namespace válido entre 1 e 250 caracteres de comprimento. Padrão: n/d Obrigatório: não

Opções comuns

Nome	Descrição
--aws-credential-file VALUE	O local do arquivo com suas credenciais da AWS. É possível definir esse valor usando a variável de ambiente AWS_CREDENTIAL_FILE. Se você definir a variável de ambiente ou fornecer o caminho para o arquivo de credenciais, a solicitação falhará caso o arquivo não exista. Todas as solicitações do CloudWatch deverão ser assinadas usando seu ID da chave de acesso e sua chave de acesso secreta. Tipo: sequência Valores válidos: um caminho válido para um arquivo contendo seu ID da chave de acesso e sua chave de acesso secreta. Padrão: usa a variável de ambiente AWS_CREDENTIAL_FILE, se estiver definida.
-C, --ec2-cert-file-path VALUE	O local do arquivo de certificado do EC2 para solicitações de assinatura. É possível usar a variável de ambiente EC2_CERT para especificar esse valor. Tipo: sequência Valores válidos: um caminho de arquivo válido para o arquivo PEM fornecido pelo Amazon EC2 ou pelo AWS Identity and Access Management. Padrão: usa a variável de ambiente EC2_CERT, se estiver definida.
--connection-timeout VALUE	O valor de tempo limite de conexão, em segundos. Tipo: inteiro Valores válidos: qualquer número positivo. Padrão: 30
--delimiter VALUE	O delimitador a ser usado quando são exibidos resultados delimitados (longos). Tipo: sequência Valores válidos: qualquer string. Padrão: vírgula (,)
--headers	Se estiver exibindo resultados tabulares ou delimitados, inclua os cabeçalhos de coluna. Se estiver exibindo resultados em XML, retorne os cabeçalhos HTTP da solicitação de serviço, quando aplicável. Tipo: sinalizador Valores válidos: quando presente, exibe cabeçalhos. Padrão: a opção --headers fica desativada por padrão.
-I, --access-key-id VALUE	O ID da chave de acesso que será usada, em conjunto com a chave secreta, para assinar a solicitação. Esse parâmetro deverá ser usado em conjunto com --secret-key, ou a opção será ignorada. Todas as solicitações para o CloudWatch deverão ser assinadas, ou a solicitação será rejeitada. Tipo: sequência Valores válidos: um ID da chave de acesso válido. Padrão: nenhum
-K, --ec2-private-key-file-path VALUE	A chave privada que será usada para assinar a solicitação. Utilizar chaves públicas/privadas faz com que a CLI use SOAP. A solicitação é assinada com um certificado público e uma chave privada. Esse parâmetro deverá ser usado em conjunto com EC2_CERT, ou o valor será ignorado. O valor da variável de ambiente EC2_PRIVATE_KEY será usado se estiver definido e se essa opção não estiver especificada. Essa opção será ignorada se a variável de ambiente AWS_CREDENTIAL_FILE estiver definida ou quando se utilizar --aws-credentials-file. Todas as solicitações para o CloudWatch deverão ser assinadas, ou a solicitação será rejeitada. Tipo: sequência Valores válidos: o caminho para uma chave privada ASN.1 válida. Padrão: nenhum
--region VALUE	A região para onde as solicitações são direcionadas. É possível usar a variável de ambiente EC2_REGION para especificar o valor. Utiliza-se a região para criar a URL usada para chamar o CloudWatch e deve ser uma região da Amazon Web Services válida (AWS). Tipo: sequência Valores válidos: qualquer região da AWS, por exemplo, us-east-1. Padrão: us-east-1, a menos que a variável de ambiente EC2_REGION esteja definida.
S, --secret-key VALUE	A chave de acesso secreta que será usada para assinar a solicitação, em conjunto com a ID da chave de acesso. Esse parâmetro deverá ser usado em conjunto com --access-key-id, ou essa opção será ignorada. Tipo: sequência Valores válidos: seu ID da chave de acesso. Padrão: nenhum
--show-empty-fields	Exibe campos vazios usando (nil) como espaço reservado para indicar que esses dados não foram solicitados. Tipo: sinalizador Valores válidos: nenhum Padrão: campos vazios não são exibidos por padrão.
--show-request	Exibe a URL que a CLI usa para chamar a AWS. Tipo: sinalizador Valores válidos: nenhum Padrão: falso
--show-table, --show-long, --show-xml, --quiet	Especifica como os resultados são exibidos: em uma tabela, delimitados (longos), XML ou nenhuma saída (silenciosos). A exibição --show-table mostra um subconjunto dos dados em forma fixa de largura de coluna; --show-long exibe todos os valores retornados delimitados por um caractere; --show-xml é o retorno bruto do serviço; e --quiet suprime todas as saídas padrão. Todas as opções são mutuamente exclusivas, tendo prioridade --show-table, --show-long, --show-xml e --quiet. Tipo: sinalizador Valores válidos: nenhum Padrão: --show-table
-U, --url VALUE	A URL usada para entrar em contato com o CloudWatch. É possível definir esse valor usando a variável de ambiente AWS_CLOUDWATCH_URL. Esse valor é usado em conjunto com --region para criar a URL esperada. Essa opção substitui a URL da chamada de serviço. Tipo: sequência Valores válidos: uma URL HTTP ou HTTPS válida. Padrão: usa o valor especificado em AWS_CLOUDWATCH_URL, se estiver definido.

Resultado

Esse comando retorna uma tabela que contém o seguinte:

• Nome da métrica – O nome da métrica anexado a essa métrica.

• Namespace – O namespace associado a essa métrica.

• Dimensões – Os nomes e os valores da dimensão associados a essa métrica.

A CLI do Amazon CloudWatch exibe erros em stderr.

Exemplos

Exemplo de solicitação

Esse exemplo retorna uma lista de todas as métricas.

mon-list-metrics 

Esse é um exemplo de uma saída de uma chamada para '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}
...

Exemplo de solicitação

Esse exemplo lista as métricas com o nome especificado.

mon-list-metrics --metric-name RequestCount

Exemplo de solicitação

Esse exemplo lista as métricas pertencentes ao namespace especificado.

mon-list-metrics --namespace MyService

Exemplo de solicitação

Esse exemplo lista as métricas com os nomes de dimensões e os valores especificados.

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

Tópicos relacionados

Baixar

• Configurar a interface de linha de comando

Ação relacionada

• ListMetrics

Comando relacionado

• mon-describe-alarms