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

1. Vaya a la consola de Amazon OpenSearch Service en https://console.aws.amazon.com/aos/home.

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. Modifique los elementos Principal para incluir su ID de Cuenta de AWS. Para la segunda entidad principal, especifique un usuario o rol que pueda utilizar para consultar la colección más tarde.

10. Elija Siguiente. Nombre la política de acceso pipeline-collection-access y elija Siguiente de nuevo.

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

Para crear una canalización

1. En la consola de Amazon OpenSearch Service, seleccione Canalizaciones 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 de OpenSearch sin servidor como el receptor 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 recurso de OpenSearch, elija Colección (sin servidor). Luego, elija la colección de OpenSearch Service que creó en la sección anterior.

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

11. Elija Siguiente.

12. Asigne el nombre ingestion-pipeline-serverless a la canalización. 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, usted 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. Para el sufijo del nombre del rol de servicio, ingrese 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.