Telflo
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.

On this page