mon-put-data
Descrição
Adicione pontos de dados de métrica à métrica especificada. Essa chamada colocará dados de série temporal para o valor bruto ou valores estatísticos válidos de um determinado nome da métrica. Ele oferece suporte à entrada de um único ponto de dados por vez.
nota
Quando você cria uma nova métrica usando o comando mon-put-data, pode levar até dois minutos para recuperar estatísticas na nova métrica usando o comando mon-get-stats. No entanto, pode levar até 15 minutos para que a nova métrica seja exibida na lista de métricas recuperadas com o comando mon-list-metrics.
Sintaxe
mon-put-data --metric-name
value[--namespace value
[--dimensions
"key1=value1,key2=value2..."]
[--statisticValues
"key1=value1,key2=value2..."]
[--timestamp value] [--unit value]
[--value value] [Common Options]
Opções
| Nome | Descrição |
|---|---|
|
-d, --dimensions "key1=value1,key2=value2..." |
As dimensões que identificam com exclusividade os dados da métrica. Especifique dimensões de duas maneiras, e os formatos podem ser combinados ou usados de maneira intercambiável:
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 |
|
|
O nome da métrica. Tipo: string Valores válidos: qualquer nome da métrica válido entre 1 e 250 caracteres. Padrão: n/d Obrigatório: Sim |
|
|
O namespace da métrica. Para obter mais informações sobre namespaces, consulte Namespaces do AWS. Tipo: string Valores válidos: uma string ANSI entre 1 e 250 caracteres de comprimento. Padrão: n/d Obrigatório: Sim |
|
|
As estatísticas a serem armazenadas para o time stamp e a métrica especificados. Essa opção é exclusiva com Tipo: mapa Valores válidos: uma string contendo todos os valores duplos para todos os nomes de estatísticas: SampleCount, Sum, Maximum e Minimum. Todos esses valores devem ser um valor entre 1E-130 e 1E130. Padrão: n/d Obrigatório: Sim |
|
|
O time stamp do ponto de dados ou a observação da métrica a ser registrado. Os time stamps são especificados usando-se o formato combinado ISO8601. Por exemplo, a data e a hora em 30 de julho de 2013, 12:30:00 PST, seriam representadas como 2013-07-30T12:30:00-07:00 ou em UTC: 2013-07-30T19:30:00Z. Tipo: simples Valores válidos: um time stamp válido representado no formato ISO8601 com diferença de fuso horário ou indicador UTC. Padrão: a hora UTC atual. Obrigatório: Não |
|
|
A unidade da métrica. Tipo: enumeração Valores válidos: um dos seguintes:
Padrão: n/d Obrigatório: Não |
|
|
Um único valor a ser registrado. O valor é convertido em um conjunto de estatísticas do formulário: SampleCount=1, Sum=VALUE, Minimum=VALUE, Maximum=VALUE. Essa opção é exclusiva de Tipo: simples Valores válidos: todos os valores devem ser um número entre 1E-130 e 1E130. Padrão: n/d Obrigatório: Sim |
Opções comuns
| Nome | Descrição |
|---|---|
|
|
O local do arquivo com suas credenciais da AWS. É possível definir esse valor usando a variável de ambiente 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 |
|
|
O local do arquivo de certificado do EC2 para solicitações de assinatura. É possível usar a variável de ambiente 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 |
|
|
O valor de tempo limite de conexão, em segundos. Tipo: número inteiro Valores válidos: qualquer número positivo. Padrão: 30 |
|
|
O delimitador a ser usado quando são exibidos resultados delimitados (longos). Tipo: string Valores válidos: qualquer string. Padrão: vírgula (,) |
|
|
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 |
|
|
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 |
|
|
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 Tipo: string Valores válidos: o caminho para uma chave privada ASN.1 válida. Padrão: nenhum |
|
|
A região para onde as solicitações são direcionadas. É possível usar a variável de ambiente 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 |
|
|
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 Tipo: string Valores válidos: seu ID da chave de acesso. Padrão: nenhum |
|
|
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. |
|
|
Exibe a URL que a CLI usa para chamar a AWS. Tipo: sinalizador Valores válidos: nenhum Padrão: False |
|
|
Especifica como os resultados são exibidos: em uma tabela, delimitados (longos), XML ou nenhuma saída (silenciosos). A exibição Tipo: sinalizador Valores válidos: nenhum Padrão: |
|
|
A URL usada para entrar em contato com o CloudWatch. É possível definir esse valor usando a variável de ambiente Tipo: string Valores válidos: uma URL HTTP ou HTTPS válida. Padrão: usa o valor especificado em |
Saída
Esse comando adiciona pontos de dados de métrica a uma métrica.
A CLI do Amazon CloudWatch exibe erros em stderr.
Exemplos
Exemplo de solicitação
Esse exemplo coloca dados estatísticos de RequestCount no namespace MyService. A métrica não contém dimensões e, assim, representa o RequestCount geral em todo o serviço. A medição é um statisticValue pré-agregado representando cinco medições anteriores cujo máximo era 70, cujo mínimo era 30 e cuja soma era 250.
mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"
Exemplo de solicitação
Esse exemplo coloca dados de teste RequestCount específicos do usuário no namespace MyService. O usuário e o nome da pilha são armazenados como dimensões para diferenciar essa métrica da métrica em todo o serviço no exemplo acima.
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50
Tópicos relacionados da
Baixar
Ação relacionada
Comando relacionado
