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à.

# Plugin e opzioni supportati per le pipeline di Amazon OpenSearch Ingestion
<a name="pipeline-config-reference"></a>

[Amazon OpenSearch Ingestion supporta un sottoinsieme di sorgenti, processori e sink all'interno di Data Prepper open source. OpenSearch ](https://opensearch.org/docs/latest/data-prepper/) Inoltre, OpenSearch Ingestion impone alcuni vincoli alle opzioni disponibili per ogni plug-in supportato. Le sezioni seguenti descrivono i plugin e le opzioni associate supportati da Ingestion. OpenSearch 

**Nota**  
OpenSearch Ingestion non supporta alcun plugin buffer perché configura automaticamente un buffer predefinito. Si riceve un errore di convalida se si include un buffer nella configurazione della pipeline.

**Topics**
+ [Plugin supportati](#ingestion-plugins)
+ [Processori stateless e processori stateful](#processor-stateful-stateless)
+ [Requisiti e vincoli di configurazione](#ingestion-parameters)

## Plugin supportati
<a name="ingestion-plugins"></a>

OpenSearch Ingestion supporta i seguenti plugin Data Prepper:

**Fonti:**
+ [DocumentDB](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/documentdb/)
+ [DynamoDB](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/dynamo-db/)
+ [HTTP](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/http-source/)
+ [Kafka](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/kafka/)
+ [Kinesis](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/kinesis/)
+ [OpenSearch](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/opensearch/)
+ [OTel logs](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-logs-source/)
+ [OTel metriche](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-metrics-source/)
+ [OTel traccia](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-trace/)
+ [S3](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/s3/)

**Processori**:
+ [Aggiungere voci](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/add-entries/)
+ [Aggregazione](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aggregate/)
+ [Rilevatore di anomalie](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/anomaly-detector/)
+ [AWS Lambda](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aws-lambda/)
+ [Convertire il tipo di ingresso](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/convert-entry-type/)
+ [Copia i valori](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/copy-values/)
+ [CSV](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/csv/)
+ [Data](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/date/)
+ [Ritardo](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/delay/)
+ [Decomprimere](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/decompress/)
+ [Eliminare le voci](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/delete-entries/)
+ [Sezionare](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/dissect/)
+ [Elimina gli eventi](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/drop-events/)
+ [Appiattire](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/flatten/)
+ [IP geografico](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/geoip/)
+ [Grok](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/grok/)
+ [Valore chiave](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/key-value/)
+ [Elenco da mappare](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/list-to-map/)
+ [Stringa minuscola](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/lowercase-string/)
+ [Mappa da elencare](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/map-to-list/)
+ [Evento di mutazione](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/mutate-event/) (serie di processori)
+ Stringa [mutata (serie](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/mutate-string/) di processori)
+ [Offuscare](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/obfuscate/)
+ [OTel metriche](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/otel-metrics/)
+ [OTel gruppo di tracciamento](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/otel-trace-group/)
+ [OTel traccia](https://docs.opensearch.org/latest/data-prepper/common-use-cases/trace-analytics/)
+ [Analizza Ion](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/parse-ion/)
+ [Analizza JSON](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/parse-json/)
+ [Analizza XML](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/parse-xml/)
+ [Rinomina le chiavi](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/rename-keys/)
+ [Seleziona le voci](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/select-entries/)
+ [Mappa servizio](https://docs.opensearch.org/latest/data-prepper/common-use-cases/trace-analytics/)
+ [Evento diviso](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/split-event/)
+ [Stringa divisa](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/split-string/)
+ [convertitore di stringhe](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/string-converter/)
+ [Stringa sostitutiva](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/substitute-string/)
+ [Trace peer forwarder](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/trace-peer-forwarder/)
+ [Translate](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/translate/) (Trasla)
+ [Taglia la corda](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/trim-string/)
+ [Troncare](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/truncate/)
+ [Stringa maiuscola](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/uppercase-string/)
+ [Agente utente](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/user-agent/)
+ [Scrivi JSON](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/write-json/)

**Lavelli:**
+ [OpenSearch](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/opensearch/)(supporta OpenSearch Service, OpenSearch Serverless ed Elasticsearch 6.8 o versioni successive)
+ [S3](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/s3/)

**Codec** Sink:
+ [Avro](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/s3/#avro-codec)
+ [NDJSON](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/s3/#ndjson-codec)
+ [JSON](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/s3/#json-codec)
+ [Parquet](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/s3/#parquet-codec)

## Processori stateless e processori stateful
<a name="processor-stateful-stateless"></a>

I processori *stateless* eseguono operazioni come trasformazioni e filtri, mentre i processori *stateful* eseguono operazioni come le aggregazioni, che ricordano il risultato dell'esecuzione precedente. OpenSearch [https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aggregate/](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aggregate/) Tutti gli altri processori supportati sono stateless.

Per le pipeline che contengono solo processori stateless, il limite di capacità massima è 96 Ingestion. OCUs Se una pipeline contiene processori con stato, il limite di capacità massima è 48 Ingestion. OCUs Tuttavia, se una pipeline ha il [buffering persistente](osis-features-overview.md#persistent-buffering) abilitato, può avere un massimo di 384 Ingestion OCUs con solo processori stateless o 192 Ingestion se contiene processori con stato. OCUs Per ulteriori informazioni, consulta [Scalabilità delle pipeline in Amazon Ingestion OpenSearch](ingestion-scaling.md).

End-to-end il riconoscimento è supportato solo per i processori stateless. Per ulteriori informazioni, consulta [End-to-end riconoscimento](osis-features-overview.md#osis-features-e2e).

## Requisiti e vincoli di configurazione
<a name="ingestion-parameters"></a>

Se non diversamente specificato di seguito, tutte le opzioni descritte nel riferimento alla configurazione di Data Prepper per i plugin supportati sopra elencati sono consentite nelle pipeline di Ingestion. OpenSearch Le sezioni seguenti spiegano i vincoli che Ingestion impone a determinate opzioni del plug-in. OpenSearch 

**Nota**  
OpenSearch Ingestion non supporta alcun plugin buffer perché configura automaticamente un buffer predefinito. Si riceve un errore di convalida se si include un buffer nella configurazione della pipeline.

Molte opzioni sono configurate e gestite internamente da OpenSearch Ingestion, come e. `authentication` `acm_certificate_arn` Altre opzioni, come `thread_count` e`request_timeout`, hanno un impatto sulle prestazioni se modificate manualmente. Pertanto, questi valori sono impostati internamente per garantire prestazioni ottimali delle pipeline.

Infine, alcune opzioni non possono essere passate a OpenSearch Ingestion, ad esempio `ism_policy_file` and`sink_template`, perché sono file locali se eseguite in Data Prepper open source. Questi valori non sono supportati.

**Topics**
+ [Opzioni generali della pipeline](#ingestion-params-general)
+ [Processore Grok](#ingestion-params-grok)
+ [Origine HTTP](#ingestion-params-http)
+ [OpenSearch lavandino](#ingestion-params-opensearch)
+ [OTel metrics source, OTel trace source e logs source OTel](#ingestion-params-otel-source)
+ [OTel processore trace group](#ingestion-params-otel-trace)
+ [OTel processore di traccia](#ingestion-params-otel-raw)
+ [Processore Service-map](#ingestion-params-servicemap)
+ [Fonte S3](#ingestion-params-s3)

### Opzioni generali della pipeline
<a name="ingestion-params-general"></a>

Le seguenti [opzioni generali di pipeline](https://docs.opensearch.org/latest/data-prepper/pipelines/pipelines/) sono impostate da OpenSearch Ingestion e non sono supportate nelle configurazioni della pipeline:
+ `workers`
+ `delay`

### Processore Grok
<a name="ingestion-params-grok"></a>

Le seguenti opzioni del processore [Grok](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/grok/) non sono supportate:
+ `patterns_directories`
+ `patterns_files_glob`

### Origine HTTP
<a name="ingestion-params-http"></a>

Il plugin sorgente [HTTP](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/http-source/) ha i seguenti requisiti e vincoli:
+ *L'`path`opzione è obbligatoria.* Il percorso è una stringa come`/log/ingest`, che rappresenta il percorso URI per l'inserimento dei log. Questo percorso definisce l'URI utilizzato per inviare dati alla pipeline. Ad esempio, `https://log-pipeline.us-west-2.osis.amazonaws.com/log/ingest`. Il percorso deve iniziare con una barra (/) e può contenere i caratteri speciali '-', '\$1', ' . 'e'/', oltre al `${pipelineName}` segnaposto.
+ Le seguenti opzioni di origine HTTP sono impostate da OpenSearch Ingestion e non sono supportate nelle configurazioni della pipeline:
  + `port`
  + `ssl`
  + `ssl_key_file`
  + `ssl_certificate_file`
  + `aws_region`
  + `authentication`
  + `unauthenticated_health_check`
  + `use_acm_certificate_for_ssl`
  + `thread_count`
  + `request_timeout`
  + `max_connection_count`
  + `max_pending_requests`
  + `health_check_service`
  + `acm_private_key_password`
  + `acm_certificate_timeout_millis`
  + `acm_certificate_arn`

### OpenSearch lavandino
<a name="ingestion-params-opensearch"></a>

Il plugin [OpenSearch](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/opensearch/)sink presenta i seguenti requisiti e limitazioni.
+ L'`aws`opzione è *obbligatoria* e deve contenere le seguenti opzioni:
  + `sts_role_arn`
  + `region`
  + `hosts`
  + `serverless`(se il sink è una raccolta OpenSearch Serverless)
+ L'`sts_role_arn`opzione deve puntare allo stesso ruolo per ogni sink all'interno di un file di definizione YAML.
+ L'`hosts`opzione deve specificare un endpoint del dominio OpenSearch di servizio o un endpoint di raccolta OpenSearch Serverless. Non è possibile specificare un [endpoint personalizzato](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/customendpoint.html) per un dominio; deve essere l'endpoint standard.
+ Se l'`hosts`opzione è un endpoint di raccolta senza server, è necessario impostarla su. `serverless` `true` Inoltre, se il file di definizione YAML contiene l'`index_type`opzione, questa deve essere impostata su, altrimenti la convalida `management_disabled` fallisce.
+ Le seguenti opzioni non sono supportate:
  + `username`
  + `password`
  + `cert`
  + `proxy`
  + `dlq_file`- Se desideri scaricare gli eventi non riusciti su una coda di lettere morte (DLQ), devi utilizzare l'`dlq`opzione e specificare un bucket S3.
  + `ism_policy_file`
  + `socket_timeout`
  + `template_file`
  + `insecure`

### OTel metrics source, OTel trace source e logs source OTel
<a name="ingestion-params-otel-source"></a>

I plugin [OTel metrics](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-metrics-source/) source, [OTel trace](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-trace/) source e [OTel logs](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-logs-source/) source presentano i seguenti requisiti e limitazioni:
+ *L'`path`opzione è obbligatoria.* Il percorso è una stringa come`/log/ingest`, che rappresenta il percorso URI per l'inserimento dei log. Questo percorso definisce l'URI utilizzato per inviare dati alla pipeline. Ad esempio, `https://log-pipeline.us-west-2.osis.amazonaws.com/log/ingest`. Il percorso deve iniziare con una barra (/) e può contenere i caratteri speciali '-', '\$1', ' . 'e'/', oltre al `${pipelineName}` segnaposto.
+ Le seguenti opzioni sono impostate da OpenSearch Ingestion e non sono supportate nelle configurazioni della pipeline:
  + `port`
  + `ssl`
  + `sslKeyFile`
  + `sslKeyCertChainFile`
  + `authentication`
  + `unauthenticated_health_check`
  + `useAcmCertForSSL`
  + `unframed_requests`
  + `proto_reflection_service`
  + `thread_count`
  + `request_timeout`
  + `max_connection_count`
  + `acmPrivateKeyPassword`
  + `acmCertIssueTimeOutMillis`
  + `health_check_service`
  + `acmCertificateArn`
  + `awsRegion`

### OTel processore trace group
<a name="ingestion-params-otel-trace"></a>

Il processore del [gruppo di OTel tracce](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/otel-trace-group/) presenta i seguenti requisiti e limitazioni:
+ L'`aws`opzione è *obbligatoria* e deve contenere le seguenti opzioni:
  + `sts_role_arn`
  + `region`
  + `hosts`
+ L'`sts_role_arn`opzione specifica lo stesso ruolo del ruolo della pipeline specificato nella configurazione del OpenSearch sink.
+ Le `insecure` opzioni `username``password`,`cert`, e non sono supportate.
+ L'`aws_sigv4`opzione è obbligatoria e deve essere impostata su true.
+ L'`serverless`opzione all'interno del plugin OpenSearch sink non è supportata. Il processore Otel trace group attualmente non funziona con le raccolte OpenSearch Serverless.
+ Il numero di `otel_trace_group` processori all'interno del corpo di configurazione della pipeline non può superare 8.

### OTel processore di traccia
<a name="ingestion-params-otel-raw"></a>

Il processore di [OTel traccia](https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/processors/otel-traces/) presenta i seguenti requisiti e limitazioni:
+ Il valore dell'`trace_flush_interval`opzione non può superare i 300 secondi.

### Processore Service-map
<a name="ingestion-params-servicemap"></a>

Il processore [Service-map](https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/processors/service-map/) presenta i seguenti requisiti e limitazioni:
+ Il valore dell'`window_duration`opzione non può superare i 300 secondi.

### Fonte S3
<a name="ingestion-params-s3"></a>

Il plugin sorgente [S3](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/s3/) presenta i seguenti requisiti e limitazioni:
+ L'`aws`opzione è *obbligatoria* e deve contenere `region` `sts_role_arn` opzioni.
+ Il valore dell'`records_to_accumulate`opzione non può superare 200.
+ Il valore dell'`maximum_messages`opzione non può superare 10.
+ Se specificata, l'`disable_bucket_ownership_validation`opzione deve essere impostata su false.
+ Se specificata, l'`input_serialization`opzione deve essere impostata su`parquet`.