Tutorial: Ingerir datos en una colección mediante Amazon OpenSearch Ingestion

1. Ve a la consola de Amazon OpenSearch Service de https://console.aws.amazon.com/aos/tu casa.

2. Seleccione Colecciones del panel de navegación de la izquierda y elija Crear colección.

3. Nombre la colección ingestion-collection.

4. En Seguridad, elija Creación estándar.

5. En Configuración de acceso a la red, cambie el tipo de acceso a Público.

6. Mantenga todas las demás configuraciones en sus valores predeterminados y elija Siguiente.

7. Ahora, configure una política de acceso a los datos para la colección. Anule la selección de Coincidir automáticamente la configuración de la política de acceso.

8. Seleccione JSON para el Método de definición y pegue la siguiente política en el editor. Esta política realiza dos tareas:

   • Permite que el rol de canalización escriba en la colección.

   • Le permite leer de la colección. Más adelante, después de incorporar algunos datos de muestra a la canalización, consultará la colección para garantizar que los datos se hayan incorporado y escrito correctamente en el índice.

     [
       {
         "Rules": [
           {
             "Resource": [
               "index/ingestion-collection/*"
             ],
             "Permission": [
               "aoss:CreateIndex",
               "aoss:UpdateIndex",
               "aoss:DescribeIndex",
               "aoss:ReadDocument",
               "aoss:WriteDocument"
             ],
             "ResourceType": "index"
           }
         ],
         "Principal": [
           "arn:aws:iam::your-account-id:role/OpenSearchIngestion-PipelineRole",
           "arn:aws:iam::your-account-id:role/Admin"
         ],
         "Description": "Rule 1"
       }
     ]

9. Modifica los Principal elementos para incluir tu Cuenta de AWS ID. Para la segunda entidad principal, especifique un usuario o rol que pueda utilizar para consultar la colección más tarde.

10. Elija Siguiente. Asigne un nombre a la política de acceso pipeline-collection-accessy vuelva a seleccionar Siguiente.

11. Revise la configuración de la colección y seleccione Enviar.

Creación de una canalización

1. En la consola de Amazon OpenSearch Service, selecciona Pipelines en el panel de navegación izquierdo.

2. Seleccione Create pipeline.

3. Seleccione la canalización en blanco y, a continuación, elija Seleccionar esquema.

4. En este tutorial, crearemos una canalización simple que utiliza el complemento de origen HTTP. El complemento acepta datos de registro en un formato de matriz JSON. Especificaremos una única colección OpenSearch sin servidor como sumidero e incorporaremos todos los datos al índice. my_logs

   En el menú Fuente, seleccione HTTP. Para la ruta, ingrese /logs.

5. Para simplificar este tutorial, configuraremos el acceso público para la canalización. En las opciones de red de origen, seleccione Acceso público. Para obtener información acerca de la configuración del acceso a VPC, consulte Configuración del acceso a la VPC para canalizaciones de Amazon OpenSearch Ingestion.

6. Elija Siguiente.

7. En Procesador, introduzca la fecha y seleccione Agregar.

8. Habilite Desde la hora de recepción. Deje el resto de opciones con sus valores predeterminados.

9. Elija Siguiente.

10. Configure los detalles del destino. Para el tipo de OpenSearch recurso, elija Colección (sin servidor). A continuación, elija la colección de OpenSearch servicios que creó en la sección anterior.

    Deje el nombre de la política de red como predeterminado. En Nombre de índice, escribe my_logs. OpenSearch Ingestión crea automáticamente este índice en la colección si aún no existe.

11. Elija Siguiente.

12. Asigne un nombre a la canalización ingestion-pipeline-serverless. Deje la configuración de capacidad con sus valores predeterminados.

13. Para el rol de canalización, seleccione Crear y usar un nuevo rol de servicio. El rol de canalización proporciona los permisos necesarios para que una canalización escriba en el destino de colección y lea desde orígenes basados en extracción. Al seleccionar esta opción, permite que OpenSearch Ingestion cree el rol por usted, en lugar de crearlo manualmente en IAM. Para obtener más información, consulte Configuración de roles y usuarios en Amazon OpenSearch Ingestion.

14. En el sufijo del nombre de la función de servicio, introduzca. PipelineRole En IAM, el rol tendrá el formato arn:aws:iam::your-account-id:role/OpenSearchIngestion-PipelineRole.

15. Elija Siguiente. Revise la configuración de la canalización y elija Crear canalización. La canalización tarda entre 5 y 10 minutos en activarse.