Uso de esquemas - Amazon OpenSearch Service

Uso de esquemas

En lugar de crear una definición de canalización desde cero, puede usar esquemas de configuración, que son plantillas preconfiguradas para escenarios de ingesta comunes, como los registros de Trace Analytics o Apache. Los esquemas de configuración lo ayudan a aprovisionar canalizaciones fácilmente sin tener que crear una configuración desde cero.

Cómo usar un esquema de canalización

  1. Inicie sesión en la consola de Amazon OpenSearch Service en https://console.aws.amazon.com/aos/home.

  2. Seleccione Canalizaciones en el panel de navegación izquierdo y Seleccione Crear canalización.

  3. Seleccione un esquema en la lista de casos de uso y, a continuación, elija Seleccionar esquema. La configuración de la canalización se completa con una subcanalización para el caso de uso que haya seleccionado.

    El esquema de la canalización no es válido tal como está. Debe especificar ajustes adicionales en función del origen seleccionado.

Para ver una lista de todos los esquemas disponibles mediante la AWS CLI, envíe una solicitud list-pipeline-blueprints.

aws osis list-pipeline-blueprints

La solicitud devuelve una lista de todos los esquemas disponibles.

Para ver información más detallada sobre un esquema específico, utilice el comando get-pipeline-blueprint:

aws osis get-pipeline-blueprint --blueprint-name AWS-ApacheLogPipeline

Esta solicitud devuelve el contenido del esquema de la canalización de registro de Apache:

{
   "Blueprint":{
      "PipelineConfigurationBody":"###\n  # Limitations: https://docs.aws.amazon.com/opensearch-service/latest/ingestion/ingestion.html#ingestion-limitations\n###\n###\n  # apache-log-pipeline:\n    # This pipeline receives logs via http (e.g. FluentBit), extracts important values from the logs by matching\n    # the value in the 'log' key against the grok common Apache log pattern. The grokked logs are then sent\n    # to OpenSearch to an index named 'logs'\n###\n\nversion: \"2\"\napache-log-pipeline:\n  source:\n    http:\n      # Provide the path for ingestion. ${pipelineName} will be replaced with pipeline name configured for this pipeline.\n      # In this case it would be \"/apache-log-pipeline/logs\". This will be the FluentBit output URI value.\n      path: \"/${pipelineName}/logs\"\n  processor:\n    - grok:\n        match:\n          log: [ \"%{COMMONAPACHELOG_DATATYPED}\" ]\n  sink:\n    - opensearch:\n        # Provide an AWS OpenSearch Service domain endpoint\n        # hosts: [ \"https://search-mydomain-1a2a3a4a5a6a7a8a9a0a9a8a7a.us-east-1.es.amazonaws.com\" ]\n        aws:\n          # Provide the region of the domain.\n          # region: \"us-east-1\"\n          # Enable the 'serverless' flag if the sink is an Amazon OpenSearch Serverless collection\n          # serverless: true\n        index: \"logs\"\n        # Enable the S3 DLQ to capture any failed requests in an S3 bucket\n        # dlq:\n          # s3:\n            # Provide an S3 bucket\n            # bucket: \"your-dlq-bucket-name\"\n            # Provide a key path prefix for the failed requests\n            # key_path_prefix: \"${pipelineName}/logs/dlq\"\n            # Provide the region of the bucket.\n            # region: \"us-east-1\"\n            # Provide a Role ARN with access to the bucket. This role should have a trust relationship with osis-pipelines.amazonaws.com\n"
      "BlueprintName":"AWS-ApacheLogPipeline"
   }
}

Para obtener información sobre los esquemas de canalización mediante la API de OpenSearch Ingestion, use las operaciones ListPipelineBlueprints y GetPipelineBlueprint.