froog

FROOG PING — UPTIME MONITORING AND STATUS PAGES

Checks your sites, ports and cron jobs, and tells you when one goes down. Your users get a status page on your own domain, with 90 days of uptime and what you're doing about it.

HTTP, TCP, ping and heartbeatsEmail and webhooksStatus page on your domain

Freefor 5 monitors checked every 5 minutes. $1 a month for each one beyond, or checked faster.

status.acme.exampleSubscribe

All systems operational

  • WebsiteHTTPS142 ms99.97%
  • APIHTTPS88 ms99.96%
  • DatabaseTCP 543221 ms99.99%

MaintenanceDatabase upgrade, Sat 02:00–02:30 UTC

01 / Checks

Websites, ports, hosts and cron jobs

froog ping add https://example.com and froog checks it from our servers. A monitor is called down after 2 failed checks in a row, or as many as you choose, and a failure is re-checked quickly to confirm it.

  • HTTP(S)The status codes you expect, a keyword that must or must not be on the page, how long it took to answer, and a warning before the TLS certificate expires
  • TCPA port that should accept connections: a database, a mail server, SSH
  • PingAn ICMP ping to a host
  • HeartbeatYour cron job calls a URL of its own when it runs. If the call doesn't arrive on time, the monitor goes down. A job that knows it failed calls …/fail instead
crontab
# the nightly backup checks in when it's done, or says it failed
0 3 * * *  ./backup.sh && curl -fsS "$PING_URL" || curl -fsS "$PING_URL/fail"

02 / Alerts

Know before your users do

When a monitor goes down or comes back, froog emails your account. Webhooks send the same news to Slack, a pager or your own code.

  • EmailTo your account, when a monitor goes down and when it's up again
  • ping.monitor.downA monitor failed enough checks in a row to be called down
  • ping.monitor.upIt answers again
  • ping.cert.expiringA site's TLS certificate expires soon

Webhooks are signed the same way as froog's other webhooks.

03 / Status pages

A status page on your own domain

Every project gets a public status page. froog ping page create acme puts it at status.froogusercontent.com/acme, or point status.yourco.com at it.

  • Your domainA CNAME record, and a TXT record to prove the domain is yours. The HTTPS certificate is issued automatically
  • On the pageOverall status, each monitor with 90 days of daily uptime bars and its uptime, current incidents, scheduled maintenance and past incidents
  • No JavaScriptThe page is plain HTML. It loads fast and works anywhere
  • JSON and a badgeA JSON summary for your own tools, and an SVG badge for a README

04 / Incidents

Say what's wrong, and when it's fixed

Post an incident and update it as you go. Schedule maintenance ahead of time. Visitors can subscribe by email to get each update.

Some API requests failResolved

  1. ResolvedError rates are back to normal.
  2. MonitoringThe fix is out. We're watching it.
  3. IdentifiedA bad deploy. We're rolling it back.
  4. InvestigatingSome requests to the API fail.
  • AutomaticOptionally, a monitor going down opens an incident on the page by itself, and resolves it when the monitor recovers
  • MaintenanceSchedule a window and it's on the page before it starts
  • SubscribersVisitors sign up by email with double opt-in, and every email has a one-click unsubscribe

05 / FAQ

Questions

When is a monitor called down?

After a number of failed checks in a row that you choose, 2 by default. A failed check is re-checked quickly to confirm it, so one dropped packet doesn't wake anyone up and a real outage is still caught fast.

Where do the checks run from?

From froog's servers, on the hardware we operate.

What does a custom domain need?

A CNAME record that points your name, for example status.yourco.com, at froog, and a TXT record that proves the domain is yours. The HTTPS certificate is issued and renewed automatically.

Does the status page use JavaScript?

No. It is plain HTML, so it loads fast and works anywhere. For your own tools there is a JSON summary, and an SVG badge for a README.

How does billing work?

5 monitors checked every 5 minutes are free. Each monitor beyond those costs $1 a month, and so does each monitor checked more often, down to every 30 seconds. Status pages, custom domains, incidents and subscribers are included.

GET STARTED

Five monitors, free

Checked every 5 minutes. $1 a month for each monitor beyond those, and for each one checked faster, down to every 30 seconds. Status pages, custom domains, incidents and subscribers are included. Install the CLI, log in with your browser, then froog ping add https://example.com.

curl -fsSL https://froogcorp.com/install | sh