Table of Contents
Uptime Monitoring
TetherX includes comprehensive built-in monitoring that goes far beyond a simple up/down check. For most customers the built-in tools are everything you will ever need.
For customers who already operate an external uptime monitoring platform, TetherX also provides passwordless HTTP probe endpoints you can plug straight in, so TetherBox status appears alongside the rest of your infrastructure.
Built-In Monitoring (Recommended)
The built-in tools continuously track the health of your entire deployment - TetherBoxes, cameras, drives, alarm panels, access control systems and any monitored network device - and tell you not just what is wrong but where and how to fix it. There is nothing to install, nothing to host and nothing to configure beyond choosing who receives the alerts.
- Health Dashboard - a real-time fleet view at Admin → Health, with summary cards for at-a-glance triage and click-through to every affected resource.
- Health Report - a scheduled email report (daily, weekly or monthly) delivered to whoever you choose, with issues grouped by severity and linked directly to the affected resource and the matching troubleshooting article.
- Notifications - real-time alerts when a TetherBox, camera or monitored device changes state, with per-user control over what each person receives.
A simple HTTP probe can only answer "is this one TetherBox up and serving requests right now?". The built-in tools answer "what is the actual health of every part of my deployment, and what should I do about it?" - covering CPU and temperature, storage capacity, footage gaps, packet loss, drive health, ageing hardware and more. We strongly recommend the built-in tools as your primary monitoring, with the external probe used only to feed status into existing tooling.
External Uptime Monitoring (Optional)
If you already run an external uptime monitoring platform - perhaps because you operate a NOC, publish a status page, or want a single dashboard covering TetherX alongside your other infrastructure - TetherX provides two passwordless HTTP probe endpoints.
Monitor an Individual TetherBox
https://app.timeline.is/api/v3p/tetherboxes/SERIAL/up
Replace SERIAL with the serial number of your TetherBox. The endpoint is reverse-proxied through the encrypted VPN tunnel to the TetherBox itself, so a request only succeeds when the unit is genuinely reachable and its services are responding:
| Result | Meaning |
|---|---|
| HTTP 200 | The TetherBox is online and its services are responding |
| HTTP 5xx | The TetherBox is offline, has lost its Internet connection, or is not responding |
| HTTP 404 | The serial number does not match any TetherBox on the platform |
Monitor the TetherX Platform Itself
https://app.timeline.is/up
This is the standard health endpoint of the TetherX cloud application. A 200 response confirms the platform itself is responding - useful if you want a single status indicator for "can my team log in and view footage right now?" alongside your TetherBox probes. Any non-200 response indicates a platform-side issue.
Tip: Set your monitor's check interval to 30 seconds or longer. Every probe wakes the VPN tunnel and the TetherBox's web service, so probing more aggressively wastes battery on cellular units and adds log noise without giving you faster failure detection.
Compatible Tools
The probes return plain HTTP status codes, so they work with virtually any uptime or website monitor that can follow a URL and alert on a response code other than 200. Popular choices include:
Free / open source: Uptime Kuma, Healthchecks.io, Zabbix, Nagios, Checkmk.
SaaS monitoring services: Uptime Robot, HetrixTools, StatusCake, Better Stack, Pingdom, Site24x7, Freshping, Updown.io, Oh Dear, Datadog Synthetic Monitoring, New Relic Synthetics.
On-premises / network monitoring: PRTG Network Monitor, SolarWinds.
Warning: Tools that only perform ICMP ping checks - such as EMCO Ping Monitor - cannot be used with these endpoints. The probes are HTTP, and the TetherBox is not directly reachable by ICMP from outside the VPN. Choose a tool with an HTTP, web, URL or "synthetic" check type instead.
Setting Up
The process is the same in any compatible tool:
- Create a new monitor and choose the HTTP / website / URL check type.
- Paste in the probe URL for your TetherBox (or for the platform).
- Leave authentication blank - the endpoint is passwordless.
- Set the check interval to 30 seconds or longer.
- Configure the monitor to alert you on any response code other than 200.
- Attach whatever notification channel the tool offers (email, chat, SMS, webhook).
That is all that is required. Refer to your monitoring tool's own documentation for the exact menu names, as these vary between products and versions.
Security
- Both probes are passwordless by design so you do not need to store an API key in a third-party monitoring tool. The only information needed to probe a TetherBox is its serial number.
- The endpoints only return HTTP status codes - they do not expose camera footage, configuration, events, recordings, customer data or any TetherBox internals.
- Traffic between the TetherX platform and the TetherBox flows through the same encrypted VPN tunnel used for all other communication. See our Security Whitepaper for details.
Related Articles
- Health Dashboard - real-time fleet health view
- Health Report - scheduled email health summaries
- Notifications - real-time alerts and delivery preferences
- TetherBox Went Offline - troubleshooting an offline unit
- API Getting Started - full programmatic access via OAuth2
Referenced in: