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
Usar oDeclarações de pipepara conectar uma fonte (consulteDeclarações de origem) para um lavatório (verDeclarações de coletor) 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"
}Configuração de pipes
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
RegexFilterPipeque 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 tipoRegexFilterPipequando 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-valorExtractionPatternem uma declaraçãoDirectorySource, ainda podem ser filtrados usando o mecanismoRegexFilterPipe. 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 tipoRegexFilterPipe.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). IgnoreCaseOptional. Aceita valores de
trueoufalse. Quando definido comotrue, o Regex corresponderá aos registros de forma insensível a maiúsculas e minúsculas.NegateOptional. Aceita valores de
trueoufalse. Quando definido comotrue, o pipe encaminhará os registros queNãoA 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.
Configuração do Kinesis Agent para Pipes Métricos do Windows
Há uma origem de métrica integrada chamada_KinesisTapMetricsSourceque produz métricas sobre o Kinesis Agent para Windows. Se houver umCloudWatchdeclaração de dissipador com umIddeMyCloudWatchSinkO 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, consulteOrigem de métricas incorporadas do Kinesis Agent para Windows.
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.
