DIWOS.CronMonitor 6.2.10

DIWOS.CronMonitor

A small .NET client package for sending heartbeat pings to Cron Monitor.

Version

6.2.10.0

 6 - Year of release
 2 - Month of release
10 - .NET version
 0 - Patch version

Install

Reference the package in your project:

<ItemGroup>
  <PackageReference Include="DIWOS.CronMonitor" Version="1.0.0" />
</ItemGroup>

Configuration

Add a CronMonitor section to your appsettings.json:

{
  "CronMonitor": {
    "BaseUrl": "https://cron-monitor.com",
    "PingPath": "/api/monitor/ping",
    "PingWorker": {
      "Token": "MonitorTokenForThisWorker",
      "Interval": "00:01:00"
    }
  }
}

For multiple background services, use PingWorkers:

{
  "CronMonitor": {
    "BaseUrl": "https://cron-monitor.com",
    "PingPath": "/api/monitor/ping",
    "PingWorkers": [
      {
        "Token": "MonitorTokenForThisWorker",
        "Interval": "00:01:00"
      },
      {
        "Token": "MonitorTokenForAnotherWorker",
        "Interval": "00:05:00"
      }
    ]
  }
}

DI registration

Register the client and options with dependency injection:

using DIWOS.CronMonitor;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddCronMonitorClient(builder.Configuration);

Or configure options in code:

using DIWOS.CronMonitor;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddCronMonitorClient(options =>
{
    options.BaseUrl = "https://cron-monitor.com";
    options.PingPath = "/api/monitor/ping";
});

Usage

Inject ICronMonitorClient and send a ping with your token string:

using DIWOS.CronMonitor;

public sealed class PingWorker(ICronMonitorClient client) : BackgroundService
{
    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            await client.PingAsync("MonitorTokenForThisWorker", stoppingToken);
            await Task.Delay(TimeSpan.FromMinutes(1), stoppingToken);
        }
    }
}

Background service

Register the hosted service and options:

using DIWOS.CronMonitor;
using DIWOS.CronMonitor.BgServices;
using Microsoft.Extensions.Hosting;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddCronMonitorClient(builder.Configuration);
builder.Services.AddCronMonitorPingBackgroundService(builder.Configuration);

Notes

• The token is sent as text/plain in the POST body.
• BaseUrl and PingPath are validated during startup.
• The client uses HttpClientFactory under the hood.
• It is safe to use because request URLs are controlled by the library consumer, not by the library itself.