When first starting
plumbervia the CLI, plumber will ask if you would like to enable telemetry. These metrics help us improve plumber by letting us know what features or functionality we need to focus on.
If telemetry is enabled, plumber will collect the following anonymous telemetry data:
- PlumberID (a unique, randomly generated ID for this plumber instance)
- Plumber version
- OS and architecture
- Plumber mode (server or CLI)
- Plumber action (read, write, relay, etc.)
- Backend used (kafka, rabbitmq, nats, etc.)
- Data format used for read or write (json, protobuf, etc.)
- If reading, whether continuous mode is used
- If using protobuf, whether file descriptors are used
- Number of connections, relays, tunnels
- Server uptime
- gRPC methods used (create relay, stop tunnel, etc.)
Telemetry data is only sent to Batch's servers and will look similar to this:
"api_key": "[api key]",
"event": "[event name]",
"distinct_id": "[plumber id]",
"timestamp": "[optional timestamp in ISO 8601 format]"
distinct_idis your plumber instance ID and is a randomly generated uuid when
plumberis first launched.
api_keyis embedded in