Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Dichiarazioni delle pipe
Utilizza*Dichiarazioni delle pipe*per connettere una sorgente (vedere[Dichiarazioni delle origini](source-object-declarations.md)) a un lavandino (vedi[Dichiarazioni dei sink](sink-object-declarations.md)) nell'agente Amazon Kinesis per Microsoft Windows. Una dichiarazione della pipe viene espressa come un oggetto JSON. Una volta avviato l'agente Kinesis per Windows, i log, gli eventi o i parametri vengono raccolti dall'origine per una determinata pipe. Vengono quindi trasmessi a diversi servizi AWS utilizzando il sink associato a tale pipe.
Di seguito è riportato un esempio della dichiarazione di una pipe :
```
{
"Id": "MyAppLogToCloudWatchLogs",
"SourceRef": "MyAppLog",
"SinkRef": "MyCloudWatchLogsSink"
}
```
**Topics**
+ [Configurazione di pipe](#kinesis-agent-pipe-configuration)
+ [Configurazione dell'agente Kinesis per le pipe metriche di Windows](#kinesis-agent-metric-pipe-configuration)
## Configurazione di pipe
Tutte le dichiarazioni di pipe possono contenere le seguenti coppie chiave-valore:
`Id`
Specifica il nome della pipe (obbligatorio). Deve essere univoco all'interno del file di configurazione.
`Type`
Specifica il tipo di trasformazione (se presente) che viene applicata dalla pipe quando i dati dei log vengono trasferiti dall'origine al sink. L'unico valore supportato è `RegexFilterPipe`. Questo valore consente il filtraggio regolare di espressioni della sottostante rappresentazione testuale del record di log. L'utilizzo del filtraggio può ridurre i costi di trasmissione e di storage inviando solo alla pipeline di dati il downstream di record di log pertinenti. Questa coppia chiave-valore è facoltativa. Il valore di default è di non fornire alcuna trasformazione.
`FilterPattern`
Specifica l'espressione regolare per le pipeline `RegexFilterPipe` che consentono di filtrare record di log raccolti dall'origine prima di essere trasferite al sink. I record dei log vengono trasferiti dalle pipe di tipo `RegexFilterPipe` quando l'espressione regolare corrisponde alla rappresentazione testuale sottostante del record. Record di log strutturati, generati, ad esempio, quando si utilizza la coppia chiave-valore `ExtractionPattern` in una dichiarazione `DirectorySource` possono comunque essere filtrati tramite il meccanismo `RegexFilterPipe`. Questo perché questo meccanismo agisce sulla rappresentazione testuale originale prima di eseguire l'analisi. Questa coppia chiave-valore è facoltativa, ma deve essere fornita se la pipe specifica il tipo `RegexFilterPipe`.
Di seguito è riportato un esempio della dichiarazione di una pipe `RegexFilterPipe`:
```
{
"Id": "MyAppLog2ToFirehose",
"Type": "RegexFilterPipe",
"SourceRef": "MyAppLog2",
"SinkRef": "MyFirehose",
"FilterPattern": "^(10|11),.*",
"IgnoreCase": false,
"Negate": false
}
```
`SourceRef`
Specifica il nome (il valore della coppia chiave-valore `Id`) della dichiarazione di definizione dell'origine che raccoglie dati di log, eventi e parametri per la pipe (obbligatorio).
`SinkRef`
Specifica il nome (il valore della coppia chiave-valore `Id`) della dichiarazione di definizione del sink che raccoglie dati di log, eventi e parametri per la pipe (obbligatorio).
`IgnoreCase`
Facoltativo. Accetta valori di`true`o`false`: . Se impostato su`true`, Regex corrisponderà ai record in modo senza distinzione tra maiuscole e minuscole.
`Negate`
Facoltativo. Accetta valori di`true`o`false`: . Se impostato su`true`, la pipe inoltrerà i record che*NON FARE*Corrispondono all'espressione regolare.
Per un esempio di un file di configurazione completo che usa il tipo di pipe `RegexFilterPipe`, consulta [Utilizzo di pipe](configuring-kaw-examples.md#configuring-kaw-examples-pipes).
## Configurazione dell'agente Kinesis per le pipe metriche di Windows
Vi è una sorgente di metrica integrata denominata`_KinesisTapMetricsSource`che produce metriche sull'agente Kinesis per Windows. Se è presente un`CloudWatch`dichiarazione sink con un`Id`di`MyCloudWatchSink`La seguente dichiarazione di pipeline di Kinesis isce i parametri generati da da Windows a tale sink:
```
{
"Id": "KinesisAgentMetricsToCloudWatch",
"SourceRef": "_KinesisTapMetricsSource",
"SinkRef": "MyCloudWatchSink"
}
```
Per ulteriori informazioni sull'origine dei parametri integrati di Kinesis Agent per Windows, consulta[Origine dei parametri integrati di Kinesis Agent per Windows](source-object-declarations.md#kinesis-agent-builin-metrics-source): .
Se il file di configurazione invia anche i parametri contatori delle prestazioni, si consiglia di utilizzare una pipe e un sink separati anziché utilizzare lo stesso sink sia Kinesis parametri sia per i parametri contatori delle prestazioni di Windows.