Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Declaraciones de canalizaciones
Usar*Declaraciones canalizaciones*para conectar una fuente (consulte[Declaraciones de origen](source-object-declarations.md)) a un fregadero (ver[Declaraciones de receptores](sink-object-declarations.md)) en Amazon Kinesis Agent para Microsoft Windows. Las declaraciones de canalizaciones se expresan como un objeto JSON. Una vez que se inicia Kinesis Agent para Windows, comienzan a recopilarse los registros, los eventos o las métricas del origen de una determinada canalización. Estos datos se transmiten a diversos servicios de AWS utilizando el receptor asociado a dicha canalización.
A continuación, se muestra un ejemplo de una declaración de canalización :
```
{
"Id": "MyAppLogToCloudWatchLogs",
"SourceRef": "MyAppLog",
"SinkRef": "MyCloudWatchLogsSink"
}
```
**Topics**
+ [Configuración de canalizaciones](#kinesis-agent-pipe-configuration)
+ [Configuración del agente Kinesis para tuberías métricas de Windows](#kinesis-agent-metric-pipe-configuration)
## Configuración de canalizaciones
Todas las declaraciones de canalizaciones pueden contener los siguientes pares clave-valor:
`Id`
Especifica el nombre de la canalización (obligatorio). Debe ser único en el archivo de configuración.
`Type`
Especifica el tipo de transformación (si procede) que la canalización aplica cuando los datos de registro se transfieren del origen al receptor. El único valor admitido es `RegexFilterPipe`. Este valor permite que la representación textual subyacente de la entrada del registro pueda filtrarse con expresiones regulares. El filtrado puede reducir los costos de transmisión y almacenamiento al enviar exclusivamente las entradas de registro pertinentes a fases posteriores de la canalización de datos. Este par clave-valor es opcional. El valor predeterminado no proporciona ninguna transformación.
`FilterPattern`
Especifica la expresión regular de las canalizaciones `RegexFilterPipe` que se utiliza para filtrar las entradas de registro recopiladas por el origen antes de transferirlas al receptor. Las canalizaciones de tipo `RegexFilterPipe` transmiten las entradas de registro cuando la expresión regular encuentra coincidencias con la representación textual subyacente del registro. Las entradas de registro estructuradas que se generan (por ejemplo, cuando se utiliza el par clave-valor `ExtractionPattern` en una declaración `DirectorySource`) se pueden filtrar con el mecanismo `RegexFilterPipe`, ya que este mecanismo trabaja con la representación textual original antes de que se aplique ninguna conversión. Este par clave-valor es opcional, pero debe proporcionarse si la canalización especifica el tipo `RegexFilterPipe`.
A continuación, se muestra un ejemplo de una declaración de canalización `RegexFilterPipe`:
```
{
"Id": "MyAppLog2ToFirehose",
"Type": "RegexFilterPipe",
"SourceRef": "MyAppLog2",
"SinkRef": "MyFirehose",
"FilterPattern": "^(10|11),.*",
"IgnoreCase": false,
"Negate": false
}
```
`SourceRef`
Especifica el nombre (el valor del par clave-valor `Id`) de la declaración de origen que define el origen que recopila los datos de registro, eventos y métricas de la canalización (obligatorio).
`SinkRef`
Especifica el nombre (el valor del par clave-valor `Id`) de la declaración del receptor que define el receptor que recibe los datos de registro, eventos y métricas de la canalización (obligatorio).
`IgnoreCase`
Opcional. Acepta valores de`true`or`false`. Cuando se establece en`true`, la Regex coincidirá con los registros sin distinción entre mayúsculas y minúsculas.
`Negate`
Opcional. Acepta valores de`true`or`false`. Cuando se establece en`true`, la tubería reenviará los registros que*No lo haga*Coinciden con la expresión regular.
Para ver un ejemplo de un archivo de configuración completo que utiliza el tipo de canalización `RegexFilterPipe`, consulte [Uso de canalizaciones](configuring-kaw-examples.md#configuring-kaw-examples-pipes).
## Configuración del agente Kinesis para tuberías métricas de Windows
Hay un origen de métricas integrado llamado`_KinesisTapMetricsSource`que produce métricas sobre Kinesis Agent para Windows. Si hay un`CloudWatch`declaración de sumidero con una`Id`de`MyCloudWatchSink`La siguiente declaración de canalización de ejemplo transfiere las métricas generadas en en en Kinesis Agent para Windows a ese receptor:
```
{
"Id": "KinesisAgentMetricsToCloudWatch",
"SourceRef": "_KinesisTapMetricsSource",
"SinkRef": "MyCloudWatchSink"
}
```
Para obtener más información sobre el origen de métricas integrado en Kinesis Agent para Windows, consulte[Origen de métricas integrado en Windows en](source-object-declarations.md#kinesis-agent-builin-metrics-source).
Si el archivo de configuración también transmite métricas de los contadores de rendimiento de Windows, le recomendamos que utilice una canalización y un receptor diferentes en lugar de utilizar el mismo receptor para las métricas de Kinesis Agent para Windows y las métricas de los contadores de rendimiento de Windows.