청사진을 사용하여 파이프라인 생성

파이프라인 정의를 처음부터 생성하는 대신 Trace Analytics 또는 Apache 로그와 같은 일반적인 수집 시나리오를 위해 사전 구성된 YAML 템플릿인 구성 청사진을 사용할 수 있습니다. 구성 청사진을 사용하면 구성을 처음부터 작성하지 않고도 파이프라인을 쉽게 프로비저닝할 수 있습니다.

콘솔

파이프라인 청사진 사용

1. https://console.aws.amazon.com/aos/home Amazon OpenSearch Service 콘솔에 로그인합니다.

2. 왼쪽 탐색 창에서 파이프라인을 선택한 후 파이프라인 생성을 선택합니다.

3. 사용 사례 목록에서 블루프린트를 선택한 다음, 블루프린트 선택을 선택합니다. 파이프라인 구성은 선택한 사용 사례의 하위 파이프라인으로 채워집니다.

4. 청사진 구성 과정을 안내하는 주석이 달린 텍스트를 검토하세요.

   중요

   파이프라인 청사진은 현재 상태로는 유효하지 않습니다. 인증에 사용할 AWS 리전 및 역할 ARN을 제공하는 등 몇 가지 수정을 해야 합니다. 그렇지 않으면 파이프라인 검증이 실패합니다.

CLI

를 사용하여 사용 가능한 모든 블루프린트 목록을 가져오려면 list-pipeline-blueprints 요청을 AWS CLI보냅니다.

aws osis list-pipeline-blueprints 

이 요청은 사용 가능한 모든 청사진의 목록을 반환합니다.

특정 청사진에 대한 자세한 정보를 얻으려면 get-pipeline-blueprint 명령어를 사용하세요.

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

이 요청은 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 a Role ARN with access to the domain. This role should have a trust relationship with osis-pipelines.amazonaws.com\n          # sts_role_arn: \"arn:aws:iam::123456789012:role/Example-Role\"\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            # sts_role_arn: \"arn:aws:iam::123456789012:role/Example-Role\"\n",
      "BlueprintName":"AWS-ApacheLogPipeline"
   }
}

OpenSearch Ingestion API

OpenSearch Ingestion API를 사용하여 파이프라인 청사진에 대한 정보를 가져오려면 ListPipelineBlueprints 및 GetPipelineBlueprint 작업을 사용하세요.