FAQ

Q: Do I need to change my Locust tests?

Minimal changes. You only need to initialize the telemetry plugin once in locustfile.py.

Q: Which telemetry recorders are supported?
  • JSON Telemetry Recorder — structured logs (Loki, ELK, Datadog)

  • OpenTelemetry Metrics Recorder — metrics via OTLP (Prometheus, Grafana)

Q: Can I enable multiple recorders at once?

Not currently. Only one recorder (JSON or OpenTelemetry) can be enabled per run.

Q: Where is telemetry data stored?
  • JSON telemetry is emitted to stdout and handled by your log backend.

  • OpenTelemetry metrics are exported via OTLP to your metrics backend.

Q: Can I customize emitted metrics or attributes?

Yes. Both recorders support adding custom attributes.

Q: Are traces and spans supported?

Not yet. Only metrics and lifecycle events are emitted.

Q: How long is telemetry data retained?

Retention is controlled by your observability backend, not by Locust Telemetry.