Overview
The Telflo editor: palette, canvas, configuration panel, and toolbar.
The editor is where you build OpenTelemetry Collector configurations. Open it by creating or opening a configuration from the configurations list. A new configuration starts blank, or from a flow, a prebuilt configuration you can edit.
Layout
The editor has the following areas.
| Area | Location | Purpose |
|---|---|---|
| Component palette | Left | Browse and drag components onto the canvas. |
| Canvas | Center | Place, connect, and arrange components into pipelines. |
| Configuration panel | Right, when a node is selected | Edit the selected component's settings. |
| Toolbar | Top | Configuration name, collector version, version controls, save, publish, share, and the AI toggle. |
| Tabs | Right panel | Switch between Configuration, YAML, and Testing. |
| AI assistant | Right edge, when opened | A docked chat panel, opened with the toolbar's AI button. |
The Testing tab appears only when testing is enabled for your account; the AI assistant appears when AI is enabled. See AI access and Testing.
The right panel can be collapsed to an icon rail with Collapse panel and expanded from the rail's icons. Opening the AI assistant collapses the navigation menu and the right panel to icon rails to make room, and closing it restores them; a panel you expand by hand while the assistant is open stays as you left it.
Toolbar
The toolbar runs along the top of the editor.
- Configuration name. Select the name to rename the configuration inline.
- Unsaved changes indicator. Shown when the configuration has edits that are not yet saved to a version.
- Collector version. Select the OpenTelemetry Collector version the configuration targets.
- Version controls. Switch between versions, rename a version, or start a new version from the current one with Create New Version.
- Undo, redo, duplicate, delete. Act on the canvas and the current selection.
- Save. Record a version.
- Publish. Publish the current version to your organization. See Versions & publishing.
- Make Public & Share. Generate a public-editor link for the current version.
- AI. Show or hide the AI assistant panel. See AI assistant.
An action cluster at the canvas's top right holds Add pipeline, Collector self-monitoring, and Clear canvas, which removes all components from the canvas. Download YAML configuration is in the YAML view's header. See YAML editor.
Collector self-monitoring
The Collector self-monitoring button, in the action cluster at the canvas's top right, opens the Collector Self-Monitoring dialog, which configures the telemetry the collector emits about itself; the settings are written to the configuration's service::telemetry section. A dot on the button indicates that self-monitoring is configured.
- Metrics. Set the verbosity level, expose a Prometheus endpoint for pulling, or push metrics over OTLP on an interval.
- Logs. Set the level, encoding, and output paths, or push logs over OTLP.
- Traces. Set the level and propagators, or push traces over OTLP.
- Resource attributes. Add attributes to the collector's own telemetry, or unset auto-generated ones.
The dialog edits only the settings it shows; other keys under service::telemetry are carried through with their values intact. Applying the dialog rewrites the YAML, so comments and formatting are not kept, and empty values anywhere in the section, such as empty strings, maps, and lists, are removed. Select Remove Section to delete the section from the configuration.
Build a configuration
- Drag components from the palette onto the canvas. See Components.
- Connect them into pipelines. See Canvas & pipelines.
- Configure each component in the configuration panel. See Configuring components.
- Review the generated YAML, or edit it directly. See YAML editor.
- Resolve any issues reported by validation. See Validation.
- Save and publish a version. See Versions & publishing.
Last updated on