View a markdown version of this page

将 Amazon OpenSearch Ingestion 管道与其他服务和应用程序集成 - 亚马逊 OpenSearch 服务
构建摄取端点创建摄取角色后续步骤

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将 Amazon OpenSearch Ingestion 管道与其他服务和应用程序集成

要成功将数据 OpenSearch 摄取到 Amazon Ingestion 管道，您必须配置您的客户端应用程序（源）以将数据发送到管道终端节点。您的来源可能是 Fluent Bit 日志、 OpenTelemetry 收集器或简单的 S3 存储桶等客户端。每个客户端的确切配置各不相同。

在源配置期间（与直接向 OpenSearch 服务域或 OpenSearch 无服务器集合发送数据相比）的重要区别是 AWS 服务名称 (osis) 和主机端点，主机端点必须是管道端点。

构建摄取端点

要将数据摄入管道，请将其发送到摄取端点。要查找摄取 URL，请导航到管道设置页面并复制摄取 URL。

管道设置页面显示状态、容量和数据输入的摄取 URL 等详细信息。

要为基于拉取的源（例如，OTel 跟踪和 OTel 指标）构建完整摄取端点，请将管道配置中的摄取路径添加到摄取 URL。

例如，假设管道配置的摄取路径如下所示：

HTTP 源路径的输入字段，输入示例 my/test_path “/”。

您在客户端配置中指定的完整摄取端点将采用以下格式：https://ingestion-pipeline-abcdefg.us-east-1.osis.amazonaws.com/my/test_path。

创建摄取角色

所有 OpenSearch 摄取请求都必须使用签名版本 4 签名。至少，签署请求的角色必须获得osis:Ingest操作权限，这允许其向 OpenSearch Ingestion 管道发送数据。

例如，以下 AWS Identity and Access Management (IAM) 策略允许相应的角色向单个管道发送数据：

JSON
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "osis:Ingest",
      "Resource": "arn:aws:osis:us-east-1:111122223333:pipeline/pipeline-name"
    }
  ]
}
注意

要将角色用于所有管道，请将 Resource 元素的 ARN 替换为通配符 (*)。

提供跨账户摄取访问权限

注意

只能为公有管道（而非 VPC 管道）提供跨账户摄取访问权限。

您可能需要将数据从不同的管道中提取到管道中 AWS 账户，例如存放源应用程序的帐户。如果写入管道的主体与管道本身的账户不同，则需要将主体配置为信任另一个 IAM 角色，以将数据摄取到管道中。

配置跨账户摄取权限

  1. 在管道内创建具有osis:Ingest权限（如上一节所述）的采 AWS 账户 集角色。有关说明，请参阅创建 IAM 角色。

  2. 为摄取角色附加信任策略，允许其他账户主体担任此角色：

    JSON
    {
  "Version":"2012-10-17",
  "Statement": [{
     "Effect": "Allow",
     "Principal": {
       "AWS": "arn:aws:iam::111122223333:root"
      },
     "Action": "sts:AssumeRole"
  }]
}

  3. 在另一个账户中，配置您的客户端应用程序（例如，Fluent Bit）担任摄取角色。为使配置生效，应用程序账户必须向应用程序用户或角色授予担任摄取角色的权限。

    以下基于身份的示例策略允许附加主体担任管道账户的 ingestion-role：

    JSON
    {
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "sts:AssumeRole",
      "Resource": "arn:aws:iam::111122223333:role/ingestion-role"
    }
  ]
}

然后，客户端应用程序可以使用该AssumeRole操作来假设数据ingestion-role并将其提取到相关的管道中。

后续步骤

将数据导出到管道后，您可以从配置为管道接收器的 OpenSearch 服务域中进行查询。以下资源可帮助您开始使用：