共计 4081 个字符，预计需要花费 11 分钟才能阅读完成。
OpenTelemetry Collector 有两个官网发行版：Core 和 Contrib。
- Core 发行版是 Collector 的根底发行版，供 OTel 开发人员进行开发和测试。它蕴含一组根本的扩大、连接器、接收器、处理器和导出器。
- Contrib 发行版供非 OTel 开发人员进行试验和学习。它还扩大了 Core 发行版，并蕴含由第三方（包含供应商和集体社区成员）创立的组件，这些组件对整个 OpenTelemetry 社区十分有用。在之前的文章《应用 OpenTelemetry 和 Loki 实现高效的利用日志采集和剖析》我用的就是这个发行版。
不论 Core 还是 Contrib 都不应该成为你生产工作负载的一部分。仅仅应用 Core 自身太过简略，无奈满足组织的需要（只管它提供的组件都是必须的）；尽管 Contrib 中提供的组件足够全面，然而并不是说每个组件都是你所须要的，太多冗余的组件显得过于臃肿，还增大的攻击面。
那如何抉择你所需的发行版呢？答案就是构建本人的发行版。能够应用官网提供的名为 OpenTelemetry Collector Builder (OCB) 的工具来自定义附件。
装置 OCB
ocb 是个简略的 CLI，反对 Window/Linux/macOS 以及 x86 和 arm64 平台。咱们能够从 release 页面 下载 ocb 的 binary。
curl -o ocb -sL https://github.com/open-telemetry/opentelemetry-collector/releases/download/cmd%2Fbuilder%2Fv0.95.0/ocb_0.95.0_linux_amd64
chmod +x ocb 能够通过 ./ocb help 查看应用办法。
还能够通过 go install 来装置。
go install go.opentelemetry.io/collector/cmd/builder@latest 要构建本人的发行版，须要应用上面的命令，通过 --config 指定配置文件，也就是上面要介绍的构建清单。
./ocb --config=builder-config.yaml如果不提供，会应用 默认的清单文件。既然咱们是要构建本人的发行版，那接来看看如何配置构建清单。
构建清单
构建清单是对 OpenTelemetry Collector 的形容，通常蕴含如下几个局部：
dist：发行版的根本信息receivers：集成的 receiver 列表exporters：集成的 exporter 列表extensions：集成的 extension 列表processors：集成的 processor 列表connectors：集成的 receiver 列表
从 GitHub 仓库中能够找到 core 发行版的构建清单，咱们能够基于该版本进行裁剪（去掉 replace 的局部）。
dist:
module: go.opentelemetry.io/collector/cmd/otelcorecol
name: otelcorecol
description: Local OpenTelemetry Collector binary, testing only.
version: 0.95.0-dev
otelcol_version: 0.95.0
output_path: /tmp/dist
exporters:
- gomod: go.opentelemetry.io/collector/exporter/debugexporter v0.95.0
- gomod: go.opentelemetry.io/collector/exporter/loggingexporter v0.95.0
- gomod: go.opentelemetry.io/collector/exporter/otlpexporter v0.95.0
- gomod: go.opentelemetry.io/collector/exporter/otlphttpexporter v0.95.0
extensions:
- gomod: go.opentelemetry.io/collector/extension/ballastextension v0.95.0
- gomod: go.opentelemetry.io/collector/extension/memorylimiterextension v0.95.0
- gomod: go.opentelemetry.io/collector/extension/zpagesextension v0.95.0
processors:
- gomod: go.opentelemetry.io/collector/processor/batchprocessor v0.95.0
- gomod: go.opentelemetry.io/collector/processor/memorylimiterprocessor v0.95.0
connectors:
- gomod: go.opentelemetry.io/collector/connector/forwardconnector v0.95.0 当初为 结尾提到的文章 构建 OpenTelemetry Collector 发行版，在 exporters 中增加 lokiexporter。在 contrib 仓库 中能够找到更多的组件。
dist:
module: go.opentelemetry.io/collector/cmd/otelcorecol
name: otelcorecol
description: Local OpenTelemetry Collector binary, testing only.
version: 0.95.0-dev
otelcol_version: 0.95.0
output_path: /tmp/dist
receivers:
- gomod: go.opentelemetry.io/collector/receiver/otlpreceiver v0.95.0
exporters:
- gomod: go.opentelemetry.io/collector/exporter/debugexporter v0.95.0
- gomod: go.opentelemetry.io/collector/exporter/loggingexporter v0.95.0
- gomod: go.opentelemetry.io/collector/exporter/otlpexporter v0.95.0
- gomod: go.opentelemetry.io/collector/exporter/otlphttpexporter v0.95.0
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/lokiexporter v0.95.0
extensions:
- gomod: go.opentelemetry.io/collector/extension/ballastextension v0.95.0
- gomod: go.opentelemetry.io/collector/extension/memorylimiterextension v0.95.0
- gomod: go.opentelemetry.io/collector/extension/zpagesextension v0.95.0
processors:
- gomod: go.opentelemetry.io/collector/processor/batchprocessor v0.95.0
- gomod: go.opentelemetry.io/collector/processor/memorylimiterprocessor v0.95.0
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourceprocessor v0.95.0
connectors:
- gomod: go.opentelemetry.io/collector/connector/forwardconnector v0.95.0 这样就筹备好了构建清单，执行上面的命令，而后在 dist.output_path 指定的目录中能够到找构建好的二进制文件。
./ocb --config=builder-config.yaml构建镜像
通过下面的办法来构建 collector 的二进制文件，进一步再构建容器镜像。
FROM golang:1.21 as build
ARG OTEL_VERSION=0.95.0
WORKDIR /app
COPY . .
RUN go install go.opentelemetry.io/collector/cmd/builder@v${OTEL_VERSION}
RUN CGO_ENABLED=0 builder --config=builder-config.yaml
FROM gcr.io/distroless/base-debian11
COPY --from=build /tmp/dist/otelcorecol /
# 4317 - default OTLP receiver
# 55678 - opencensus (tracing) receiver
# 55679 - zpages
EXPOSE 4317/tcp 55678/tcp 55679/tcp
CMD ["--config", "/etc/otelcol-contrib/config.yaml"]
ENTRYPOINT ["/otelcorecol"] 我曾经构建好了镜像 addozhang/opentelemetry-collector:0.95.0，在创立 CR OpenTelemetryCollector 的时候，能够将镜像批改为咱们定制的镜像。
关注 ” 云原生指北 ” 公众号
（转载本站文章请注明作者和出处盛世浮生，请勿用于任何商业用途）
