Create a fleet

A fleet is a named group of collectors that share a configuration. Creating one issues the credentials and install files your collectors need to connect.

Before you start

Have a configuration with a published version ready — only published versions can be deployed. See Versions & publishing. (If you'd rather adopt an existing collector's config, use the import existing option below.)

Steps

1. Go to Fleet Management and choose New Fleet.
2. Configuration — pick the published configuration to deploy. Or choose Import existing configuration to adopt whatever YAML the first collector reports (see below).
3. Version — pick which published version to deploy. The most recently published version is selected by default.
4. Name — give the fleet a name, e.g. prod-otel-fleet. The name must be unique within your organization.
5. Token expiry — choose how long the install token stays valid: Never, 180 days, 1 year, or 2 years.
6. Click Create fleet.

When the fleet is created, Telflo shows the Fleet ID and token expiry. Install files for your collectors are available from the fleet management page — you can re-download them anytime.

Import existing configuration

Choosing Import existing configuration lets you create a fleet without selecting a published version up front. Telflo imports the YAML the first collector reports on its initial phone-home and links it to the fleet. This is the easiest way to bring an already-running collector under Telflo management.

About the install token

Each fleet carries a token that authenticates its collectors. The token is baked into the install files and identifies collectors as belonging to this fleet. You can rotate or revoke it later if it's exposed or needs renewing — see Tokens & security.

The OpAMP endpoint, token, and fleet label are injected into install bundles by Telflo and can't be spoofed by editing the bundle inputs.

Next

Install collectors using the fleet's bundles — see Install collectors.