Troubleshooting

A configuration does not validate

• A red border on a node is an error. Processors need an incoming and an outgoing connection, receivers need an outgoing connection, exporters need an incoming connection, connectors join two pipelines, and extensions have no connections. See Validation.
• A schema error on a field means the value is not valid for the selected collector version. Correct the value, or change the collector version in the toolbar.
• Open the validation panel to see each issue with the affected node and a description.

The canvas does not rebuild from YAML

The canvas and YAML sync both ways. If a manual YAML edit cannot be parsed, the canvas cannot rebuild from it. Fix the syntax error reported in the YAML view.

Changes are missing

• Undo and redo are session-only and clear when you close the editor. Use Save to record a version.
• If you edited a read-only version, Telflo prompts you to save the changes as a new version. Confirm that you did.

A test run is stuck or failed

• A run that cannot start, because the testing service is unavailable, rate-limited, or offline, is marked Error.
• Confirm that a saved version is loaded.
• For pipelines with longer windows, such as batch or tail_sampling, increase the run duration so output has time to appear. See Running tests.
• If you are warned about a fixture mismatch, the sample file's shape does not match the selected signal type. Select a matching pipeline or file.

A collector does not pick up its configuration

• Pending pickup or Applying usually resolves on the next heartbeat.
• Apply failed means the collector rejected the configuration. Validate and test it, check the collector logs, then publish a corrected version and set it as the fleet's default. See Update the configuration.
• Stale means no heartbeat for more than 15 minutes. Check the host and the collector process. The instance catches up when it reconnects.
• If a collector cannot authenticate, its install token may have expired or been revoked. Reinstall with a current token. See Tokens & security.

A new collector does not appear

• Confirm that you installed with the bundle for this fleet. It contains the correct endpoint and token.
• A new collector usually appears within a minute. If it does not, check the host's network access to Telflo and the supervisor logs.

The AI or Testing tab is missing

• AI tab: enable AI in Settings > AI, and request access if prompted. See AI access.
• Testing tab: it appears when testing is enabled for your account.

You cannot manage members or the organization

Member and organization management requires the Admin role. Contributors can build configurations but cannot manage the organization. See Members & roles.