Configuration

Complete guide to configuring Telegen for your environment.

Configuration Philosophy

Telegen follows a zero-config by default approach. The only required setting is your OTLP endpoint—everything else is auto-discovered with sensible defaults.

# Minimal configuration - just the endpoint!
otlp:
  endpoint: "otel-collector:4317"

Common Exporter Pipeline

Telegen uses a unified Common Exporter Pipeline architecture. All signals (kube_metrics, node_exporter, ebpf, jfr, logs) flow through a shared OTLP exporter configured in exports.otlp. This provides:

• Single connection - Connection pooling for all signals

• Consistent config - TLS, compression, timeouts configured once

• Simplified ops - Change endpoint once, affects all signals

See Full Configuration Reference for the complete architecture diagram.

Configuration Methods

Method	Priority	Use Case
Environment Variables	Highest	Container deployments, secrets
Config File	Medium	Full configuration control
Defaults	Lowest	Zero-config deployments

Sections

• Minimal Configuration
  • Zero-Config Approach
  • Environment Variable Only
  • Minimal Config File Examples
  • What Gets Enabled by Default
  • Targeted Instrumentation
  • Enabling Additional Features
  • Next Steps
• Full Configuration Reference
  • Configuration File Locations
  • Core Configuration
  • Common Exporter Pipeline
  • OTLP Export Configuration
  • Agent Configuration
  • Collector Configuration
  • Queue Configuration
  • Retry Configuration
  • Self-Telemetry
  • Cloud Configuration
  • Signal Metadata
  • Next Steps
• Agent Mode Configuration
  • Overview
  • When to Use Agent Mode
  • Minimal Agent Configuration
  • eBPF Configuration
  • Network Tracing
  • Syscall Tracing
  • Process Discovery
  • Continuous Profiling
  • Security Monitoring
  • Log Collection
  • GPU Monitoring
  • Resource Limits
  • Kubernetes-Specific
  • Example: High-Security Environment
  • Example: Performance-Optimized
  • Next Steps
• Collector Mode Configuration
  • Overview
  • When to Use Collector Mode
  • Minimal Collector Configuration
  • SNMP Collection
  • SNMP Trap Receiver
  • SNMP Discovery
  • Storage Array Monitoring
  • Network Infrastructure APIs
  • Hybrid Mode
  • Resource Configuration
  • Example: Data Center Infrastructure
  • Next Steps
• Environment Variables
  • Overview
  • Naming Convention
  • Core Variables
  • OTLP Export Variables
  • Agent Variables
  • Collector Variables
  • Cloud Variables
  • Self-Telemetry Variables
  • Queue Variables
  • Backoff Variables
  • Usage Examples
  • Precedence
  • Secret Substitution
  • Next Steps