Docker 部署
先决条件
- Docker
- Docker Compose v2.0.0+
- Make(可选)
- 应用程序需要 6 GB 的 RAM
获取并运行演示
-
克隆演示存储库:
git clone https://github.com/open-telemetry/opentelemetry-demo.git
-
进入演示文件夹:
cd opentelemetry-demo/
-
使用 make 启动演示:
make start
注解:
如果没有安装 make 工具,也可以使用
docker compose up --force-recreate --remove-orphans --detach
1 启动演示。
验证网上商店和遥测
当镜像构建完成,容器启动后,可以访问以下内容:
- 网上商店: http://localhost:8080/
- Grafana: http://localhost:8080/grafana/
- 功能开关界面: http://localhost:8080/feature/
- 负载生成器界面: http://localhost:8080/loadgen/
- Jaeger 界面: http://localhost:8080/jaeger/ui/
使用自己的后端
通常你希望将网上商店作为你已经拥有的可观察性后端的演示应用程序(例如,Jaeger、Zipkin 的已有实例,或者其他您选择的供应商)。
OpenTelemetry Collector 可用于将遥测数据导出到多个后端。默认情况下,演示应用程序中的 Collector 会合并两个文件的配置:
otelcol-config.yml
otelcol-config-extras.yml
要添加自己的后端,请使用编辑器打开文件src/otelcollector/otelcol-config-extras.yml。
-
首先添加一个新的 exporter。例如,如果您的后端支持 OTLP over HTTP,请添加以下内容:
exporters: otlphttp/example: endpoint: <your-endpoint-url>
-
然后重写您要用于自己后端的遥测流水线的
exporters
。service: pipelines: traces: exporters: [spanmetrics, otlphttp/example]
注意
Collector 在合并 YAML 值时,会合并对象并替换数组。如果重写了流水线的exporters
,则必须将 spanmetrics
导出器包含在traces
pipeline 的 exporters 数组中。不包含此导出器将导致错误。
供应商后端可能要求您添加其他用于身份验证的参数,请查阅其文档。某些后端需要不同的导出器,您可以在opentelemetry-collector-contrib/exporter上找到它们以及它们的文档。
在更新了 otelcol-config-extras.yml
后,通过运行 make start
启动演示。过一段时间后,您应该看到追踪数据流入您的后端。
-
docker-compose
is deprecated. For details, see Migrate to Compose V2. ↩︎
最后修改 December 10, 2023: translate (a4350d6e)