# teslamotors/fleet-telemetry architecture

> Architecture diagram of the GitHub repository teslamotors/fleet-telemetry, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/teslamotors/fleet-telemetry
- Repository: https://github.com/teslamotors/fleet-telemetry

## Overview

Fleet Telemetry is a Tesla vehicle telemetry server. Vehicles connect over mTLS WebSockets and push configured records; the service decodes and transforms records, dispatches them to configured outputs, and returns acknowledgements or errors. It also emits connection-state events and exposes operational monitoring. The README documents multiple datastore options and Prometheus/StatsD monitoring; source excerpts confirm key startup, streaming, record, and dispatcher behavior. Unsampled implementation details are represented only where documented, with unverified links dashed.

Main entry points: [`config/config.go`](https://github.com/teslamotors/fleet-telemetry/blob/main/config/config.go) (Configuration), [`cmd/main.go`](https://github.com/teslamotors/fleet-telemetry/blob/main/cmd/main.go) (Service startup), [`server/streaming/server.go`](https://github.com/teslamotors/fleet-telemetry/blob/main/server/streaming/server.go) (WebSocket server), [`telemetry/record.go`](https://github.com/teslamotors/fleet-telemetry/blob/main/telemetry/record.go) (Record parsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Service runtime"]
  node_startup["Service startup<br/>[main.go]"]
  node_configuration["Configuration<br/>[config.go]"]
  node_websocket["WebSocket server<br/>[server.go]"]
  node_socket["Socket processing<br/>[socket.go]"]
  node_socket_registry["Socket registry<br/>[socket_registry.go]"]
end

subgraph group_telemetry["Telemetry processing"]
  node_record["Record parsing<br/>[record.go]"]
  node_serializer["Protocol serializer<br/>[serializer.go]"]
  node_messages["Stream messages<br/>[stream_message.go]"]
  node_schemas["Vehicle schemas<br/>[vehicle_data.proto]"]
  node_connectivity["Connection events"]
end

subgraph group_dispatch["Record dispatch"]
  node_producer_rules["Dispatch rules<br/>[config.go]"]
  node_kafka["Kafka output<br/>[kafka.go]"]
  node_kinesis["Kinesis output<br/>[kinesis.go]"]
  node_mqtt["MQTT output<br/>[mqtt.go]"]
  node_mqtt_payload["MQTT encoding<br/>[mqtt_payload.go]"]
  node_redis["Redis pub/sub<br/>[redis.go]"]
  node_pubsub["Google Pub/Sub<br/>[publisher.go]"]
  node_zmq["ZeroMQ output<br/>[zmq.go]"]
  node_simple["Simple outputs<br/>[payload.go]"]
end

subgraph group_operations["Operations"]
  node_monitoring["Monitoring endpoints<br/>[metrics_server.go]"]
  node_metrics["Metrics collection<br/>[metrics.go]"]
  node_status["Status endpoint<br/>[status_server.go]"]
end

node_vehicle(("Vehicle"))
node_event_clients(("Event consumers"))
node_datastore_clients[("Configured backends")]

node_startup -->|"loads"| node_configuration
node_startup -->|"configures outputs"| node_producer_rules
node_startup -->|"starts"| node_websocket
node_startup -->|"starts"| node_monitoring
node_startup -.->|"starts"| node_status
node_vehicle -->|"streams telemetry"| node_websocket
node_websocket -->|"routes connection"| node_socket
node_websocket -->|"registers sockets"| node_socket_registry
node_socket -.->|"parses records"| node_record
node_record -->|"deserializes through"| node_serializer
node_serializer -->|"encodes protocol"| node_messages
node_record -->|"transforms protobuf"| node_schemas
node_websocket -->|"emits connection state"| node_connectivity
node_record -.->|"dispatches via"| node_producer_rules
node_configuration -->|"creates producer"| node_kafka
node_configuration -->|"creates producer"| node_kinesis
node_configuration -.->|"creates producer"| node_mqtt
node_configuration -.->|"creates producer"| node_redis
node_configuration -.->|"creates producer"| node_pubsub
node_configuration -.->|"creates producer"| node_zmq
node_configuration -.->|"configures output"| node_simple
node_mqtt -.->|"encodes payload"| node_mqtt_payload
node_kafka -->|"publishes records"| node_datastore_clients
node_redis -->|"publishes records"| node_datastore_clients
node_zmq -->|"publishes records"| node_datastore_clients
node_pubsub -->|"publishes records"| node_datastore_clients
node_event_clients -->|"consumes events"| node_connectivity
node_monitoring -->|"reports metrics"| node_metrics

click node_startup "https://github.com/teslamotors/fleet-telemetry/blob/main/cmd/main.go"
click node_configuration "https://github.com/teslamotors/fleet-telemetry/blob/main/config/config.go"
click node_websocket "https://github.com/teslamotors/fleet-telemetry/blob/main/server/streaming/server.go"
click node_socket "https://github.com/teslamotors/fleet-telemetry/blob/main/server/streaming/socket.go"
click node_socket_registry "https://github.com/teslamotors/fleet-telemetry/blob/main/server/streaming/socket_registry.go"
click node_record "https://github.com/teslamotors/fleet-telemetry/blob/main/telemetry/record.go"
click node_serializer "https://github.com/teslamotors/fleet-telemetry/blob/main/telemetry/serializer.go"
click node_messages "https://github.com/teslamotors/fleet-telemetry/blob/main/messages/stream_message.go"
click node_schemas "https://github.com/teslamotors/fleet-telemetry/blob/main/protos/vehicle_data.proto"
click node_connectivity "https://github.com/teslamotors/fleet-telemetry/blob/main/protos/vehicle_connectivity.proto"
click node_producer_rules "https://github.com/teslamotors/fleet-telemetry/blob/main/config/config.go"
click node_kafka "https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/kafka/kafka.go"
click node_kinesis "https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/kinesis/kinesis.go"
click node_mqtt "https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/mqtt/mqtt.go"
click node_mqtt_payload "https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/mqtt/mqtt_payload.go"
click node_redis "https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/redis/redis.go"
click node_pubsub "https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/googlepubsub/publisher.go"
click node_zmq "https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/zmq/zmq.go"
click node_simple "https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/simple/transformers/payload.go"
click node_monitoring "https://github.com/teslamotors/fleet-telemetry/blob/main/server/monitoring/metrics_server.go"
click node_metrics "https://github.com/teslamotors/fleet-telemetry/blob/main/metrics/metrics.go"
click node_status "https://github.com/teslamotors/fleet-telemetry/blob/main/server/monitoring/status_server.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_startup,node_configuration,node_websocket,node_socket,node_socket_registry toneBlue
class node_record,node_serializer,node_messages,node_schemas,node_connectivity,node_datastore_clients toneAmber
class node_producer_rules,node_kafka,node_kinesis,node_mqtt,node_mqtt_payload,node_redis,node_pubsub,node_zmq,node_simple toneMint
class node_monitoring,node_metrics,node_status toneRose
class node_vehicle,node_event_clients toneIndigo
```

## Components

### Service runtime

- [Service startup](https://github.com/teslamotors/fleet-telemetry/blob/main/cmd/main.go): `cmd/main.go`
- [Configuration](https://github.com/teslamotors/fleet-telemetry/blob/main/config/config.go): `config/config.go`
- [WebSocket server](https://github.com/teslamotors/fleet-telemetry/blob/main/server/streaming/server.go): `server/streaming/server.go`
- [Socket processing](https://github.com/teslamotors/fleet-telemetry/blob/main/server/streaming/socket.go): `server/streaming/socket.go`
- [Socket registry](https://github.com/teslamotors/fleet-telemetry/blob/main/server/streaming/socket_registry.go): `server/streaming/socket_registry.go`

### Telemetry processing

- [Record parsing](https://github.com/teslamotors/fleet-telemetry/blob/main/telemetry/record.go): `telemetry/record.go`
- [Protocol serializer](https://github.com/teslamotors/fleet-telemetry/blob/main/telemetry/serializer.go): `telemetry/serializer.go`
- [Stream messages](https://github.com/teslamotors/fleet-telemetry/blob/main/messages/stream_message.go): `messages/stream_message.go`
- [Vehicle schemas](https://github.com/teslamotors/fleet-telemetry/blob/main/protos/vehicle_data.proto): `protos/vehicle_data.proto`
- [Connection events](https://github.com/teslamotors/fleet-telemetry/blob/main/protos/vehicle_connectivity.proto): `protos/vehicle_connectivity.proto`

### Record dispatch

- [Dispatch rules](https://github.com/teslamotors/fleet-telemetry/blob/main/config/config.go): `config/config.go`
- [Kafka output](https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/kafka/kafka.go): `datastore/kafka/kafka.go`
- [Kinesis output](https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/kinesis/kinesis.go): `datastore/kinesis/kinesis.go`
- [MQTT output](https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/mqtt/mqtt.go): `datastore/mqtt/mqtt.go`
- [MQTT encoding](https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/mqtt/mqtt_payload.go): `datastore/mqtt/mqtt_payload.go`
- [Redis pub/sub](https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/redis/redis.go): `datastore/redis/redis.go`
- [Google Pub/Sub](https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/googlepubsub/publisher.go): `datastore/googlepubsub/publisher.go`
- [ZeroMQ output](https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/zmq/zmq.go): `datastore/zmq/zmq.go`
- [Simple outputs](https://github.com/teslamotors/fleet-telemetry/blob/main/datastore/simple/transformers/payload.go): `datastore/simple/transformers/payload.go`

### Operations

- [Monitoring endpoints](https://github.com/teslamotors/fleet-telemetry/blob/main/server/monitoring/metrics_server.go): `server/monitoring/metrics_server.go`
- [Metrics collection](https://github.com/teslamotors/fleet-telemetry/blob/main/metrics/metrics.go): `metrics/metrics.go`
- [Status endpoint](https://github.com/teslamotors/fleet-telemetry/blob/main/server/monitoring/status_server.go): `server/monitoring/status_server.go`

### Other components

- **Vehicle**
- **Event consumers**
- **Configured backends**

## Connections

- Service startup → Configuration: loads (evidence: `cmd/main.go`)
- Service startup → Dispatch rules: configures outputs (evidence: `cmd/main.go`)
- Service startup → WebSocket server: starts (evidence: `cmd/main.go`)
- Service startup → Monitoring endpoints: starts (evidence: `cmd/main.go`)
- Service startup → Status endpoint: starts (evidence: `cmd/main.go`)
- Vehicle → WebSocket server: streams telemetry (evidence: `README.md`)
- WebSocket server → Socket processing: routes connection (evidence: `server/streaming/server.go`)
- WebSocket server → Socket registry: registers sockets (evidence: `server/streaming/server.go`)
- Socket processing → Record parsing: parses records
- Record parsing → Protocol serializer: deserializes through (evidence: `telemetry/record.go`)
- Protocol serializer → Stream messages: encodes protocol (evidence: `telemetry/serializer.go`)
- Record parsing → Vehicle schemas: transforms protobuf (evidence: `telemetry/record.go`)
- WebSocket server → Connection events: emits connection state (evidence: `server/streaming/server.go`)
- Record parsing → Dispatch rules: dispatches via
- Configuration → Kafka output: creates producer (evidence: `config/config.go`)
- Configuration → Kinesis output: creates producer (evidence: `config/config.go`)
- Configuration → MQTT output: creates producer
- Configuration → Redis pub/sub: creates producer
- Configuration → Google Pub/Sub: creates producer
- Configuration → ZeroMQ output: creates producer
- Configuration → Simple outputs: configures output
- MQTT output → MQTT encoding: encodes payload
- Kafka output → Configured backends: publishes records (evidence: `datastore/kafka/kafka.go`)
- Redis pub/sub → Configured backends: publishes records (evidence: `datastore/redis/redis.go`)
- ZeroMQ output → Configured backends: publishes records (evidence: `datastore/zmq/zmq.go`)
- Google Pub/Sub → Configured backends: publishes records (evidence: `datastore/googlepubsub/publisher.go`)
- Event consumers → Connection events: consumes events (evidence: `README.md`)
- Monitoring endpoints → Metrics collection: reports metrics (evidence: `server/monitoring/metrics_server.go`)
