Fleet Telemetry

Tesla Fleet Telemetry is TeslaSync's preferred high-frequency data path. It streams vehicle signals over WSS into a Tesla-provided server, which republishes them through MQTT for TeslaSync to ingest. It supplements rather than replaces Tesla Fleet API polling.

Why use it

Capability	Polling	Fleet Telemetry
Latency	Poll-interval bound	Near real-time while the vehicle streams
API usage	Higher	Lower for state changes
Vehicle wake behaviour	May require wake/refresh	Streams when the vehicle is online + configured
Setup	Simple	Requires public TLS endpoint + Tesla setup

Architecture

Signal pipeline

Required production pieces

Requirement	Notes
Tesla Developer account	Fleet Telemetry must be enabled on your app / account
Public HTTPS/WSS endpoint	Vehicles require a publicly trusted TLS certificate
Tesla public-key URL	Serve /.well-known/appspecific/com.tesla.3p.public-key.pem unauthenticated
MQTT broker	Compose and Helm include Mosquitto by default
API config	Set FLEET_TELEMETRY_* envs (see Configuration)

Docker Compose

Fleet Telemetry is optional and runs under the telemetry profile:

docker compose --profile telemetry up -d --build

Configure the public host, TLS certificates, topic base, and Tesla Developer settings in .env and fleet-telemetry/config.json before enabling it.

Kubernetes

Use Helm values for Fleet Telemetry and the ingress/TLS. The web route must allow /.well-known without app auth so Tesla can fetch the public key.

fleetTelemetry:
  enabled: true
  host: telemetry.example.com
  port: 4443
  topicBase: "telemetry"

config:
  apiEndpoint: "http://teslasync-api.teslasync.svc.cluster.local:8080"

Check helm/teslasync/values.yaml for TLS, resources, and external Fleet Telemetry options before applying.

Public-key verification

curl https://your-domain/.well-known/appspecific/com.tesla.3p.public-key.pem

The response must be a PEM public key, served unauthenticated. Keep the private key secret.

Diagnostics

The platform exposes Tesla's Fleet Telemetry errors directly:

Endpoint	Purpose
GET /api/v1/tesla/fleet-telemetry/errors	Recent stream errors per vehicle
GET /api/v1/tesla/fleet-telemetry/error-vins	VINs currently reporting telemetry errors

The web UI surfaces these in System → Telemetry pipeline and on the per-vehicle diagnostics page.

Troubleshooting

Symptom	Check
Tesla cannot verify domain	/.well-known route bypasses app auth and returns the PEM key
No telemetry arrives	Mosquitto reachable, topic base matches config, Fleet Telemetry server logs
Live UI stale	L1 store updating, Redis L2 mirroring, signal_log appending, SSE connected
Polling still active	Expected for setup, refresh, commands, and stale-stream fallback