What CoIsland watches in HTTP / JSON

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

How to monitor an endpoint from your Mac’s notch

A health endpoint, a queue depth, a public API’s list, a product page: a CoIsland monitor reads the address on its own schedule and speaks up only about what changed.

url:https://api.example.com/health path:$.status
url:https://api.example.com/stats path:$.queue.depth above:100
url:https://api.github.com/repos/swiftlang/swift/issues items:$ key:number title:title
url:https://example.com/product contains:In+stock

Connect HTTP / JSON walks through the connector, the path syntax and every monitor kind.

Connect it in three steps

  1. Add an HTTP / JSON connector. Public addresses need nothing more; for an API with a key, give its site, the header and the key.

  2. Pick a monitor kind, give the address and, for JSON, the path. Load Sample previews what the path reaches as you type it.

  3. Test runs it once; choose how often it checks and when it alerts.

Built for HTTP / JSON

  • Read only: every request is a GET, and an answer over 5 MB is not read.
  • A key goes only to the site it was given for, never to another address.
  • A live preview of the path against a sample of the real answer.
  • The key stays in the macOS Keychain.

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.

HTTP / JSON questions

How do I get notified when a JSON API value changes?

Add an HTTP / JSON connector, then a JSON value monitor with the address and the path, like $.status. The first check records the value; each different value after that opens the notch with the old and the new one.

Can it alert when a number crosses a threshold?

Yes. Pick Goes above or Goes below and give the number. It alerts once when the value crosses, stays quiet while it stays there, and alerts again only after it came back.

Can it send POST requests or log in?

No. It only sends GET, with an optional key in a header (a bearer token, an API key header, or a user and password) that goes only to the connector's site.

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