mon-list-metrics - Amazon CloudWatch
DescriçãoSintaxeOpçõesOpções comunsSaídaExemplosTópicos relacionados da

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

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: string

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: string

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: string

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: número 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: string

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: string

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: string

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: string

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: string

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: False

--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: string

Valores válidos: uma URL HTTP ou HTTPS válida.

Padrão: usa o valor especificado em AWS_CLOUDWATCH_URL, se estiver definido.

Saída

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 da

Baixar

Ação relacionada

Comando relacionado