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 von*Pipe-Deklarationen*, um eine Quelle zu verbinden (siehe[Quell-Deklarationen](source-object-declarations.md)) zu einer Spüle (siehe[Senken-Deklarationen](sink-object-declarations.md)) 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"
}
```
**Topics**
+ [Konfigurieren von Pipes](#kinesis-agent-pipe-configuration)
+ [Konfigurieren von Kinesis Agent für Windows-Metrik-Pipes](#kinesis-agent-metric-pipe-configuration)
## 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 von`true`oder .`false`. Wenn auf`true`, wird die Regex Datensätze in der Groß- und Kleinschreibung nicht berücksichtigt.
`Negate`
Optional. Akzeptiert Werte von`true`oder .`false`. Wenn auf`true`, leitet die Pipe die Datensätze weiter, die*er/die*Sie 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](configuring-kaw-examples.md#configuring-kaw-examples-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 eine`CloudWatch`Waschbecken Deklaration mit einem`Id`von`MyCloudWatchSink`Nachdem 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 unter[Integrierte Quelle von Kinesis Agent für Windows -Metriken: Quelle](source-object-declarations.md#kinesis-agent-builin-metrics-source).
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.