FAQ
Common questions about Telflo.
General
What is Telflo? A control plane for OpenTelemetry Collector configuration. You build pipelines on a canvas, Telflo generates standard Collector YAML, and you test and deploy the result to collectors. See the Introduction.
Do I need an account? You can explore the editor in the public editor without an account. You must sign in to save, test, publish, or deploy. See the Quickstart.
Can I import an existing Collector config? Yes. Paste it into the YAML view of a new configuration, and Telflo builds the canvas from it.
Pipelines
Which components are available? Receivers, processors, exporters, connectors, and extensions. The available set depends on the collector version you target. See Components.
How are pipelines defined? By the edges you draw. Each edge belongs to one pipeline (traces, metrics, logs, or a custom name), and a node can belong to several pipelines. See Canvas & pipelines.
What is the difference between validation and testing? Validation checks that a configuration is well-formed and schema-valid. Testing runs sample telemetry through it on a real collector and checks the output. See Testing.
Versions and fleets
What is the difference between saving and publishing? Saving records a private version in the editor. Publishing marks a version as a release that can be deployed. See Versions & publishing.
How do collectors get my configuration? They pull it from Telflo. You create a fleet, install collectors with its bundle, and they connect and apply the assigned configuration. See Fleet management.
How do I roll back? Set the fleet's default version to an earlier published version. Instances converge on it. See Update the configuration.
Which platforms can I install collectors on? Collectors run on Linux, on arm64 or amd64 (x86_64), in a Docker container or directly on a host. See Install collectors.
AI assistant
Why don't I see the AI tab? AI must be enabled in Settings > AI, and access may need to be requested first. See AI access.
Does the AI change my configuration? In Build mode it can, applying edits to the canvas for you to review. Ask mode only answers questions. See Modes.
Security
How do I keep credentials out of my configuration?
Reference them as environment variables with ${env:NAME}, so the value comes from the host environment rather than the stored YAML. Use vault variables (#NAME) for reusable non-secret values such as endpoints and hostnames; those are substituted directly into the configuration.