Frequently Asked Questions

General

What is AdaTrack?

AdaTrack is a high-performance IoT platform for real-time tracking and geospatial analytics. It is designed to handle thousands of concurrent UDP telemetry streams with backend-defined decoding.

Can I self-host AdaTrack?

Yes, AdaTrack can be deployed on your own infrastructure (AWS EC2, Docker) for full control over your data. Refer to the Self-hosted Deploymentarrow-up-right guide.

Which IoT protocols are supported?

Currently, AdaTrack focuses on UDP for its low overhead. We provide specialized support for STM32 and generic GPS trackers. Support for MQTT and CoAP is on our roadmap.

Devices & Telemetry

How do I add a new device?

You must first create a Device Profile that defines the decoding logic (JavaScript) for your hardware. Once the profile is created, you can register individual devices by their unique IDs and HMAC keys.

What is a payload decoder?

A payload decoder is a small JavaScript snippet that AdaTrack executes to convert binary telemetry data into a JSON format. You can update decoders in real-time without restarting the platform.

How is telemetry data secured?

AdaTrack uses HMAC-SHA256 for authenticating UDP packets. Each device has a unique shared secret. We also use timestamps to prevent replay attacks.

Billing & Quotas

How does the usage-based billing work?

AdaTrack tracks "Billable Events," such as telemetry packets processed, reports generated, and workflow executions. You are billed based on your subscription tier and actual usage recorded in the Usage Ledger.

What happens if I exceed my quota?

If you exceed your account quota (e.g., maximum number of geofences or monthly reports), AdaTrack will send a notification. Depending on your tier, further actions may be limited until the quota is increased or reset.

Support

How can I report a bug?

Please open an issue on our GitHub repositoryarrow-up-right or contact support directly via our Discord community.

Last updated