SOURCE - Amazon CloudWatch Logs

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 las fuentes de and/or datos de 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.

Consulte los grupos de registros

A fin de utilizar SOURCE para especificar los grupos de registros que se van a consultar, se pueden utilizar las siguientes palabras clave:

  • namePrefix ejecuta la consulta en grupos de registros que tienen nombres que comienzan por la cadena que se especifique. Si se 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 monitoreo. Si se omite, la opción predeterminada es consultar todas las cuentas de origen vinculadas y la cuenta de monitoreo actual. Para obtener más información sobre la observabilidad entre cuentas, consulta la observabilidad CloudWatch entre cuentas.

    Se pueden incluir hasta 20 identificadores de cuenta en la lista.

  • logGroupClass ejecuta 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 se omite esto, se usa la clase de registro predeterminada, que es Estándar. Para obtener más información acerca de las clases de registros, consulte Clases de registro.

Como se puede especificar un gran número de grupos de registros para consultarlos de esta manera, se recomienda que utilice SOURCE únicamente en consultas que aprovechen los índices de campos que se hayan creado. Para obtener más información acerca de la indexación de campos en grupos de registro, consulte Creación de índices de campo para mejorar el rendimiento de las consultas y reducir el volumen de análisis

En el siguiente ejemplo se seleccionan todos los grupos de registro de la cuenta. Si se trata de una cuenta de monitoreo, entonces se seleccionarán todos los grupos de registros en función del monitoreo y todas las cuentas de origen. Si el número total de grupos de registros supera los 10 000, aparecerá un error que pedirá que se 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 de origen 111122223333. Si inicias una consulta en una cuenta de supervisión en el marco de la observabilidad CloudWatch multicuenta, 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 registro de la clase de registro de acceso poco frecuente. Si no incluye el identificador class, la consulta se aplica únicamente a los grupos de registro en 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"

Consulta del origen de datos

SOURCEPara especificar las fuentes de datos que se van a consultar, puede utilizar la dataSource palabra clave. Puede incluir hasta diez fuentes de datos en la lista.

En el siguiente ejemplo, se selecciona la fuente de amazon_vpc.flow datos. 

SOURCE dataSource(['amazon_vpc.flow'])

En el siguiente ejemplo, se selecciona la fuente de amazon_vpc.flow datos y se limitan los grupos de registros en función de un prefijo de nombre de grupo de registros. 

SOURCE dataSource(['amazon_vpc.flow']) logGroups(namePrefix: ['namePrefix1'])