As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Declarações de pipe
<a name="pipe-object-declarations"></a>

Usar o*Declarações de pipe*para conectar uma fonte (consulte[Declarações de origem](source-object-declarations.md)) para um lavatório (ver[Declarações de coletor](sink-object-declarations.md)) no Amazon Kinesis Agent para Microsoft Windows. Uma declaração de pipe é expressa como um objeto JSON. Depois que o Kinesis Agent para Windows é iniciado, os logs, os eventos ou as métricas são coletados da origem para um pipe. É feito streaming deles para vários serviços da AWS usando o coletor associado a esse pipe.

Veja a seguir um exemplo de declaração de pipe :

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

**Topics**
+ [Configuração de pipes](#kinesis-agent-pipe-configuration)
+ [Configuração do Kinesis Agent para Pipes Métricos do Windows](#kinesis-agent-metric-pipe-configuration)

## Configuração de pipes
<a name="kinesis-agent-pipe-configuration"></a>

Todas as declarações de pipe podem conter os seguintes pares de chave/valor:

`Id`  
Especifica o nome do pipe (obrigatório). Deve ser exclusivo no arquivo de configuração. 

`Type`  
Especifica o tipo de transformação (se houver) que é aplicada pelo pipe quando os dados de log são transferidos da origem para o coletor. O único valor suportado é `RegexFilterPipe`. Esse valor habilita a filtragem de expressões regulares da representação textual subjacente do registro de log. O uso da filtragem pode reduzir os custos de armazenamento e transmissão enviando somente os registros de log relevantes downstream para o pipeline de dados. Esse par de chave/valor é opcional. O valor padrão é não fornecer nenhuma transformação.

`FilterPattern`  
Especifica a expressão regular para pipelines `RegexFilterPipe` que são usados para filtrar os registros de log coletados pela origem antes de serem transferidos para o coletor. Os registros de log são transferidos por pipes do tipo `RegexFilterPipe` quando a expressão regular corresponde à representação textual subjacente do registro. Os registros de log estruturados que são gerados, por exemplo, ao usar o par de chave-valor `ExtractionPattern` em uma declaração `DirectorySource`, ainda podem ser filtrados usando o mecanismo `RegexFilterPipe`. Isso ocorre porque esse mecanismo opera na representação textual original antes da análise. Esse par de chave-valor é opcional, mas deverá ser fornecido se o pipe especificar o tipo `RegexFilterPipe`.  
Veja a seguir um exemplo de declaração de pipe `RegexFilterPipe`:  

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

`SourceRef`  
Especifica o nome (o valor do par de chave-valor `Id`) da declaração de origem que define a origem que está coletando dados de log, eventos e métricas para o pipe (obrigatório). 

`SinkRef`  
Especifica o nome (o valor do par de chave-valor `Id`) da declaração do coletor que define o coletor que está recebendo os dados de log, eventos e métricas para o pipe (obrigatório).

`IgnoreCase`  
Optional. Aceita valores de`true`ou`false`. Quando definido como`true`, o Regex corresponderá aos registros de forma insensível a maiúsculas e minúsculas.

`Negate`  
Optional. Aceita valores de`true`ou`false`. Quando definido como`true`, o pipe encaminhará os registros que*Não*A expressão regular.

Para obter um exemplo de um arquivo de configuração completo que usa o tipo de pipe `RegexFilterPipe`, consulte [Uso de pipes](configuring-kaw-examples.md#configuring-kaw-examples-pipes).

## Configuração do Kinesis Agent para Pipes Métricos do Windows
<a name="kinesis-agent-metric-pipe-configuration"></a>

Há uma origem de métrica integrada chamada`_KinesisTapMetricsSource`que produz métricas sobre o Kinesis Agent para Windows. Se houver um`CloudWatch`declaração de dissipador com um`Id`de`MyCloudWatchSink`O exemplo de declaração de pipeline a seguir transferirá o Kinesis Agent para as métricas geradas pelo Windows para esse coletor:

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

Para obter mais informações sobre a origem de métricas incorporadas do Kinesis Agent para Windows, consulte[Origem de métricas incorporadas do Kinesis Agent para Windows](source-object-declarations.md#kinesis-agent-builin-metrics-source).

Se o arquivo de configuração também fizer streaming das métricas de contador de desempenho do Windows, recomendamos que você use um pipe e um coletor separados em vez de usar o mesmo coletor para as métricas do Kinesis Agent para as métricas do Windows e as métricas de contador de desempenho do Windows.