Skip to main content

Quick start

This walkthrough demonstrates FleetAMP's core workflow in a non-production environment.

1. Start FleetAMP​

Follow Installation, or use the disposable container lab.

2. Complete initial setup​

Open the FleetAMP URL, create the first administrator when prompted, sign in, and confirm the health and readiness checks. Configure TLS and authentication before remote exposure.

3. Connect a Collector​

Configure the OpenTelemetry Collector or OpAMP Supervisor with the FleetAMP OpAMP endpoint. Preserve its instance identity across restarts and report a stable logical Collector ID.

4. Create a group​

Open Groups & Labels, create an ownership group, assign a Group Owner, and select eligible unassigned Collectors or configure a controlled dynamic rule.

5. Create a configuration version​

From the group, select Create configuration version. Edit an allowed section, validate it, preview the diff and targets, then save a new immutable version.

Existing YAML can instead enter through Configuration migration.

6. Request and approve deployment​

Enter a change reason, assign a different eligible reviewer, and submit the exact version. The reviewer confirms validation, target snapshot, selector, reason, and diff before approving or rejecting.

7. Verify operation​

Use Deployments to follow rollout state, Fleet to compare desired and effective configuration, and Audit Log to confirm the complete evidence chain. A failed governed rollout records rollback or recovery evidence.