BetaFree-to-use OpAMP fleet management for Windows & LinuxDownload →

Custom Binary Builder

CollectorCtrl features an integrated binary compilation interface powered by the OpenTelemetry Collector Builder (OCB). Infrastructure teams can assemble, compile, and distribute custom OTel Collector binaries directly from the web dashboard without needing local Go compilation environments.

Eliminating Binary Bloat & CVE Surface

Standard upstream OTel Contrib distributions compile in hundreds of community plugins. Using CollectorCtrl's Custom Builder lets you select only the specific receivers, processors, exporters, and extensions required by your organization — reducing RAM footprint by up to 65% and eliminating unneeded CVE attack vectors.


1. Why Build Custom Collector Binaries?

  • Reduced RAM & CPU Footprint: Stripping out unused receivers and exporters reduces background memory utilization across thousands of host nodes.
  • Custom Vendor Exporters: Include custom corporate exporters (e.g. S3 cold archiving, internal Kafka sinks, ClickHouse exporters) omitted by third-party SaaS vendor builds.
  • Simplified Vulnerability Audits: Fewer compiled dependencies simplify enterprise SAST and container vulnerability scans.

2. Step-by-Step Compilation Workflow

1

1. Select Target OS & CPU Architecture

Define destination build targets:

  • Target Operating System: windows, linux, or darwin.
  • Architecture: amd64 (x86_64) or arm64 (AArch64).
2

2. Select Required Pipeline Components

Browse and select components categorized into core OpenTelemetry building blocks:

  • Receivers: otlp, hostmetrics, windowsperfcounters, prometheus
  • Processors: batch, memory_limiter, resourcedetection, filter
  • Exporters: otlp, otlphttp, awss3, clickhouse, prometheus
  • Extensions: health_check, pprof, zpages
3

3. Execute OCB Compilation Engine

When you click Build Collector, the server generates the builder manifest and executes the ocb binary under the hood:

builder-config.yaml
1
2
3
4
5
6
7
8
9
dist:
name: otelcol-custom
description: Enterprise Custom OTel Collector
version: 0.1.0
output_path: /tmp/otelcol-builds
receivers:
- gomod: go.opentelemetry.io/collector/receiver/otlpreceiver v0.95.0
exporters:
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/awss3exporter v0.95.0
4

4. Automated Package Sync

Upon successful compilation, the server calculates the SHA-256 hash, stores the binary in the package repository, and makes it available for immediate deployment across Fleet Policies.


3. Real-Time Build Streaming & Package Sync

  • Live Compiler Console: Stream stdout/stderr compilation output in real-time as Go modules resolve and compile.
  • Automatic Package Synchronization: Compiled binaries are immediately registered in Package Management and ready for fleet-wide distribution.