pythonicshahdev/otel-fanout-control-plane

•Updated 8 days ago

control plane for managing OTel Collector fan-out consumers — toggle, credentials, live pipeline

Image

331

pythonicshahdev/otel-fanout-control-plane repository overview

⁠OTel Fanout Control Plane

A browser-based management UI for the Boomi Observability Stack. Effortlessly toggle trace consumer destinations on/off, store credentials, discover OTLP sources, and configure index retention policies — all without editing raw YAML files.

⁠✨ Control Plane Features

🔀 Trace Consumers Tab: Enable or disable external destinations like New Relic, Datadog, Splunk, and Dynatrace for trace fanout.
🔍 Sources Tab: Auto-discover active OTLP services transmitting telemetry.
🗓️ Retention Tab: Configure OpenSearch Index State Management (ISM) retention policies (default: 30 days).
📊 Pipeline Diagram: Interactive visual overview of your live telemetry data flow.

⁠🏗️ Architecture

┌──────────────────┐
│  Logs + Metrics  │ ──► Vector (:4317 / :4318) ────────► OpenSearch (:9200)
└──────────────────┘
┌──────────────────┐
│      Traces      │ ──► OTel Collector (:4319 / :4320) ──► OpenSearch (:9200)
└──────────────────┘                                     └──► Consumer Fanout (Toggled via UI)

⁠🚀 Quick Start & Deployment

⁠1. Full Stack Deployment (Recommended)

Run the entire observability stack using Docker Compose:

curl -O https://raw.githubusercontent.com/pythonicsshahdev/otel-fanout-quickstart/main/docker-compose.yml
docker compose up -d

Or run the lightweight automated installation script (no Compose required):

curl -O https://raw.githubusercontent.com/pythonicsshadev/otel-fanout-quickstart/main/install-boomi-stack.sh
chmod +x install-boomi-stack.sh
./install-boomi-stack.sh

⁠2. Standalone Container Run

To deploy the Control Plane container independently:

# 1. Create network & named volumes
docker network create boomi-net
docker volume create consumers-data otel-config prometheus-config

# 2. Launch the Control Plane container
docker run -d \
  --name control-plane \
  --network boomi-net \
  -p 8090:8090 \
  -e CONSUMERS_PATH=/data/consumers.json \
  -e TEMPLATE_PATH=/templates/otel-collector-config.hbs \
  -e CONFIG_OUTPUT_PATH=/config/otel-collector-config.yaml \
  -e COLLECTOR_CONTAINER=otel-collector \
  -e DEPLOY_TARGET=compose \
  -e CONTROL_PLANE_USER=admin \
  -e CONTROL_PLANE_PASSWORD=changeme \
  -v consumers-data:/data \
  -v otel-config:/config \
  -v prometheus-config:/prometheus-config \
  -v /var/run/docker.sock:/var/run/docker.sock \
  pythonicshahdev/otel-fanout-control-plane:latest

⁠🔐 Accessing the UI

URL: https://localhost:8090
Default Credentials:
Username: admin
Password: changeme
Note: Accept the self-signed HTTPS certificate warning in your browser upon initial launch.

⁠🏷️ Image Tags

Tag	Description	Architecture
`latest`	Most recent build	Multi-arch (`amd64`, `arm64`)
`2026-07-22`	Stable dated release	Multi-arch (`amd64`, `arm64`)
`boomi`	Pre-configured with Boomi-branded defaults	Multi-arch (`amd64`, `arm64`)

Tag summary

Recent tags

Content type

Image

Digest

sha256:aebb2359d…

Size

64.6 MB

Last updated

8 days ago

docker pull pythonicshahdev/otel-fanout-control-plane