Deployment
Overview
How Telflo deploys configurations to real collectors using fleets and OpAMP.
Deployment connects a configuration you built in Telflo to the collectors running in your infrastructure. Instead of copying YAML around by hand, your collectors connect back to Telflo and pull their configuration automatically, then report their status.
How it works
Telflo uses OpAMP (the Open Agent Management Protocol) to manage collectors remotely:
Published version → Fleet (issues token + install files)
│
install on your hosts
▼
Collectors connect back via OpAMP → pull config, report status- You publish a configuration version.
- You create a fleet from that published version. The fleet issues an install token and install files.
- You install collectors on your hosts using those files. Each collector runs a supervisor that speaks OpAMP.
- Collectors phone home to Telflo, pull their assigned configuration, apply it, and report back whether it applied successfully.
- You watch the fleet converge from the fleet dashboard.
Key terms
| Term | Meaning |
|---|---|
| Fleet | A named group of collectors that share a configuration. Created from a published version. |
| Instance | A single running collector that has connected to a fleet. |
| Install token | A credential baked into the install files that authenticates a collector to its fleet. Can expire and be rotated/revoked. |
| Served config | The configuration version Telflo has delivered to an instance. |
| Assigned config | The configuration version an instance is supposed to run. |
| Drift | When an instance's served config doesn't match its assigned config yet. |
What you need first
- A configuration with a published version (see Versions & publishing), or an existing collector config you want to adopt (see the import existing option in Create a fleet).
- Hosts where you can install a collector.
Where to go next
- Create a fleet — set up a deployment and get your token.
- Install collectors — Docker, Linux, and all-in-one bundles.
- Monitor the fleet — instance status and health.
- Update the config — roll out a new version.