Documentation
DocumentationDiscussions
These docs are for v5.1. Click to read the latest docs for v2024.1.

Health Checks

The Seq.Input.HealthCheck app periodically GETs an HTTP or HTTPS URL and logs various response metrics to Seq. This can form a basis for simple alerting, trend analysis, and diagnostics.

2560

Using the events from the Health Check input to chart response times from a web page.

Seq.Input.HealthCheck is a Seq App that needs to be installed and configured before it can be used.

The app is installed once, and then an instance of the app is configured for each URL that needs to be health-checked.

Installing the Input

In Settings > Apps, select Install from NuGet:

2560

The input's package id is Seq.Input.HealthCheck:

2560

Once the app is installed, it will be shown in the app list:

2560

Checking a URL

The app will periodically issue an HTTP GET request to a specified URL. A new instance of the app needs to be run for each URL that will be checked.

Still in the apps screen, select Add Instance next to the input app's name. This will request a number of details including the URL and checking interval.

2560

Note that health check events take up space on the Seq server. The default checking interval of 60 seconds is recommended for most health checks.

📘

If the URL is an HTTPS URL, then the Seq server must trust the SSL certificate that the target server is using.

Once the instance of the app is saved, it will show in the apps list under the Health Check Input.

2560

Use the Add Instance button to check more URLs.

Health Check Events

Each time a check is completed, details of the response will be written back to the Seq event stream:

2560

The events include various properties describing the response.

If a health check fails, the event's level will be set to Error:

2560

Network failures like the one above will display a StatusCode of null, since no HTTP request could be completed. If the request is completed but the status code does not indicate success, this will be included in the event, too.

Further reading