Monitor
How to create your first monitor with OpenStatus.dev
What is a monitor? π§βπ«
A monitor is a job that runs periodically and checks the status of a service. It can be a website, an API, or anything else that can be checked automatically.
We will make a request to your endpoint on a regular schedule and record.
If the check fails, a notification is sent and an incident is created.
Configure your monitor π
Your endpoint check requires:
- a name to identify your monitor
- the URL to checked
We will store the response time, the status code, the headers returned, and the timing metrics of your endpoint.
Monitor your endpoint
HTTP Request π€
Customize the request sent to your endpoint.
Choose between one of the request HTTP Method: GET
(default), POST
or
HEAD
.
Add custom key-value HTTP Headers to your request.
OpenStatus automatically set the
"User-Agent": "OpenStatus/1.0"
header to your request. This header is used to identify the request as a ping request and can be exluded from your analytics.
If you select the POST
method, you can add a custom HTTP Body to your
request.
Advanced Configuration βοΈ
You can pause your monitor with the active switch button.
Frequency β±
Define the frequency of your checks. You can choose between: 30s
, 1m
,
5m
, 10m
(default), 30min
or 1h
.
Regions π
By default, all regions are enabled. You can disable some regions if you want to. Our regions are:
ams
- Amsterdam, Netherlands - π³π±iad
- Ashburn, Virginia, USA - πΊπΈjnb
- Johannesburg, South Africa - πΏπ¦hkg
- Hong Kong, Honkg Kong - ππ°gru
- Sao Paulo, Brazil - π§π·syd
- Sydney, Australia - π¦πΊ
Description π
The description is optional. If defined, an Info
tooltip will be added to
your monitor name.
Timeout β³
You can define a timeout for your request. The default value is 30s
.
Assertions π§ͺ
You can add assertions to your monitor. An assertion is a condition that needs to be met for the monitor to be considered successful.
You can add multiple assertions to your monitor.
We currently support the following assertions on the following fields:
- Status Code
- Response Body
Public Monitor π
You can make your monitor public by checking Allow public monitor.
Public monitor setting
A public monitor is accessible by anyone with the monitor URL. e.g. https://status.openstatus.dev/monitors/1
Public monitor
If the monitor is attached to a status page, the monitor will be displayed on the status page in the Monitors tab.