Running tests

The Tests sub-tab runs the configuration against sample data and lists past runs.

Sample input files

A test needs an input file of sample telemetry. When you start a run, choose the source:

• My Files. Files you have uploaded.
• Templates. Sample telemetry provided by Telflo.
• Upload. Add a new file from the My Files view.

Run a test

1. Open the Testing tab and select Tests.
2. Select Configure and run to open the Select Test File dialog.
3. Select an input file.
4. Select the Test Pipeline to run it through. The run exercises only this pipeline; other pipelines in the configuration do not run. The pipeline also selects which validation rules are evaluated.
5. Set the Run duration (seconds): 1 to 60, default 5. Increase the duration for pipelines with longer windows, such as batch with a long timeout or tail_sampling, which would otherwise produce no output in time.
6. Select Run.

Telflo remembers the last configuration you used, so the one-click Run immediately action reuses it.

If the shape of the sample file does not match the selected pipeline's signal type, Telflo warns you before running: a mismatched file decodes to zero records, so the run would likely produce no output. You can run anyway or cancel.

Run status

Each run is recorded in the history and moves through states as it executes, such as queued, running, and a final status. A run that cannot start, because the testing service is unavailable, rate-limited, or offline, is marked Error rather than left pending. Select a run to view its captured output.

A run that captured collector diagnostics shows a Logs link. Open it to read the collector's stderr, which is useful when a run produced no output or fewer records than expected. The input, output, and log viewers each have a Download action.

Requirements

• A saved version of the configuration must be loaded.
• The run uses the collector version selected in the toolbar.

Next steps

• Define pass/fail checks for output. See Validating output.
• Group reusable tests. See Test suites.