Understanding the three building blocks of Pinger: Agents, Devices, and Monitors
An agent is the software running at each physical location
Think of an agent as your "monitoring station" at a specific site. It's the Pinger desktop app or Docker container that runs 24/7, checking your local network devices and reporting back to the cloud.
💡 Key Point
Each physical location needs one agent. If you have 3 buildings, you need 3 agents. The free tier includes 1 agent.
Devices are the network equipment your agent monitors locally
Any networked equipment with an IP address that responds to ping. Your agent checks these devices every few seconds to make sure they're online. These are LOCAL to your network - the agent can reach them even if the internet is down.
💡 Key Point
Each agent can monitor up to 25 devices on the free tier. Devices are checked locally, so monitoring continues even if your internet goes down.
Monitors are cloud-based checks for internet-accessible endpoints
Unlike devices (which are checked locally by your agent), monitors are checked by Pinger's cloud. Use monitors to check websites, APIs, or any public endpoint. Perfect for monitoring your own website uptime or external services you depend on.
Check if a website or API is responding (e.g., https://example.com)
Check if a specific port is open (e.g., database on port 5432)
Verify DNS resolution is working (e.g., example.com resolves correctly)
💡 Key Point
Monitors are unlimited on the free tier and don't require an agent. They're checked from the cloud every 5 minutes.
| Agents | Devices | Monitors | |
|---|---|---|---|
| What is it? | Software installation | Local network equipment | Cloud-based checks |
| Where? | At each location | On your LAN | Internet-accessible |
| Free tier limit | 1 agent | 25 per agent | Unlimited |
| Check frequency | 30s heartbeat | 15s-12min | 5 minutes |