Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
SOURCE
L'inclusione SOURCE in una query è un modo utile per specificare i gruppi di log da includere in una query quando si utilizza l'API AWS CLI o per creare una query. Il SOURCE comando è supportato solo nell'API AWS CLI and, non nella CloudWatch console. Quando si utilizza la CloudWatch console per avviare una query, si utilizza l'interfaccia della console per specificare i gruppi di log.
SOURCEPer specificare i gruppi di log da interrogare, è possibile utilizzare le seguenti parole chiave:
-
namePrefixesegue la query su gruppi di log i cui nomi iniziano con la stringa specificata. Se si omette questa opzione, viene eseguita una query su tutti i gruppi di log.È possibile includere fino a cinque prefissi nell'elenco.
-
accountIdentifiersesegue la query sui gruppi di log nell'account specificato AWS . Funziona solo quando si esegue la query in un account di monitoraggio. Se si omette questa opzione, l'impostazione predefinita prevede l'interrogazione di tutti gli account di origine collegati e dell'account di monitoraggio corrente. Per ulteriori informazioni sull'osservabilità tra account, consulta CloudWatch osservabilità tra account.Puoi includere fino a 20 identificatori di account nell'elenco.
-
logGroupClassesegue la query sui gruppi di log che si trovano nella classe di log specificata, Standard o Infrequent Access. Se si omette questa impostazione, viene utilizzata l'impostazione predefinita della classe di registro Standard. Per ulteriori informazioni sulle classi di log, vedereClassi di registro.
Poiché è possibile specificare un numero elevato di gruppi di log su cui eseguire query in questo modo, si consiglia di utilizzarli SOURCE solo nelle query che sfruttano gli indici di campo creati dall'utente. Per ulteriori informazioni sull'indicizzazione dei campi nei gruppi di log, vedere Crea indici di campo per migliorare le prestazioni delle query e ridurre il volume di scansione
L'esempio seguente seleziona tutti i gruppi di log dell'account. Se si tratta di un account di monitoraggio, verranno selezionati i gruppi di log tra gli account di monitoraggio e tutti gli account di origine. Se il numero totale di gruppi di log supera 10.000, verrà visualizzato un errore che richiede di ridurre il numero di gruppi di log utilizzando un metodo di selezione dei gruppi di log diverso.
SOURCE logGroups()
L'esempio seguente seleziona i gruppi di log nell'account di 111122223333 origine. Se si avvia una query in un account di monitoraggio in modalità osservabilità CloudWatch tra account, per impostazione predefinita vengono selezionati i gruppi di log in tutti gli account di origine e nell'account di monitoraggio.
SOURCE logGroups(accountIdentifiers:['111122223333'])
L'esempio successivo seleziona i gruppi di log in base ai prefissi dei nomi.
SOURCE logGroups(namePrefix: ['namePrefix1', 'namePrefix2'])
L'esempio seguente seleziona tutti i gruppi di log nella classe di log Infrequent Access. Se non si include l'classidentificatore, la query si applica solo ai gruppi di log della classe di log Standard, che è l'impostazione predefinita.
SOURCE logGroups(class: ['INFREQUENT_ACCESS'])
L'esempio successivo seleziona i gruppi di log nell'account 111122223333 che iniziano con prefissi di nome specifici e appartengono alla classe di log Standard. La classe non è menzionata nel comando perché Standard è il valore predefinito della classe di log.
SOURCE logGroups(accountIdentifiers:['111122223333'], namePrefix: ['namePrefix1', 'namePrefix2']
L'ultimo esempio mostra come utilizzare il SOURCE comando con il 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"
