View a markdown version of this page

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.

  • accountIdentifierejecuta 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 se 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, 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 supervisión, entonces se seleccionarán todos los grupos de registros de la supervisión 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(accountIdentifier:['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(accountIdentifier:['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"

Consulte las fuentes 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'])

Consulte grupos de registros por etiquetas

SOURCEPara filtrar grupos de registros por sus etiquetas, utilice la logGroupTags función. Especifique las etiquetas como una lista de filtros de etiquetas, cada uno con una key values matriz opcional.

  • Se combinan varios filtros de etiquetas con claves diferentes con la lógica AND.

  • Los valores múltiples del mismo filtro de etiquetas se combinan con la lógica OR.

  • Se utiliza * para hacer coincidir caracteres comodín. Por ejemplo, payment* coincide con los valores que comienzan por. payment

  • Se usa ! como prefijo para la negación. Por ejemplo, !production coincide con valores que no lo son. production

  • Puede incluir hasta cinco filtros de etiquetas, cada uno con un máximo de cinco valores.

En el siguiente ejemplo, se seleccionan todos los grupos de registros con los que se ha etiquetadoteam=team1 OR team=team2.

SOURCE logGroupTags([{"key":"team", "values":["team1", "team2"]}])
| fields @message, @timestamp

En el siguiente ejemplo, se seleccionan los grupos de registros en los que la service etiqueta comienza y la environment etiqueta noproduction. payment

SOURCE logGroupTags([{"key":"service", "values":["payment*"]}, {"key":"environment", "values":["!production"]}])
| fields @message, @timestamp

El siguiente ejemplo combina el filtrado de etiquetas con un filtro de prefijo de nombre.

SOURCE logGroups(namePrefix: ['/aws/lambda']) logGroupTags([{"key":"environment", "values":["production"]}])
| fields @message, @timestamp