Reference
Troubleshooting
Common problems and how to resolve them.
Configuration won't validate
- Red border on a node — an error. Processors need both an input and an output; receivers need an outgoing edge; exporters need an incoming edge; extensions must not be connected. See Validation.
- Schema error on a field — the value isn't valid for the selected collector version. Correct the value, or change the collector version in the toolbar.
- Open the validation panel to see every issue with the affected node and a description.
YAML isn't updating / canvas won't rebuild
- The canvas and YAML sync both ways. If a manual YAML edit can't be parsed, the canvas can't rebuild from it — fix the syntax error flagged in the YAML view.
- Check the validation panel for the specific problem.
My changes disappeared
- Undo/Redo is session-only and clears when you close the editor. Use Save to record a version you want to keep.
- If you edited a read-only version, Telflo prompts you to save your changes as a new version — make sure you did.
A test run is stuck or failed
- Runs that can't be started (testing service unavailable, rate-limited, or you're offline) are marked Error rather than left hanging.
- Make sure a saved version is loaded and an organization is selected.
- For pipelines with long windows (
batch,tail_sampling), increase the run duration so output has time to emerge. See Running tests. - If you're warned about a fixture mismatch, your sample file's shape may not match the selected signal type — pick the right pipeline or a matching file.
A collector isn't picking up its config
- Pending pickup / Applying usually resolves on the next heartbeat — give it a cycle.
- Apply failed means the collector rejected the config. Re-validate and test it, check the collector's logs, then publish and assign a corrected version. See Update the config.
- Stale means no recent heartbeat (over 15 minutes). Check the host and the collector process; it will catch up when it reconnects.
- If a collector can't authenticate at all, its install token may have expired or been revoked — reinstall with a current token. See Tokens & security.
A new collector never appears in the fleet
- Confirm you installed with the bundle for this fleet (it embeds the correct endpoint and token).
- Newly installed collectors usually appear within a minute; if not, check the host's network egress to Telflo and the collector/supervisor logs.
I don't see the AI or Testing tab
- AI tab: enable AI in Settings → AI; request access if prompted. See AI access.
- Testing tab: it appears when testing is enabled for your editor session.
I can't manage members or the organization
- Member and organization management requires the Admin role. Contributors can build configurations but not manage the org. See Members & roles.