What CoIsland watches in PostgreSQL

Each monitor kind brings its own query and its own card in the notch.

How to monitor PostgreSQL from your Mac’s notch

A dashboard shows what is wrong when someone looks at it. A CoIsland monitor runs a query on its own schedule and opens the notch only when the answer changes: a new row, or a count crossing a line.

Each monitor is a file in ~/.coisland/watches:

-- name: Queries running over 5 minutes
-- kind: postgres.custom-sql
-- connector: shop
-- every: 5m
-- key: pid

SELECT pid, usename, state, now() - query_start AS running_for, query
FROM pg_stat_activity
WHERE state <> 'idle' AND now() - query_start > interval '5 minutes'

Connect PostgreSQL covers every field, TLS and each error. MySQL works the same way; all connectors share one page.

Connect it in three steps

  1. Get a host, a user and a password from your server or your provider's Connect page. A user that can only read is safest.

  2. Add a PostgreSQL connector. Test connector says who you are, the server's version and how the connection is encrypted.

  3. Pick Custom SQL, Validation or an example: each checks every 15 minutes unless you change it.

Built for PostgreSQL

  • Every check is one statement in a read-only transaction, rolled back: PostgreSQL itself refuses any write.
  • TLS is on and the certificate verified by default, by macOS, as for every other connector.
  • The password stays in the macOS Keychain and goes only to your server.
  • No driver to install: CoIsland speaks PostgreSQL's protocol itself.

Then hand it to an agent

A click on the alert opens the agent in a terminal under it, with the whole alert as its first message.

PostgreSQL questions

Can CoIsland change anything in my database?

No. Only SELECT, WITH or SHOW is accepted, each runs alone inside BEGIN READ ONLY and is rolled back, so PostgreSQL refuses a write even hidden in a CTE. A role with SELECT only, or pg_read_all_data, is safer still.

Does it work with Supabase, Neon or Amazon RDS?

Yes, with the host, user and password from their Connect page. Neon's certificate is verified by default. Supabase, RDS and Cloud SQL sign theirs with their own authority: choose Encrypted, server not verified, or trust their root certificate in Keychain Access.

Does a check load my database?

One connection and one statement per check, every 15 minutes by default. Index what the WHERE reads, and point it at a replica if you have one.

Other connectors

Put your work stack in the notch

Regular price: $59.99 Early bird price: $19.99 once, for 2 Macs. Native for Apple Silicon, macOS 14 and later.

Early bird price until October 25