mon-put-data
Descripción
Añade puntos de datos de métricas a la métrica especificada. Esta llamada incluirá datos de time-series, para el valor sin procesar o los valores estadísticos válidos de un nombre de métrica determinado. Admite la entrada de un punto de datos único a la vez.
nota
Cuando se crea una nueva métrica con el comando mon-put-data, puede tardar hasta dos minutos antes de poder recuperar las estadísticas en la nueva métrica mediante el comando mon-get-stats. Sin embargo, puede tardar hasta 15 minutos antes de que la nueva métrica aparezca en la lista de métricas recuperadas mediante el comando mon-list-metrics.
Sintaxis
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]
Opciones
| Nombre | Descripción |
|---|---|
|
-d, --dimensions "key1=value1,key2=value2..." |
Las dimensiones que identifican de forma única los datos de métricas. Puede especificar dimensiones dos formas y los formatos se pueden combinar o utilizar indistintamente:
Tipo: mapa Valores válidos: una cadena con el formato nombre=valor, donde la clave es el nombre de la dimensión y el valor es el valor de la dimensión. Los nombres de dimensión y los valores deben ser una cadena ANSI de entre 1 y 250 caracteres. Se permite un máximo de 10 dimensiones. Valor predeterminado: n/a Requerido: no |
|
|
El nombre de la métrica. Tipo: cadena Valores válidos: cualquier nombre de métrica válido entre 1 y 250 caracteres. Valor predeterminado: n/a Obligatorio: sí |
|
|
El nombre del espacio de la métrica. Para obtener más información acerca de los espacios de nombres, consulte Espacios de nombres de AWS. Tipo: cadena Valores válidos: cualquier cadena ANSI entre 1 y 250 caracteres de longitud. Valor predeterminado: n/a Obligatorio: sí |
|
|
Las estadísticas que se van a almacenar para el sello temporal y la métrica especificados. Esta opción es exclusiva con Tipo: mapa Valores válidos: una cadena que contiene todos los valores dobles para todos los nombres de estadísticas: SampleCount, Sum, Maximum y Minimum. Todos estos valores debe ser un valor comprendido entre 1E-130 y 1E130. Valor predeterminado: n/a Obligatorio: sí |
|
|
La marca temporal del punto de datos u observación para la métrica que se va a registrar. Las marcas temporales se especifican mediante el formato combinado ISO8601. Por ejemplo la fecha y la hora del 30 de julio de 2013 a las 12:30:00 PST se representa como 2013-07-30T12:30:00 -07:00 o en UTC: 2013-07-30T19:30:00Z. Tipo: simple Valores válidos: una marca temporal válida representada en formato ISO8601 con ajuste numérico de zona horaria o indicador UTC. Valor predeterminado: la hora UTC actual. Requerido: no |
|
|
La unidad para la métrica. Tipo: enumeración Valores válidos: uno de los siguientes:
Valor predeterminado: n/a Requerido: no |
|
|
Un solo valor que se va a registrar. El valor se traduce en un conjunto de estadísticas con el formato: SampleCount=1, Sum=VALUE, Minimum=VALUE, Maximum=VALUE. Esta opción es exclusiva de Tipo: simple Valores válidos: todos los valores debe ser un número comprendido entre 1E-130 y 1E130. Valor predeterminado: n/a Obligatorio: sí |
Opciones comunes
| Nombre | Descripción |
|---|---|
|
|
La ubicación del archivo de credenciales de AWS. Puede establecer este valor mediante la variable de entorno Tipo: cadena Valores válidos: Ruta de acceso válida de un archivo que contenga el ID de clave de acceso y la clave de acceso secreta. Valor predeterminado: Utiliza la variable de entorno |
|
|
La ubicación del archivo del certificado EC2 para las solicitudes de firma. Puede utilizar la variable de entorno Tipo: cadena Valores válidos: una ruta de archivo válida al archivo PEM que Amazon EC2 o AWS Identity and Access Management proporcionan. Valor predeterminado: Utiliza la variable de entorno |
|
|
El valor del tiempo de espera de la conexión en segundos. Tipo: entero Valores válidos: Cualquier número positivo. Valor predeterminado: 30 |
|
|
El delimitador que se va a utilizar al mostrar resultados delimitados (largos). Tipo: cadena Valores válidos: Cualquier cadena. Valor predeterminado: Coma (,) |
|
|
Si muestra resultados tabulares o delimitados, incluya las cabeceras de columna. Si muestra resultados XML, devuelva las cabeceras HTTP de la solicitud de servicio, si corresponde. Tipo: Flag Valores válidos: Cuando hay, muestra cabeceras. Valor predeterminado: La opción |
|
|
El ID de clave de acceso que se utilizará, en combinación con la clave secreta, para firmar la solicitud. Esto se debe utilizar en combinación con la clave secreta, de lo contrario, se ignora la opción. Todas las solicitudes a CloudWatch deben estar firmadas; de lo contrario, la solicitud se rechaza. Tipo: cadena Valores válidos: Un ID de clave de acceso válido. Valor predeterminado: none |
|
|
La clave privada que se va a utilizar para firmar la solicitud. El uso de claves públicas o privadas hace que la CLI utilice SOAP. La solicitud se firma con un certificado público y una clave privada. Este parámetro se debe usar junto con Tipo: cadena Valores válidos: Ruta de acceso a una clave privada ASN.1 válida. Valor predeterminado: none |
|
|
Las solicitudes de región se dirigen a. Puede utilizar la variable de entorno Tipo: cadena Valores válidos: Cualquier Región de AWS, por ejemplo, us-east-1. Valor predeterminado: us-east-1, a menos que la variable de entorno |
|
|
La clave de acceso secreta que se utilizará para firmar la solicitud, junto con un ID de clave de acceso. Este parámetro se debe usar junto con Tipo: cadena Valores válidos: ID de clave de acceso. Valor predeterminado: none |
|
|
Muestra campos vacíos al utilizar (nulo) como espacio disponible para indicar que no se solicitaron estos datos. Tipo: Flag Valores válidos: Ninguno Valor predeterminado: Los campos vacíos no se muestran de forma predeterminada. |
|
|
Muestra la URL que utiliza la CLI para llamar a AWS. Tipo: Flag Valores válidos: Ninguno Predeterminado: false |
|
|
Especifica cómo se muestran los resultados: en una tabla, delimitados (largos), XML o sin salida (silenciosos). La pantalla Tipo: Flag Valores válidos: Ninguno Valor predeterminado: |
|
|
La dirección URL que se utiliza para contactarse con CloudWatch. Puede establecer este valor mediante la variable de entorno Tipo: cadena Valores válidos: Una dirección HTTP o HTTPS válida. Valor predeterminado: utiliza el valor que se especifica en |
Salida
Este comando añade puntos de datos de métricas a una métrica.
La CLI de Amazon CloudWatch muestra errores en stderr.
Ejemplos
Ejemplo de solicitud
Este ejemplo pone los datos de estadística de RequestCount en el espacio de nombres MyService. La métrica no contiene ninguna dimensión y por tanto representa el RequestCount general en todo el servicio. La medición es un statisticValue agregado que representa cinco mediciones anteriores cuyo máximo era 70, cuyo mínimo era 30 y cuya suma 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"
Ejemplo de solicitud
Este ejemplo pone los datos de prueba de RequestCount específicos del usuario en el espacio de nombres MyService. El usuario y el nombre de pila se almacenan como dimensiones con el fin de distinguir esta métrica desde la métrica de todo el servicio en el ejemplo anterior.
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50
Temas relacionados de
Descargar
Acción relacionada
Comando relacionado
