Anonymous Analytics
Frigate can send one anonymous usage report a day. The reports show the maintainers which hardware to support, which features people use, and how releases perform. Sharing is off until you turn it on.
Turning it on​
Enable Share anonymous analytics at Settings→System→Telemetry, or set it in your config:
telemetry:
analytics: true
The same page has a Preview the report button that shows exactly what the next report contains.
How it's sent​
- Once a day, as a JSON POST to
https://analytics.frigate.video/report - The server looks up your country and region from your IP address and never stores the address
- Raw reports are kept for 60 days; only aggregate totals are published
- A random install ID, stored in
/config/.analytics.json, keeps your install from being counted twice. Turning sharing off deletes it
What's never sent​
- Camera, zone, group, profile, or user names
- Object labels, face names, or license plate text
- IP addresses, hostnames, URLs, or stream paths
- Credentials or API keys
- Events, recordings, or anything from them
Every field​
Fields marked public appear in the published totals. The machine-readable schema is frigate-analytics-schema.json.
| Field | Description | Public |
|---|---|---|
cameras | Cameras, null if its collector failed | Yes |
cameras.audio | Cameras with audio detection on | Yes |
cameras.audio_transcription | Cameras with audio detection and transcription on | Yes |
cameras.autotracking | Cameras with PTZ autotracking on | Yes |
cameras.birdseye | Cameras in birdseye | Yes |
cameras.cameras_with_zones | Cameras with at least one zone | Yes |
cameras.connection_quality | Cameras by connection quality at send time | Yes |
cameras.detect | Cameras with detection on | Yes |
cameras.detect_fps | Cameras by detect fps | Yes |
cameras.detect_height | Cameras by detect resolution height | Yes |
cameras.enabled | Cameras enabled in config; every count below covers only these | Yes |
cameras.face_recognition | Cameras with face recognition on | Yes |
cameras.go2rtc_restream | Cameras with an input from the go2rtc restream | Yes |
cameras.hwaccel | Cameras by the resolved hwaccel preset of the detect input | Yes |
cameras.input_preset | Cameras by the input preset of the detect input | Yes |
cameras.lpr | Cameras with license plate recognition on | Yes |
cameras.motion_masks | Motion masks across cameras | Yes |
cameras.notifications | Cameras with notifications on | Yes |
cameras.object_genai | Cameras with GenAI object descriptions on | Yes |
cameras.object_masks | Object masks across cameras | Yes |
cameras.onvif | Cameras with an ONVIF host | Yes |
cameras.record | Cameras with recording on | Yes |
cameras.retain_days | Recording retention | Yes |
cameras.retain_days.alerts | Recording cameras by alert retention in days | Yes |
cameras.retain_days.continuous | Recording cameras by continuous retention in days | Yes |
cameras.retain_days.detections | Recording cameras by detection retention in days | Yes |
cameras.retain_days.motion | Recording cameras by motion retention in days | Yes |
cameras.review_genai | Cameras with GenAI review summaries on | Yes |
cameras.separate_detect_stream | Cameras whose detect input differs from their record input | Yes |
cameras.snapshots | Cameras with snapshots on | Yes |
cameras.sub_stream_record | Cameras with sub stream recording on | Yes |
cameras.total | Configured cameras | Yes |
cameras.types | Cameras by type | Yes |
cameras.zones | Zones across cameras | Yes |
detection | Object detection, null if its collector failed | Yes |
detection.detection_fps | Detections per second across cameras | Yes |
detection.models | Detection models | Yes |
detection.models[].default | Whether the model serves cameras that set no scene | Yes |
detection.models[].detector | Detector type the model runs on | Yes |
detection.models[].devices | Devices the model runs on | Yes |
detection.models[].inference_ms | Mean inference time across the model's detector processes, null before the first stats | Yes |
detection.models[].input | Model input size as WxH | Yes |
detection.models[].model_type | Model architecture | Yes |
detection.models[].source | Where the model came from | No |
detection.skipped_fps | Frames per second skipped across cameras | Yes |
features | Features, null if its collector failed | Yes |
features.audio_transcription | Audio transcription | Yes |
features.audio_transcription.enabled | Whether audio transcription is on | Yes |
features.audio_transcription.model | Transcription model, genai for a GenAI provider | Yes |
features.audio_transcription.model_size | Configured model size | Yes |
features.auth | Whether authentication is on | Yes |
features.birdseye | Birdseye | Yes |
features.birdseye.enabled | Whether birdseye is on | Yes |
features.birdseye.modes | Birdseye modes | Yes |
features.birdseye.restream | Whether birdseye is restreamed | Yes |
features.camera_groups | Camera groups | Yes |
features.classification_models | Custom classification models | Yes |
features.classification_models.object | Custom object classification models | Yes |
features.classification_models.state | Custom state classification models | Yes |
features.face_recognition | Face recognition | Yes |
features.face_recognition.device | Device the model loaded on, null when it isn't loaded | Yes |
features.face_recognition.enabled | Whether the enrichment is on | Yes |
features.face_recognition.model_size | Configured model size | Yes |
features.genai | Generative AI providers | Yes |
features.genai.providers | Configured GenAI providers by type | Yes |
features.genai.roles | Configured GenAI providers by role | Yes |
features.lpr | License plate recognition | Yes |
features.lpr.device | Device the model loaded on, null when it isn't loaded | Yes |
features.lpr.enabled | Whether the enrichment is on | Yes |
features.lpr.model_size | Configured model size | Yes |
features.mqtt | Whether MQTT is on | Yes |
features.notifications | Whether web push notifications are on | Yes |
features.plus_api_key | Whether a Frigate+ API key is set | No |
features.profiles | Profiles | Yes |
features.proxy_auth | Whether a proxy supplies the user header | Yes |
features.semantic_search | Semantic search | Yes |
features.semantic_search.device | Device the model loaded on, null when it isn't loaded | Yes |
features.semantic_search.enabled | Whether semantic search is on | Yes |
features.semantic_search.model | Embedding model, genai for a GenAI provider | Yes |
features.semantic_search.model_size | Configured model size | Yes |
features.semantic_search.triggers | Semantic search triggers across cameras | Yes |
features.tls | Whether TLS is on | Yes |
features.users | Users by role | Yes |
hardware | Hardware, null if its collector failed | Yes |
hardware.cpu_cores | Logical CPU count | Yes |
hardware.cpu_model | CPU or board model as the hardware reports it | Yes |
hardware.decode_families | Hardware decode families this system can use | Yes |
hardware.detection_hardware | Detection hardware found, as unit counts by kind | Yes |
hardware.gpus | GPUs the stats collector found | Yes |
hardware.gpus[].name | GPU name as the hardware reports it | Yes |
hardware.gpus[].vendor | GPU vendor | Yes |
hardware.memory_gb | Total memory in GB | Yes |
hardware.storage | Recordings storage | Yes |
hardware.storage.record_fs | Filesystem of the recordings volume | Yes |
hardware.storage.record_total_gb | Size of the recordings volume in GB | Yes |
hardware.storage.record_used_pct | Percent of the recordings volume in use | Yes |
health | Health, null if its collector failed | Yes |
health.cpu_percent | System CPU use at send time | Yes |
health.enrichment_ms | Mean enrichment inference times in milliseconds | Yes |
health.notices | Cumulative notice counts by kind since the install ID was created | No |
health.notices.<key>.acknowledgements | Acknowledgements since the install ID was created | Yes |
health.notices.<key>.mutes | Mutes since the install ID was created | Yes |
health.notices.<key>.occurrences | Occurrences since the install ID was created | Yes |
health.retention_unmet | Whether storage can't keep the configured retention | Yes |
health.uptime_hours | Hours since Frigate started | Yes |
install | Install, null if its collector failed | Yes |
install.arch | CPU architecture | Yes |
install.image_variant | Published image the install runs | Yes |
install.install_type | How Frigate is installed | Yes |
install.kernel | Host kernel as major.minor | Yes |
install.run_as_root | Whether the main process runs as root | Yes |
install.version | Frigate version string | Yes |
install_id | Random install identifier | No |
report_id | Random identifier of this report | No |
schema_version | Report format version | Yes |
sent_at | Unix time the report was built | Yes |