Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Plugins y opciones compatibles para las canalizaciones de Amazon OpenSearch Ingestion
<a name="pipeline-config-reference"></a>

[Amazon OpenSearch Ingestion admite un subconjunto de fuentes, procesadores y receptores en Data Prepper de código OpenSearch abierto.](https://opensearch.org/docs/latest/data-prepper/) Además, OpenSearch Ingestion impone algunas restricciones a las opciones disponibles para cada complemento compatible. En las siguientes secciones se describen los complementos y las opciones asociadas que admite OpenSearch Ingestion.

**nota**  
OpenSearch Ingestion no admite ningún complemento de búfer porque configura automáticamente un búfer predeterminado. Si incluye un búfer en la configuración de la canalización, recibirá un error de validación.

**Topics**
+ [Complementos compatibles](#ingestion-plugins)
+ [Procesadores sin estado frente a procesadores con estado](#processor-stateful-stateless)
+ [Requisitos y restricciones de configuración](#ingestion-parameters)

## Complementos compatibles
<a name="ingestion-plugins"></a>

OpenSearch Ingestion es compatible con los siguientes complementos de Data Prepper:

**Fuentes**:
+ [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 métricas](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-metrics-source/)
+ [OTel rastreo](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-trace/)
+ [S3](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/s3/)

**Procesadores**:
+ [Agregar entradas](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/add-entries/)
+ [Aggregate](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aggregate/)
+ [Detector de anomalías](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/)
+ [Convertir el tipo de entrada](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/convert-entry-type/)
+ [Copiar valores](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/copy-values/)
+ [CSV](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/csv/)
+ [Fecha](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/date/)
+ [Retraso](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/delay/)
+ [Descomprimir](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/decompress/)
+ [Eliminar entradas](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/delete-entries/)
+ [Diseccionar](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/dissect/)
+ [Soltar eventos](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/drop-events/)
+ [Aplanar](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/flatten/)
+ [IP geográfica](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/geoip/)
+ [Grok](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/grok/)
+ [Valor de clave](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/key-value/)
+ [Lista a mapa](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/list-to-map/)
+ [Cadena en minúsculas](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/lowercase-string/)
+ [Mapa a lista](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/map-to-list/)
+ [Evento de mutación](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/mutate-event/) (serie de procesadores)
+ [Cadena de mutación](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/mutate-string/) (serie de procesadores)
+ [Obfuscate](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/obfuscate/)
+ [OTel métricas](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/otel-metrics/)
+ [OTel grupo de rastreo](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/otel-trace-group/)
+ [OTel rastrear](https://docs.opensearch.org/latest/data-prepper/common-use-cases/trace-analytics/)
+ [Analizar Ion](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/parse-ion/)
+ [Analizar JSON](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/parse-json/)
+ [Analizar XML](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/parse-xml/)
+ [Cambiar el nombre de las claves](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/rename-keys/)
+ [Seleccionar entradas](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/select-entries/)
+ [Mapa de servicios](https://docs.opensearch.org/latest/data-prepper/common-use-cases/trace-analytics/)
+ [Evento dividido](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/split-event/)
+ [Cadena dividida](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/split-string/)
+ [Convertidor de cadenas](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/string-converter/)
+ [Cadena sustitutiva](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/substitute-string/)
+ [Reenviador por pares de seguimiento](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/)
+ [Recortar cadena](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/trim-string/)
+ [Truncar](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/truncate/)
+ [Cadena en mayúscula](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/uppercase-string/)
+ [Agente usuario](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/user-agent/)
+ [Escribir JSON](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/write-json/)

**Receptores**:
+ [OpenSearch](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/opensearch/)(es compatible con OpenSearch Service, OpenSearch Serverless y Elasticsearch 6.8 o versiones posteriores)
+ [S3](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/s3/)

**Códecs de receptor**:
+ [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)

## Procesadores sin estado frente a procesadores con estado
<a name="processor-stateful-stateless"></a>

Los procesadores *sin estado* realizan operaciones como las transformaciones y el filtrado, mientras que los procesadores con *estado realizan* operaciones como las agregaciones, que recuerdan el resultado de la ejecución anterior. OpenSearch [https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aggregate/](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aggregate/) Todos los demás procesadores compatibles no tienen estado.

En el caso de las canalizaciones que contienen únicamente procesadores sin estado, el límite máximo de capacidad es de 96 ingestion. OCUs Si una canalización contiene procesadores con estado, el límite máximo de capacidad es de 48 tomas. OCUs Sin embargo, si una canalización tiene habilitado el almacenamiento en [búfer persistente](osis-features-overview.md#persistent-buffering), puede tener un máximo de 384 ingestas solo OCUs con procesadores sin estado, o 192 ingestas si contiene procesadores con estado. OCUs Para obtener más información, consulte [Escalar las canalizaciones en Amazon OpenSearch Ingestion](ingestion-scaling.md).

End-to-end El reconocimiento solo se admite en procesadores sin estado. Para obtener más información, consulte [End-to-end reconocimiento](osis-features-overview.md#osis-features-e2e).

## Requisitos y restricciones de configuración
<a name="ingestion-parameters"></a>

A menos que se especifique lo contrario a continuación, todas las opciones descritas en la referencia de configuración de Data Prepper para los complementos compatibles enumerados anteriormente están permitidas en OpenSearch los procesos de ingestión. En las siguientes secciones se explican las restricciones que OpenSearch Ingestion impone a determinadas opciones de los complementos.

**nota**  
OpenSearch Ingestion no admite ningún complemento de búfer porque configura automáticamente un búfer predeterminado. Si incluye un búfer en la configuración de la canalización, recibirá un error de validación.

 OpenSearch Ingestion configura y administra internamente muchas opciones, como y. `authentication` `acm_certificate_arn` Otras opciones, como `thread_count` y`request_timeout`, tienen un impacto en el rendimiento si se modifican manualmente. Por lo tanto, estos valores se establecen internamente para garantizar un rendimiento óptimo de sus canalizaciones.

Por último, algunas opciones no se pueden pasar a OpenSearch Ingestion, como `ism_policy_file` y`sink_template`, porque son archivos locales cuando se ejecutan en Data Prepper de código abierto. No se admiten estos valores.

**Topics**
+ [Opciones generales de canalización](#ingestion-params-general)
+ [Procesador Grok](#ingestion-params-grok)
+ [Origen de HTTP](#ingestion-params-http)
+ [OpenSearch sumidero](#ingestion-params-opensearch)
+ [OTel fuente de métricas, fuente de OTel rastreo y fuente de OTel registros](#ingestion-params-otel-source)
+ [OTel procesador de grupos de rastreo](#ingestion-params-otel-trace)
+ [OTel procesador de trazas](#ingestion-params-otel-raw)
+ [Procesador de mapas de servicio](#ingestion-params-servicemap)
+ [Fuente de S3](#ingestion-params-s3)

### Opciones generales de canalización
<a name="ingestion-params-general"></a>

 OpenSearch Ingestion establece las siguientes [opciones generales de canalización](https://docs.opensearch.org/latest/data-prepper/pipelines/pipelines/) y no se admiten en las configuraciones de canalización:
+ `workers`
+ `delay`

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

No se admiten las siguientes opciones de procesador [Grok](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/grok/):
+ `patterns_directories`
+ `patterns_files_glob`

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

El complemento fuente [HTTP](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/http-source/) tiene los siguientes requisitos y restricciones:
+ La opción `path` es *obligatoria*. La ruta es una cadena, por ejemplo `/log/ingest`, que representa la ruta del URI para la ingesta de registros. Esta ruta define el URI que usa para enviar datos a la canalización. Por ejemplo, `https://log-pipeline.us-west-2.osis.amazonaws.com/log/ingest`. La ruta debe empezar con una barra (/) y puede contener los caracteres especiales '-', '\$1', '.' y '/', así como el marcador de posición `${pipelineName}`.
+  OpenSearch Ingestion establece las siguientes opciones de fuente HTTP y no se admiten en las configuraciones de canalización:
  + `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 sumidero
<a name="ingestion-params-opensearch"></a>

El complemento [OpenSearch](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/opensearch/)sink tiene los siguientes requisitos y limitaciones.
+ La opción `aws` es *obligatoria* y debe contener las siguientes opciones:
  + `sts_role_arn`
  + `region`
  + `hosts`
  + `serverless`(si el sumidero es una colección OpenSearch sin servidor)
+ La opción `sts_role_arn` debe apuntar al mismo rol para cada receptor de un archivo de definición YAML.
+ La `hosts` opción debe especificar un punto final de dominio OpenSearch de servicio o un punto final de colección OpenSearch sin servidor. No se puede especificar un [punto de conexión personalizado](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/customendpoint.html) para un dominio; este debe ser el punto de conexión estándar.
+ Si la opción de `hosts` es un punto de conexión de la colección sin servidor, debe configurar la opción `serverless` en `true`. Además, si su archivo de definición YAML contiene la opción `index_type`, debe estar configurada en `management_disabled`, de lo contrario, la validación fallará.
+ Las siguientes opciones no son compatibles:
  + `username`
  + `password`
  + `cert`
  + `proxy`
  + `dlq_file`: si quiere descargar los eventos fallidos a una cola de mensajes fallidos (DLQ), debe usar la opción `dlq` y especificar un bucket de S3.
  + `ism_policy_file`
  + `socket_timeout`
  + `template_file`
  + `insecure`

### OTel fuente de métricas, fuente de OTel rastreo y fuente de OTel registros
<a name="ingestion-params-otel-source"></a>

Los complementos fuente de [OTel métricas](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-metrics-source/), fuente de [OTel rastreo](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-trace/) y fuente de [OTel registros](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-logs-source/) tienen los siguientes requisitos y limitaciones:
+ La opción `path` es *obligatoria*. La ruta es una cadena, por ejemplo `/log/ingest`, que representa la ruta del URI para la ingesta de registros. Esta ruta define el URI que usa para enviar datos a la canalización. Por ejemplo, `https://log-pipeline.us-west-2.osis.amazonaws.com/log/ingest`. La ruta debe empezar con una barra (/) y puede contener los caracteres especiales '-', '\$1', '.' y '/', así como el marcador de posición `${pipelineName}`.
+  OpenSearch Ingestion establece las siguientes opciones y no se admiten en las configuraciones de canalización:
  + `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 procesador de grupos de rastreo
<a name="ingestion-params-otel-trace"></a>

El procesador de [grupos de OTel rastreo](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/otel-trace-group/) tiene los siguientes requisitos y limitaciones:
+ La opción `aws` es *obligatoria* y debe contener las siguientes opciones:
  + `sts_role_arn`
  + `region`
  + `hosts`
+ La `sts_role_arn` opción especifica la misma función que la función de canalización que se especifica en la configuración OpenSearch del receptor.
+ No se admiten las opciones `username`, `password`, `cert`, y `insecure`.
+ La opción `aws_sigv4` es obligatoria y se debe establecer en verdadero.
+ No se admite la `serverless` opción incluida en el complemento de OpenSearch sumidero. El procesador Otel Trace Group no funciona actualmente con las colecciones OpenSearch Serverless.
+ El número de procesadores `otel_trace_group` en el cuerpo de configuración de la canalización no puede ser superior a 8.

### OTel procesador de trazas
<a name="ingestion-params-otel-raw"></a>

El procesador de [OTel trazas](https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/processors/otel-traces/) tiene los siguientes requisitos y limitaciones:
+ El valor de la opción `trace_flush_interval` no puede superar los 300 segundos.

### Procesador de mapas de servicio
<a name="ingestion-params-servicemap"></a>

El procesador de [Service-map](https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/processors/service-map/) tiene los siguientes requisitos y limitaciones:
+ El valor de la opción `window_duration` no puede superar los 300 segundos.

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

El complemento fuente de [S3](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/s3/) tiene los siguientes requisitos y limitaciones:
+ La opción `aws` es *obligatoria* y debe contener las opciones `region` y `sts_role_arn`.
+ El valor de la opción `records_to_accumulate` no puede ser superior a 200.
+ El valor de la opción `maximum_messages` no puede ser superior a 10.
+ Si se especifica, la opción `disable_bucket_ownership_validation` se debe establecer en falso.
+ Si se especifica, la opción `input_serialization` se debe establecer en `parquet`.