As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
SOURCE
Incluir SOURCE em uma consulta é uma forma útil de especificar os grupos de registros a serem incluídos em uma consulta quando você estiver usando o AWS CLI ou API para criar uma consulta. O SOURCE comando é suportado somente no AWS CLI eAPI, não no CloudWatch console. Ao usar o CloudWatch console para iniciar uma consulta, você usa a interface do console para especificar os grupos de registros.
SOURCEPara especificar os grupos de registros a serem consultados, você pode usar as seguintes palavras-chave:
namePrefixexecuta a consulta em grupos de registros que têm nomes que começam com a string que você especifica. Se você omitir isso, todos os grupos de registros serão consultados.Você pode incluir até cinco prefixos na lista.
accountIdentifiersexecuta a consulta em grupos de registros na AWS conta especificada. Isso funciona somente quando você executa a consulta em uma conta de monitoramento. Se você omitir isso, o padrão é consultar todas as contas de origem vinculadas e a conta de monitoramento atual. Para obter mais informações sobre observabilidade entre contas, consulte observabilidade CloudWatch entre contas.Você pode incluir até 20 identificadores de conta na lista.
logGroupClassexecuta a consulta em grupos de registros que estão na classe de log especificada, seja Acesso Padrão ou Infrequente. Se você omitir isso, o padrão da classe de log padrão será usado. Para obter mais informações sobre classes de logs, consulte Classes de logs.
Como você pode especificar um grande número de grupos de registros para consulta dessa forma, recomendamos que você use SOURCE somente em consultas que aproveitem os índices de campo que você criou. Para obter mais informações sobre campos de indexação em grupos de registros, consulte Crie índices de campo para melhorar o desempenho da consulta e reduzir o volume de digitalização
O exemplo a seguir seleciona todos os grupos de registros na conta. Se for uma conta de monitoramento, os grupos de registros no monitoramento e em todas as contas de origem serão selecionados. Se o número total de grupos de registros exceder 10.000, você verá um erro solicitando que você reduza o número de grupos de registros usando um método diferente de seleção de grupos de registros.
SOURCE logGroups()
O exemplo a seguir seleciona os grupos de registros na conta 111122223333 de origem. Se você iniciar uma consulta em uma conta de monitoramento na observabilidade CloudWatch entre contas, os grupos de registros em todas as contas de origem e na conta de monitoramento serão selecionados por padrão.
SOURCE logGroups(accountIdentifiers:['111122223333'])
O próximo exemplo seleciona grupos de registros com base em prefixos de nome.
SOURCE logGroups(namePrefix: ['namePrefix1', 'namePrefix2'])
O exemplo a seguir seleciona todos os grupos de registros na classe de registro de Acesso infrequente. Se você não incluir o class identificador, a consulta se aplicará somente aos grupos de registros na classe de registro Padrão, que é o padrão.
SOURCE logGroups(class: ['INFREQUENT_ACCESS'])
O próximo exemplo seleciona grupos de registros na conta 111122223333 que começam com prefixos de nome específicos e estão na classe de registro Standard. A classe não é mencionada no comando porque Standard é o valor padrão da classe de log.
SOURCE logGroups(accountIdentifiers:['111122223333'], namePrefix: ['namePrefix1', 'namePrefix2']
O exemplo final mostra como usar o SOURCE comando com o 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"
