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
SOURCEIncluirlos en una consulta es una forma útil de especificar las fuentes de and/or datos de los grupos de registros que se deben 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 y, no en la CloudWatch consola. Cuando se utiliza la CloudWatch consola para iniciar una consulta, se utiliza la interfaz de la consola para especificar los grupos de registros.
Grupos de registros de consultas
A fin de utilizar SOURCE para especificar los grupos de registros que se van a consultar, se pueden utilizar las siguientes palabras clave:
-
namePrefixejecuta 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 5 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, consulte Observabilidad CloudWatch entre cuentas.Se pueden 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 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 puedes especificar un gran número de grupos de registros para consultarlos de esta forma, te recomendamos que los utilices SOURCE únicamente en las consultas que utilicen los índices de campo que hayas 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 con capacidad de observación 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(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 usar 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 desea 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'])
Grupos de registros de consultas por etiquetas
SOURCEPara filtrar los 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.
Los múltiples filtros de etiquetas con diferentes claves se combinan con la lógica AND.
Los valores múltiples del mismo filtro de etiquetas se combinan con la lógica OR.
Se utiliza
*para la coincidencia de caracteres comodín. Por ejemplo, hacepayment*coincidir los valores que comienzan por.payment!Utilízalo como prefijo para la negación. Por ejemplo, hace!productioncoincidir valores que no lo son.productionPuede incluir hasta 5 filtros de etiquetas, cada uno con un máximo de 5 valores.
En el siguiente ejemplo, se seleccionan todos los grupos de registros etiquetados conteam=team1 OR team=team2.
SOURCE logGroupTags([{"key":"team", "values":["team1", "team2"]}]) | fields @message, @timestamp
En el siguiente ejemplo, se seleccionan los grupos de registro en los que la service etiqueta empieza payment por y la environment etiqueta noproduction.
SOURCE logGroupTags([{"key":"service", "values":["payment*"]}, {"key":"environment", "values":["!production"]}]) | fields @message, @timestamp
El ejemplo siguiente combina el filtrado de etiquetas con un filtro de prefijos de nombres.
SOURCE logGroups(namePrefix: ['/aws/lambda']) logGroupTags([{"key":"environment", "values":["production"]}]) | fields @message, @timestamp
