Prerequisites
- Flexprice API key
- Event source (Kafka, webhooks, database)
Quick Start with Docker
1. Createconfig.yaml:
Kubernetes Deployment
1. Create Secret:Configuration
Batching
Tune based on event volume:- Low volume (< 100/min):
count: 5, period: 5s - Medium volume:
count: 10, period: 2s(default) - High volume (> 1000/min):
count: 50, period: 1s
Kafka Performance
Troubleshooting
Events not batching?- Increase
fetch_buffer_capin Kafka input - Check event volume is sufficient
- Rebuild binary if code changed
- Verify API key is correct
- Check Kafka broker addresses
- Ensure
external_customer_idexists in Flexprice
- Reduce
fetch_buffer_cap - Lower
max_in_flight - Set resource limits
Environment Variables
| Variable | Description | Example |
|---|---|---|
FLEXPRICE_API_KEY | Flexprice API key | fp_live_abc123... |
FLEXPRICE_API_HOST | API hostname | https://api.flexprice.io |
KAFKA_BROKERS | Kafka brokers | broker:9092 |
Observability
The collector exposes Prometheus metrics at/metrics:
http://localhost:4195/metrics
Next Steps
- How It Works - Architecture and advanced config
- Bento Docs - Full Bento documentation

