Declaraciones de canalizaciones

UsarDeclaraciones canalizacionespara conectar una fuente (consulteDeclaraciones de origen) a un fregadero (verDeclaraciones de receptores) 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" 
}

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 detrueorfalse. Cuando se establece entrue, la Regex coincidirá con los registros sin distinción entre mayúsculas y minúsculas.

Negate

Opcional. Acepta valores detrueorfalse. Cuando se establece entrue, la tubería reenviará los registros queNo lo hagaCoinciden 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.

Configuración del agente Kinesis para tuberías métricas de Windows

Hay un origen de métricas integrado llamado_KinesisTapMetricsSourceque produce métricas sobre Kinesis Agent para Windows. Si hay unCloudWatchdeclaración de sumidero con unaIddeMyCloudWatchSinkLa 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, consulteOrigen de métricas integrado en Windows en.

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.