快速入门

OpenTelemetry收集器接收跟踪数据、度量数据和日志数据，处理遥测数据，并使用其组件将其导出到各种可观测性后端。要了解收集器的概念概述，请阅读介绍。

以下教程展示了如何部署OpenTelemetry收集器，并使用默认配置和telemetrygen工具向其发送遥测数据。

先决条件

要按照本教程进行操作，您需要以下内容：

• Go 1.20或更高版本

在五分钟内测试OpenTelemetry收集器

1. 拉取OpenTelemetry收集器的Docker镜像并在容器中运行收集器：

   docker pull otel/opentelemetry-collector:0.88.0
   docker run -p 127.0.0.1:4317:4317 -p 127.0.0.1:55679:55679 otel/opentelemetry-collector:0.88.0
   

2. 从opentelemetry-collector-contrib存储库下载并安装telemetrygen工具：

   go install github.com/open-telemetry/opentelemetry-collector-contrib/cmd/telemetrygen@latest
   

   此命令应在本地的go/bin目录中安装telemetrygen。

3. telemetrygen命令用于生成用于测试的虚拟遥测数据。在一个新的终端窗口中，向收集器发送一些跟踪数据：

   telemetrygen traces --otlp-insecure --duration 5s
   

   五秒钟后，telemetrygen停止运行并在控制台上显示发送的消息：

   2023-10-23T12:58:19.835+0200	INFO	traces/worker.go:88	生成的跟踪数据	{"worker": 0, "traces": 994418}
   2023-10-23T12:58:19.835+0200	INFO	traces/traces.go:79	停止批量跨度处理器
   

   在运行收集器容器的终端窗口中，日志应显示与跟踪数据摄入相关的活动，类似于以下内容：

   跨度 #434
      跟踪ID：ba7ef95fce7499811ca72158350c907c
      父ID：1d3c9f49b3f2cf47
      ID：7609079dc6253034
      名称：okey-dokey
      类型：服务器
      开始时间：2023-10-23 11:01:29.53251 +0000 UTC
      结束时间：2023-10-23 11:01:29.532634 +0000 UTC
      状态代码：未设置
      状态消息：
   

4. 在浏览器中打开http://localhost:55679/debug/tracez，然后在表格中选择一个示例以查看刚刚生成的跟踪数据。

下一步

在本教程中，您已经启动了OpenTelemetry收集器并向其发送了遥测数据。作为下一步，可以考虑执行以下操作：

• 探索不同的安装收集器的方式。
• 了解收集器的不同模式，在部署方法中了解更多信息。
• 熟悉收集器的配置文件和结构。
• 探索注册表中可用的组件。
• 学习如何使用OpenTelemetry收集器构建器（OCB）构建自定义收集器。