4.9. AWS EMF Exporter


AWS EMF Exporter 将以下 OpenTelemetry 指标数据点转换为 AWS CloudWatch 嵌入式指标格式(EMF):

  • Int64DataPoints
  • DoubleDataPoints
  • SummaryDataPoints

然后,使用 PutLogEvents API 直接发送到 Amazon CloudWatch Logs 服务。

使用此导出器的一个好处是,可以在 Amazon CloudWatch 控制台中查看日志和指标,地址为 https://console.aws.amazon.com/cloudwatch/

重要

AWS EMF Exporter 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息,请参阅技术预览功能支持范围

OpenTelemetry Collector 自定义资源带有启用的 AWS EMF Exporter

# ...
  config:
    exporters:
      awsemf:
        log_group_name: "<group_name_of_amazon_cloudwatch_logs>" 
1

        log_stream_name: "<log_stream_of_amazon_cloudwatch_logs>" 
2

        resource_to_telemetry_conversion: 
3

          enabled: true
        region: <region> 
4

        endpoint: <protocol><endpoint> 
5

        log_retention: <supported_value_in_days> 
6

        namespace: <custom_namespace> 
7

        role_arn: "<iam_role>" 
8

# ...
Copy to Clipboard Toggle word wrap

1
log_group_name 参数允许您自定义日志组名称,并支持默认的 /metrics/default 值或以下占位符:

/aws/metrics/{ClusterName} 占位符用于搜索指标数据中的 ClusterNameaws.ecs.cluster.name 资源属性,并将其替换为实际集群名称。

{NodeName} 占位符用于搜索 NodeNamek8s.node.name 资源属性。

{TaskId} 占位符用于搜索 TaskIdaws.ecs.task.id 资源属性。

如果在资源属性映射中没有找到 resource 属性,则占位符将替换为 undefined 值。

2
您可以使用 log_stream_name 参数自定义日志流名称,或者设置默认的 otel-stream 值或以下占位符:

{ClusterName} 占位符用于搜索 ClusterNameaws.ecs.cluster.name 资源属性。

{ContainerInstanceId} 占位符用于搜索 ContainerInstanceIdaws.ecs.container.instance.id 资源属性。此资源属性仅对 AWS ECS EC2 启动类型有效。

{NodeName} 占位符用于搜索 NodeNamek8s.node.name 资源属性。

{TaskDefinitionFamily} 占位符用于搜索 TaskDefinitionFamilyaws.ecs.task.family 资源属性。

{TaskId} 占位符用于搜索指标数据中的 TaskIdaws.ecs.task.id 资源属性,并将其替换为实际任务 ID。

如果在资源属性映射中没有找到 resource 属性,则占位符将替换为 undefined 值。

3
可选。将资源属性转换为遥测属性,如指标标签。默认禁用此选项。
4
日志流的 AWS 区域。如果默认凭证供应商链中尚未设置区域,您必须指定区域。
5
可选。您可以覆盖将请求转发到的默认 Amazon CloudWatch Logs 服务端点。您必须包含协议,如 https://,作为端点值的一部分。有关区域服务端点列表,请参阅 Amazon CloudWatch Logs 端点和配额 (AWS General Reference)。
6
可选。使用这个参数,您可以为新的 Amazon CloudWatch 日志组设置日志保留策略。如果省略此参数或设置为 0,则日志默认不会过期。支持的保留值(以天为单位)是 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, 2192, 2557, 2922, 3288, 或 3653
7
可选。Amazon CloudWatch 指标的自定义命名空间。
8
可选。AWS Identity and Access Management (IAM)角色,将指标片段上传到其他帐户。
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部