- Documentation
- Learning Hub
- Module 3 of 4 Remote configuration
Why it's safe to experiment
Safeguards
Fleet Management is designed with safety in mind.
Four safeguards
| Safeguard | What it means | Why it matters |
|---|---|---|
| Isolation | Local and remote configs run independently | Remote errors don’t break local collection |
| Fallback | Invalid configs aren’t applied | Bad syntax doesn’t stop your collector |
| Instant rollback | Deactivate pipelines with one click | Fast recovery from any problem |
| Targeted testing | Use matchers to limit blast radius | Test on one collector before fleet-wide |
What happens when things go wrong
| Scenario | What Alloy does | Your action |
|---|---|---|
| Syntax error in pipeline | Rejects config, keeps last known good | Fix syntax, re-save pipeline |
| Pipeline causes high load | Runs but collector health dashboards show warning | Deactivate pipeline, investigate |
| Wrong collectors matched | Pipeline runs on unintended collectors | Update matchers, deactivate if needed |
Script
There’s something that holds people back from using remote configuration: fear. Fear of assigning a bad config and breaking production. Fear of accidentally stopping data collection. Fear of making things worse during an incident.
These fears are reasonable—configuration management can be risky. But Fleet Management is designed with safety in mind. Here are the safeguards that make it safe to experiment.
First, isolation. Local and remote configurations run on completely separate component controllers inside Alloy. They don’t interfere with each other. If your remote configuration has a bug, your local configuration keeps running normally.
Second, fallback behavior. When Alloy polls for remote configuration and receives something invalid (maybe there’s a syntax error or a component that doesn’t exist), it doesn’t apply that config. Instead, it keeps running the last known good configuration.
Third, instant rollback. If you push a config that causes problems, you can deactivate the pipeline with one click. The collector stops running that pipeline on the next poll cycle.
Fourth, targeted testing. Because of attribute matching, you can assign a new pipeline to a single test collector first. Verify it works. Then expand to more collectors.