Open Telemetry Collector on Dapr 文档库

使用 OpenTelemetry Collector 收集追踪

Mon, 01 Jan 0001 00:00:00 +0000

Dapr 推荐使用 OpenTelemetry (OTLP) 协议来写入追踪数据。对于直接支持 OTLP 的可观测性工具，建议使用 OpenTelemetry Collector，因为它可以快速卸载数据，并提供重试、批处理和加密等功能。更多信息请参阅 Open Telemetry Collector 的文档。

Dapr 也支持使用 Zipkin 协议来写入追踪数据。在 OTLP 协议支持之前，Zipkin 协议与 OpenTelemetry Collector 一起使用，以将追踪数据发送到 AWS X-Ray、Google Cloud Operations Suite 和 Azure Monitor 等可观测性工具。虽然两种协议都有效，但推荐使用 OpenTelemetry 协议。

先决条件

在 Kubernetes 上安装 Dapr
确保您的追踪后端已准备好接收追踪数据
查看 OTEL Collector 导出器所需的参数：
- opentelemetry-collector-contrib/exporter
- opentelemetry-collector/exporter

配置 OTEL Collector 推送追踪数据到您的后端

查看 open-telemetry-collector-generic.yaml。
将 <your-exporter-here> 替换为您的追踪导出器的实际配置。
- 请参考先决条件部分中的 OTEL Collector 链接以获取正确的配置。

使用以下命令应用配置：

kubectl apply -f open-telemetry-collector-generic.yaml

配置 Dapr 发送追踪数据到 OTEL Collector

创建一个 Dapr 配置文件以启用追踪，并部署一个使用 OpenTelemetry Collector 的追踪导出器组件。

使用 OpenTelemetry Collector 将跟踪信息发送到应用程序洞察

Mon, 01 Jan 0001 00:00:00 +0000

Dapr 使用 Zipkin API 集成了 OpenTelemetry (OTEL) Collector。本指南演示了如何通过 Dapr 使用 OpenTelemetry Collector 将跟踪事件推送到 Azure 应用程序洞察。

前提条件

在 Kubernetes 上安装 Dapr
设置一个应用程序洞察资源并记录下你的应用程序洞察仪器密钥。

配置 OTEL Collector 以推送数据到应用程序洞察

要将事件推送到你的应用程序洞察实例，请在 Kubernetes 集群中安装 OTEL Collector。

查看 open-telemetry-collector-appinsights.yaml 文件。
用你的应用程序洞察仪器密钥替换 <INSTRUMENTATION-KEY> 占位符。

使用以下命令应用配置：

kubectl apply -f open-telemetry-collector-appinsights.yaml

配置 Dapr 以发送跟踪数据到 OTEL Collector

创建一个 Dapr 配置文件以启用跟踪，并部署一个使用 OpenTelemetry Collector 的跟踪导出组件。

使用此 collector-config.yaml 文件创建你自己的配置。
使用以下命令应用配置：
```
kubectl apply -f collector-config.yaml
```

部署应用程序并启用跟踪

在你希望参与分布式跟踪的容器中添加 dapr.io/config 注解以应用 appconfig 配置，如下例所示：

apiVersion: apps/v1
kind: Deployment
metadata:
 ...
spec:
 ...
 template:
 metadata:
 ...
 annotations:
 dapr.io/enabled: "true"
 dapr.io/app-id: "MyApp"
 dapr.io/app-port: "8080"
 dapr.io/config: "appconfig"

注意

如果你正在使用 Dapr 教程之一，例如分布式计算器，appconfig 配置已经设置好，因此不需要额外的配置。

你可以同时注册多个跟踪导出器，跟踪日志会被转发到所有注册的导出器。

使用 OpenTelemetry Collector 收集追踪信息并发送到 Jaeger

Mon, 01 Jan 0001 00:00:00 +0000

Dapr 支持通过 OpenTelemetry (OTLP) 和 Zipkin 协议进行追踪信息的写入。然而，由于 Jaeger 对 Zipkin 的支持已被弃用，建议使用 OTLP。虽然 Jaeger 可以直接支持 OTLP，但在生产环境中，推荐使用 OpenTelemetry Collector 从 Dapr 收集追踪信息并发送到 Jaeger。这样可以让您的应用程序更高效地处理数据，并利用重试、批处理和加密等功能。更多信息请阅读 Open Telemetry Collector 文档。

在自托管模式下配置 Jaeger

本地设置

启动 Jaeger 的最简单方法是运行发布到 DockerHub 的预构建的 all-in-one Jaeger 镜像，并暴露 OTLP 端口：

docker run -d --name jaeger \
 -p 4317:4317 \
 -p 16686:16686 \
 jaegertracing/all-in-one:1.49

接下来，在本地创建以下 config.yaml 文件：