Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
SOURCE
Incluirlo SOURCE en una consulta es una forma útil de especificar los grupos de registros que se van a incluir en una consulta cuando se utiliza la API AWS CLI o para crear una consulta. El SOURCE comando solo se admite en la API AWS CLI and, no en la CloudWatch consola. Cuando usa la CloudWatch consola para iniciar una consulta, usa la interfaz de la consola para especificar los grupos de registros.
SOURCEPara especificar los grupos de registros que se van a consultar, puede utilizar las siguientes palabras clave:
-
namePrefixejecuta la consulta en grupos de registros que tienen nombres que comienzan por la cadena que especifique. Si lo omite, se consultarán todos los grupos de registros.Puede incluir hasta cinco prefijos en la lista.
-
accountIdentifiersejecuta la consulta en los grupos de registros de la AWS cuenta especificada. Esto solo funciona cuando se ejecuta la consulta en una cuenta de supervisión. Si lo omite, la opción predeterminada es consultar todas las cuentas de origen vinculadas y la cuenta de supervisión actual. Para obtener más información sobre la observabilidad entre cuentas, consulte CloudWatch Observabilidad entre cuentas.Puedes incluir hasta 20 identificadores de cuenta en la lista.
-
logGroupClassejecuta la consulta en grupos de registros que se encuentran en la clase de registro especificada, ya sea de acceso estándar o de acceso poco frecuente. Si lo omite, se utilizará la clase de registro estándar por defecto. Para obtener más información acerca de las clases de registros, consulte Clases de registro.
Como puede especificar un gran número de grupos de registros para consultarlos de esta manera, le recomendamos que los utilice SOURCE únicamente en consultas que aprovechen los índices de campos que haya creado. Para obtener más información sobre la indexación de campos en grupos de registros, consulte Cree índices de campos para mejorar el rendimiento de las consultas y reducir el volumen de digitalización
En el siguiente ejemplo, se seleccionan todos los grupos de registros de la cuenta. Si se trata de una cuenta de supervisión, los grupos de registros en función de la supervisión y se seleccionarán todas las cuentas de origen. Si el número total de grupos de registros supera los 10 000, aparecerá un error que le pedirá que reduzca el número de grupos de registros mediante un método de selección de grupos de registros diferente.
SOURCE logGroups()
En el siguiente ejemplo, se seleccionan los grupos de registros de la cuenta 111122223333 de origen. Si inicias una consulta en una cuenta de supervisión de forma observable CloudWatch entre cuentas, los grupos de registros de todas las cuentas de origen y de la cuenta de supervisión se seleccionan de forma predeterminada.
SOURCE logGroups(accountIdentifiers:['111122223333'])
En el siguiente ejemplo, se seleccionan los grupos de registros en función de los prefijos de los nombres.
SOURCE logGroups(namePrefix: ['namePrefix1', 'namePrefix2'])
En el siguiente ejemplo, se seleccionan todos los grupos de registros de la clase de registro Infrequent Access. Si no incluye el class identificador, la consulta solo se aplica a los grupos de registros de la clase de registro estándar, que es la predeterminada.
SOURCE logGroups(class: ['INFREQUENT_ACCESS'])
En el siguiente ejemplo, se seleccionan los grupos de registros de la cuenta 111122223333 que comienzan con prefijos de nombre específicos y pertenecen a la clase de registro estándar. La clase no se menciona en el comando porque Estándar es el valor predeterminado de la clase de registro.
SOURCE logGroups(accountIdentifiers:['111122223333'], namePrefix: ['namePrefix1', 'namePrefix2']
El último ejemplo muestra cómo utilizar el SOURCE comando con el start-query AWS CLI comando.
aws logs start-query --region us-east-1 --start-time 1729728200 --end-time 1729728215 --query-string "SOURCE logGroups(namePrefix: ['Query']) | fields @message | limit 5"
