Pingtower Docs
Docs The service The service

The service

The inbound half. It ingests structured log lines, recovers each message's shape, evaluates declarative rules, and keeps alert state with re-notify escalation until a human acknowledges.

The service is one Go binary with SQLite inside it. It runs hosted at api.pingtower.com and, unchanged, on your own box. Every page in this section applies to both.

ingesttemplate + deduprulesalertrenotify · escalatedeliver

A line arrives with a level and a message. Its shape is recovered so repeats collapse into one alert with a count. Every rule in the project is evaluated against it. A rule that fires opens an alert, and the alert re-pages on the rule’s cadence and climbs its escalation ladder until someone acks. Delivery goes to the iOS app by push and to anything else through integrations.

In this section

IngestOne endpoint, one JSON object per line, one bearer token per source. Everything Pingtower knows starts here. RulesA rule says what to look for, how much of it is a problem, and what to do about it. Rules are per project, declarative, and editable from the phone. Alerts & escalationAn alert has three states and two verbs. Everything about paging follows from that. Log tail & templatesThe actual lines behind an alert, filtered to the shape that matched. Kept only for sources that ask for it. Projects & sourcesA project is a namespace inside a tenant. A source is one thing that sends into it, with its own token. IntegrationsTell something other than your phone. Every integration keeps a per-event delivery log, so when Slack goes quiet you can see whether it was you or them. ActionsA runbook action is an HTTP call the service makes for you when an alert opens. Restart the worker, open the ticket, flip the feature flag, before anyone wakes up. On-call schedulesA schedule answers "who is on call right now". Rules name schedules in their escalation ladders, so the rule never changes when the rota does. ReportsA running incident report with a shareable status page. Write it in Markdown from the phone while the incident is still going. Team & accountInvite teammates, manage members, mint and revoke API keys, and read the audit log of who did what. Plans & quotasLimits are per tenant. Usage against them is on the Account → Plan & usage screen in the app and at GET /v1/tenants/{tid}/plan.
Last updated 1 Sep 2026 Report a problem with this page