Grey
Best in class health probing for all of your production endpoints.
Lightweight
With an average memory footprint of just 4MB, Grey is designed to be effectively free to run across your infrastructure while providing exceptional visibility.
Trivial Configuration
Grey's intuitive YAML configuration makes defining and deploying new probes a breeze.
Best in Class Observability
With native OpenTelemetry integration and trace propagation, it has never been easier to dive into the cause of a probe failure.
Grey is a synthetic monitoring tool designed to help you measure and understand customer impacting outages within minutes. It is designed to be trivially lightweight, letting you run it anywhere in your infrastructure or on the cheapest public cloud instances money can buy, giving you exceptional breadth of visibility and high signal to noise ratios.
Features
- Extremely low memory footprint allows you to run Grey in resource constrained environments at low cost.
- Native ARM binaries allow you to run Grey on embedded Linux devices like Raspberry Pis for cheap distributed probing.
Example
# Directory to store probe state for persistence across restarts
state: ./state/
probes:
- name: google.search
policy:
interval: 5s
timeout: 2s
retries: 3
target: !Http
url: https://google.com?q=grey+healthcheck+system
validators:
http.status: !OneOf [200]
http.header.content-type: !Equals "text/html; charset=ISO-8859-1"
tags:
service: Google
ui:
enabled: true
listen: 127.0.0.1:3002
title: My Status Page
logo: https://example.com/logo.png
links:
- title: GitHub
url: https://github.com/SierraSoftworks/grey
notices:
- title: Example Notice
description: This is an example notice message showcasing how you can alert users to something happening on your platform.
timestamp: 2025-08-10T19:00:00Z
level: ok # ok, warning, error