Docker 部署

先决条件

  • Docker
  • Docker Compose v2.0.0+
  • Make(可选)
  • 应用程序需要 6 GB 的 RAM

获取并运行演示

  1. 克隆演示存储库:

    git clone https://github.com/open-telemetry/opentelemetry-demo.git
    
  2. 进入演示文件夹:

    cd opentelemetry-demo/
    
  3. 使用 make 启动演示:

    make start
    

    注解:

    如果没有安装 make 工具,也可以使用 docker compose up --force-recreate --remove-orphans --detach1 启动演示。

验证网上商店和遥测

当镜像构建完成,容器启动后,可以访问以下内容:

使用自己的后端

通常你希望将网上商店作为你已经拥有的可观察性后端的演示应用程序(例如,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]
    

供应商后端可能要求您添加其他用于身份验证的参数,请查阅其文档。某些后端需要不同的导出器,您可以在opentelemetry-collector-contrib/exporter上找到它们以及它们的文档。

在更新了 otelcol-config-extras.yml 后,通过运行 make start 启动演示。过一段时间后,您应该看到追踪数据流入您的后端。


  1. docker-compose is deprecated. For details, see Migrate to Compose V2↩︎

最后修改 December 10, 2023: translate (a4350d6e)