mon-list-metrics
Descripción
Enumera los nombres, espacios de nombres y dimensiones de las métricas asociadas con su cuenta de AWS. Puede filtrar las métricas mediante cualquier combinación de nombre de métrica, espacio de nombres o dimensiones. Si no especifica un filtro, se devuelven todas las posibles coincidencias para el atributo.
nota
El comando mon-list-metrics puede tardar hasta quince minutos en notificar nombres de métricas, espacios de nombres y dimensiones nuevos añadidos mediante llamadas a mon-put-data
. Los puntos de datos puestos por mon-put-data
o por otros métodos estarán disponible por mon-get-statistics
en menos de cinco minutos.
Sintaxis
mon-list-metrics [--dimensions
"key1=
value1
,key2=value2
..."] [--metric-name value
] [--namespace value
] [Common Options]
Opciones
Nombre | Descripción |
---|---|
-d, --dimensiones |
Las dimensiones de la métrica que se va a recuperar. Puede especificar dimensiones dos formas y los formatos se pueden combinar o utilizar indistintamente:
Si no se especifican las dimensiones, no se realizará ningún filtrado de dimensiones. Se seguirá aplicando cualquier otro filtro solicitado. Para que se incluya en el resultado una métrica debe contener todas las dimensiones especificadas, aunque la métrica puede contener dimensiones adicionales más allá de las métricas solicitadas. 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. Para que se incluya en los resultados, el nombre de la métrica debe coincidir exactamente con el nombre de métrica solicitada. Si no se especifica el nombre de métrica no se realiza ningún filtrado. Se aplica cualquier otro filtro solicitado. Tipo: simple Valores válidos: cualquier nombre de métrica válido entre 1 y 250 caracteres de longitud. Valor predeterminado: n/a Requerido: no |
|
El espacio de nombres que se usará para filtrar métricas. Para obtener más información acerca de los espacios de nombres, consulte Espacios de nombres de AWS. Tipo: cadena Valores válidos: un espacio de nombres válido de entre 1 y 250 caracteres de longitud. Valor predeterminado: n/a Requerido: no |
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 devuelve una tabla que contiene lo siguiente:
-
Nombre de métrica: el nombre de la métrica asociada a esta métrica.
-
Espacio de nombres: el espacio de nombres asociado a esta métrica.
-
Dimensiones: los nombres de dimensión nombres y valores asociados con esta métrica.
La CLI de Amazon CloudWatch muestra errores en stderr.
Ejemplos
Ejemplo de solicitud
Este ejemplo devuelve una lista de todas sus métricas.
mon-list-metrics
Este es un ejemplo de una salida de una llamada a 'mon-list-métrics'.
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} ...
Ejemplo de solicitud
Este ejemplo muestra las métricas con el nombre especificado.
mon-list-metrics --metric-name RequestCount
Ejemplo de solicitud
Este ejemplo muestra las métricas que pertenecen al espacio de nombres especificado.
mon-list-metrics --namespace MyService
Ejemplo de solicitud
Este ejemplo muestra las métricas con los nombres de dimensión y valores especificados.
mon-list-metrics --dimensions "User=SomeUser,Stack=Test"