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
Incluso SOURCE in una query è un modo utile per specificare i gruppi di log and/or origini dati da includere in una query quando si utilizza AWS CLI o API per creare una query. Il SOURCE il comando è supportato solo in AWS CLI e API, non in CloudWatch console. Quando si utilizza il CloudWatch console per avviare una query, si utilizza l'interfaccia della console per specificare i gruppi di log.
Gruppi di log delle interrogazioni
Da usare SOURCE per specificare i gruppi di log da interrogare, è possibile utilizzare le seguenti parole chiave:
-
namePrefixesegue la query sui gruppi di log i cui nomi iniziano con la stringa specificata. Se si omette questa opzione, vengono interrogati tutti i gruppi di log.È possibile includere fino a 5 prefissi nell'elenco.
-
accountIdentifieresegue la query sui gruppi di log specificati AWS account. Funziona solo quando si esegue la query in un account di monitoraggio. Se si omette questa opzione, per impostazione predefinita viene eseguita una query su tutti gli account di origine collegati e sull'account di monitoraggio corrente. Per ulteriori informazioni sull'osservabilità tra più account, vedi CloudWatch osservabilità tra più account.Puoi includere fino a 20 identificativi di account nell'elenco.
-
logGroupClassesegue la query sui gruppi di log che si trovano nella classe di registro specificata, Standard o Essentials (in precedenza chiamata Infrequent Access). Se si omette questa impostazione, viene utilizzata la classe di log predefinita Standard. Per ulteriori informazioni sulle classi di log, vedere Classi di registro.
Poiché è possibile specificare un numero elevato di gruppi di log da interrogare in questo modo, si consiglia di utilizzare SOURCE solo nelle interrogazioni che utilizzano 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 il 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 in 111122223333 account di origine. Se avvii una query in un account di monitoraggio in CloudWatch l'osservabilità tra più account, i gruppi di log in tutti gli account di origine e nell'account di monitoraggio sono selezionati per impostazione predefinita.
SOURCE logGroups(accountIdentifier:['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 Essentials (in precedenza Infrequent Access). Se non includi class identificatore, la query si applica solo ai gruppi di log nella classe di log Standard, che è l'impostazione predefinita.
SOURCE logGroups(class: ['ESSENTIALS'])
L'esempio successivo seleziona i gruppi di log nell'account 111122223333 che iniziano con prefissi di nome specifici e si trovano nella classe di log Standard. La classe non è menzionata nel comando perché Standard è il valore predefinito della classe di log.
SOURCE logGroups(accountIdentifier:['111122223333'], namePrefix: ['namePrefix1', 'namePrefix2'])
L'ultimo esempio mostra come usare SOURCE comando con 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"
Fonti di dati di interrogazione
Da usare SOURCE per specificare le origini dati da interrogare, è possibile utilizzare dataSource parola chiave. È possibile includere fino a dieci origini dati nell'elenco.
L'esempio seguente seleziona amazon_vpc.flow origine dati.
SOURCE dataSource(['amazon_vpc.flow'])
L'esempio seguente seleziona amazon_vpc.flow origine dati e limita i gruppi di log in base al prefisso del nome del gruppo di log.
SOURCE dataSource(['amazon_vpc.flow']) logGroups(namePrefix: ['namePrefix1'])
I log delle query si raggruppano per tag
Da usare SOURCE per filtrare i gruppi di log in base ai relativi tag, usa logGroupTags funzione. Specifica i tag come elenco di filtri di tag, ciascuno con un key e facoltativo values matrice.
I filtri di tag multipli con chiavi diverse vengono combinati con la logica AND.
Più valori all'interno dello stesso filtro di tag vengono combinati con la logica OR.
Usa
*per abbinare i jolly. Ad esempio,payment*corrisponde a valori che iniziano conpayment.Uso
!come prefisso per la negazione. Ad esempio!productioncorrisponde a valori che non lo sonoproduction.Puoi includere fino a 5 filtri di tag, ciascuno con un massimo di 5 valori.
L'esempio seguente seleziona tutti i gruppi di log contrassegnati con team=team1 OR team=team2.
SOURCE logGroupTags([{"key":"team", "values":["team1", "team2"]}]) | fields @message, @timestamp
L'esempio successivo seleziona i gruppi di log in cui service il tag inizia con paymente il environment il tag non è production.
SOURCE logGroupTags([{"key":"service", "values":["payment*"]}, {"key":"environment", "values":["!production"]}]) | fields @message, @timestamp
L'esempio seguente combina il filtro dei tag con un filtro con prefisso del nome.
SOURCE logGroups(namePrefix: ['/aws/lambda']) logGroupTags([{"key":"environment", "values":["production"]}]) | fields @message, @timestamp