Troubleshooting

A configuration does not validate

• The canvas shows Errors must be corrected. when the configuration does not pass. Expand the validation status to see each issue with the affected component and a description. See Validation.
• Check the connection rules: processors need incoming and outgoing connections, receivers need an outgoing connection, exporters need an incoming connection, connectors join two pipelines, and extensions have no connections.
• 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.

YAML edits do not appear on the canvas

Editing the YAML enters manual edit mode. The canvas updates when you select Apply, which is available once the edited YAML is valid. If the YAML cannot be parsed, fix the error reported in the YAML view, or select Undo All to discard the edits. See YAML editor.

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.
• A collector that stays connected but processes no telemetry may be running the placeholder configuration served after its client token was revoked. Rotate to issue a new client token. See Tokens & security.

A new collector does not appear

• Confirm that you installed with the run command or 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.
• On a Kubernetes fleet, collectors appear once the bridge connects and reports them. Confirm the bridge installed, and that the collector's namespace was onboarded. See Kubernetes fleets.

Duplicate collectors after a container restart

A collector run from the container image keeps its identity in a named volume. If the container runs without the volume, every restart enrolls a new collector. Re-run the revealed command from the deploy dialog, which includes the volume, and delete the duplicate instances.

A Kubernetes fleet shows Unknown

Unknown means the bridge has stopped checking in, so Telflo has lost visibility; the collectors themselves may still be running. Check the bridge pod in the telflo-system namespace. A collector shown as Stale is the opposite case: the bridge is reporting, and that collector is gone from the cluster.

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.