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
- 1
log_group_name参数允许您自定义日志组名称,并支持默认的/metrics/default值或以下占位符:/aws/metrics/{ClusterName}占位符用于搜索指标数据中的ClusterName或aws.ecs.cluster.name资源属性,并将其替换为实际集群名称。{NodeName}占位符用于搜索NodeName或k8s.node.name资源属性。{TaskId}占位符用于搜索TaskId或aws.ecs.task.id资源属性。如果在资源属性映射中没有找到 resource 属性,则占位符将替换为
undefined值。- 2
- 您可以使用
log_stream_name参数自定义日志流名称,或者设置默认的otel-stream值或以下占位符:{ClusterName}占位符用于搜索ClusterName或aws.ecs.cluster.name资源属性。{ContainerInstanceId}占位符用于搜索ContainerInstanceId或aws.ecs.container.instance.id资源属性。此资源属性仅对 AWS ECS EC2 启动类型有效。{NodeName}占位符用于搜索NodeName或k8s.node.name资源属性。{TaskDefinitionFamily}占位符用于搜索TaskDefinitionFamily或aws.ecs.task.family资源属性。{TaskId}占位符用于搜索指标数据中的TaskId或aws.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)角色,将指标片段上传到其他帐户。