Pipe-Deklarationen - Amazon Kinesis Agent für Microsoft Windows

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.

Pipe-Deklarationen

Verwenden vonPipe-Deklarationen, um eine Quelle zu verbinden (sieheQuell-Deklarationen) zu einer Spüle (sieheSenken-Deklarationen) in Amazon Kinesis Agent für Microsoft Windows. Eine Pipe-Deklaration wird als JSON-Objekt ausgedrückt. Nachdem Kinesis Agent für Windows gestartet wurde, werden die Protokolle, Ereignisse oder Metriken für eine bestimmte Pipe aus der Quelle erfasst. Sie werden dann unter Verwendung der Senke, die dieser Pipe zugeordnet ist, an verschiedene AWS-Services gestreamt.

Es folgt ein Beispiel für die Pipe-Deklaration :

{ "Id": "MyAppLogToCloudWatchLogs", "SourceRef": "MyAppLog", "SinkRef": "MyCloudWatchLogsSink" }

Konfigurieren von Pipes

Alle Pipe-Deklarationen können die folgenden Schlüssel-Wert-Paare enthalten:

Id

Gibt den Namen der Pipe an (erforderlich). Er muss innerhalb der Konfigurationsdatei eindeutig sein.

Type

Gibt an, welche Art von Transformation (sofern zutreffend) durch die Pipe angewendet wird, während Protokolldaten von der Quelle an die Senke übertragen werden. Der einzige unterstützte Wert ist RegexFilterPipe. Dieser Wert ermöglicht das Filtern regulärer Ausdrücke der zugrunde liegenden Textdarstellung des Protokolldatensatzes. Durch Filtern lassen sich Übertragungs- und Speicherkosten reduzieren, indem nur relevante Protokolldatensätze zur Downstream-Daten-Pipeline gesendet werden. Dieses Schlüssel-Wert-Paar ist optional. Der Standardwert ist, keine Transformation durchzuführen.

FilterPattern

Gibt den regulären Ausdruck für RegexFilterPipe-Pipelines an, der zum Filtern der aus der Quelle erfassten Protokolldatensätze verwendet wird, bevor sie an die Senke übertragen werden. Protokolldatensätze werden von Pipes vom Typ RegexFilterPipe übertragen, wenn der reguläre Ausdruck mit der zugrunde liegenden Textdarstellung des Datensatzes übereinstimmt. Strukturierte Protokolldatensätze, die erstellt werden, z. B. bei der Verwendung des ExtractionPattern-Schlüssel-Wert-Paares in einer DirectorySource-Deklaration, können weiterhin mit dem RegexFilterPipe-Mechanismus gefiltert werden. Dies liegt daran, da dieser Mechanismus vor der Analyse mit der ursprünglichen Textdarstellung funktioniert hat. Dieses Schlüssel-Wert-Paar ist optional, muss aber angegeben werden, wenn die Pipe als Typ RegexFilterPipe angibt.

Es folgt ein Beispiel für die Pipe-Deklaration RegexFilterPipe:

{ "Id": "MyAppLog2ToFirehose", "Type": "RegexFilterPipe", "SourceRef": "MyAppLog2", "SinkRef": "MyFirehose", "FilterPattern": "^(10|11),.*", "IgnoreCase": false, "Negate": false }
SourceRef

Gibt den Namen (den Wert des Id-Schlüssel-Wert-Paares) der Quell-Deklaration an, die die Quelle definiert, mit der Protokoll-, Ereignis- und Metrikdaten für die Pipe gesammelt werden (erforderlich).

SinkRef

Gibt den Namen (den Wert des Id-Schlüssel-Wert-Paares) der Senken-Deklaration an, die die Senke definiert, von der die Protokoll-, Ereignis- und Metrikdaten für die Pipe empfangen werden (erforderlich).

IgnoreCase

Optional. Akzeptiert Werte vontrueoder .false. Wenn auftrue, wird die Regex Datensätze in der Groß- und Kleinschreibung nicht berücksichtigt.

Negate

Optional. Akzeptiert Werte vontrueoder .false. Wenn auftrue, leitet die Pipe die Datensätze weiter, dieer/dieSie entsprechen dem regulären Ausdruck.

Ein Beispiel für eine vollständige Konfigurationsdatei, die den Pipe-Typ RegexFilterPipe verwendet, finden Sie unter Verwenden von Pipes.

Konfigurieren von Kinesis Agent für Windows-Metrik-Pipes

Es ist eine integrierte Metrikquelle mit dem Namen vorhanden_KinesisTapMetricsSource, die Metriken über Kinesis Agent für Windows erstellt. Wenn es eineCloudWatchWaschbecken Deklaration mit einemIdvonMyCloudWatchSinkNachdem die folgende Pipeline-Beispieldeklaration den Kinesis Agent für Windows-erstellten Metriken an die jeweilige Senke:

{ "Id": "KinesisAgentMetricsToCloudWatch", "SourceRef": "_KinesisTapMetricsSource", "SinkRef": "MyCloudWatchSink" }

Weitere Informationen zu den integrierten -Metrikquellen von Kinesis Agent für Windows finden Sie unterIntegrierte Quelle von Kinesis Agent für Windows -Metriken: Quelle.

Wenn die Konfigurationsdatei zudem auch Windows-Leistungsindikator-Metriken streamt, empfehlen wir, dass Sie eine separate Pipe und Senke verwenden, anstatt dieselbe Senke sowohl für -Metriken für Windows-Metriken als auch Windows-Leistungsindikator-Metriken zu nutzen.