Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
SOURCE
Die Aufnahme SOURCE in eine Abfrage ist eine nützliche Methode, um die Protokollgruppen anzugeben, die in eine Abfrage aufgenommen werden sollen, wenn Sie die AWS CLI OR-API zum Erstellen einer Abfrage verwenden. Der SOURCE Befehl wird nur in der AWS CLI AND-API unterstützt, nicht in der CloudWatch Konsole. Wenn Sie die CloudWatch Konsole verwenden, um eine Abfrage zu starten, verwenden Sie die Konsolenschnittstelle, um die Protokollgruppen anzugeben.
Um die abzufragenden Protokollgruppen anzugeben, können Sie die folgenden Schlüsselwörter verwenden: SOURCE
namePrefixführt die Abfrage für Protokollgruppen aus, deren Namen mit der von Ihnen angegebenen Zeichenfolge beginnen. Wenn Sie dies weglassen, werden alle Protokollgruppen abgefragt.Sie können bis zu fünf Präfixe in die Liste aufnehmen.
accountIdentifiersführt die Abfrage für Protokollgruppen im angegebenen AWS Konto aus. Dies funktioniert nur, wenn Sie die Abfrage in einem Überwachungskonto ausführen. Wenn Sie dies weglassen, werden standardmäßig alle verknüpften Quellkonten und das aktuelle Überwachungskonto abgefragt. Weitere Informationen zur kontenübergreifenden Beobachtbarkeit finden Sie unter kontenübergreifende CloudWatch Beobachtbarkeit.Sie können bis zu 20 Konto-Identifikatoren in die Liste aufnehmen.
logGroupClassführt die Abfrage anhand von Protokollgruppen aus, die sich in der angegebenen Protokollklasse (Standard oder Infrequent Access) befinden. Wenn Sie dies weglassen, wird die Standardprotokollklasse verwendet. Weitere Hinweise zu Protokollklassen finden Sie unterKlassen protokollieren.
Da Sie eine große Anzahl von Protokollgruppen angeben können, die auf diese Weise abgefragt werden sollen, empfehlen wir, diese SOURCE nur in Abfragen zu verwenden, die von Ihnen erstellte Feldindizes nutzen. Weitere Informationen zur Indizierung von Feldern in Protokollgruppen finden Sie unter Erstellen Sie Feldindizes, um die Abfrageleistung zu verbessern und das Scanvolumen zu reduzieren
Im folgenden Beispiel werden alle Protokollgruppen im Konto ausgewählt. Wenn es sich um ein Überwachungskonto handelt, werden die Protokollgruppen für alle Überwachungs- und alle Quellkonten ausgewählt. Wenn die Gesamtzahl der Protokollgruppen 10.000 überschreitet, wird eine Fehlermeldung angezeigt, in der Sie aufgefordert werden, die Anzahl der Protokollgruppen mithilfe einer anderen Methode zur Auswahl der Protokollgruppen zu reduzieren.
SOURCE logGroups()
Im folgenden Beispiel werden die Protokollgruppen im 111122223333 Quellkonto ausgewählt. Wenn Sie eine Abfrage in einem Überwachungskonto mit CloudWatch kontenübergreifender Observability starten, werden standardmäßig Protokollgruppen in allen Quellkonten und im Überwachungskonto ausgewählt.
SOURCE logGroups(accountIdentifiers:['111122223333'])
Im nächsten Beispiel werden Protokollgruppen anhand von Namenspräfixen ausgewählt.
SOURCE logGroups(namePrefix: ['namePrefix1', 'namePrefix2'])
Im folgenden Beispiel werden alle Protokollgruppen in der Protokollklasse für seltenen Zugriff ausgewählt. Wenn Sie den class Bezeichner nicht angeben, gilt die Abfrage nur für Protokollgruppen in der Standard-Protokollklasse, was die Standardprotokollklasse ist.
SOURCE logGroups(class: ['INFREQUENT_ACCESS'])
Im nächsten Beispiel werden Protokollgruppen im Konto 111122223333 ausgewählt, die mit bestimmten Namenspräfixen beginnen und zur Standard-Protokollklasse gehören. Die Klasse wird im Befehl nicht erwähnt, da Standard der Standardwert für die Protokollklasse ist.
SOURCE logGroups(accountIdentifiers:['111122223333'], namePrefix: ['namePrefix1', 'namePrefix2']
Das letzte Beispiel zeigt, wie der SOURCE Befehl zusammen mit dem start-query AWS CLI Befehl verwendet wird.
aws logs start-query --region us-east-1 --start-time 1729728200 --end-time 1729728215 --query-string "SOURCE logGroups(namePrefix: ['Query']) | fields @message | limit 5"
