How to send Grafana alerts to SignalK

I'd like to use SignalK as a central point of all the notifications. I set up some alerts in Grafana and would like that they are posted to SignalK.

Setting aside Grafana as a source and assuming I'm doing this from command line using

curl

curl

: what should be the high level sequence of steps to post a notification representing an alert into SignalK?

Is it necessary to login or not?
What API should be used to post a notification?

Thanks!

Tony•3/2/24, 6:00 PM

Webhooks are typically via HTTP GET. Signalk uses PUT and POST to accept a JSON payload. What is the use case why Grafana as the source? What is the source of the metrics that triggers the alarm?

TikaOP•3/3/24, 3:53 PM

The scenario is roughly the following:

I have several devices (router, raspberry pi, SailroHat, CerboGX) that report vitals like network accessibility, load, available storage, etc.
This values get stored into InfluxDB.
In Grafana, I have alerts set up for events like when network accessibility is lost, or when storage space on Cerbo runs on

The missing step is to get these alerts into SignalK so that they will eventually be presented as alerts.
My first question is what is the right way to create one new notification in SignalK. So which API should be used, does one need to authnticate first?

Tony•3/3/24, 5:06 PM

The use case is not straightforward given all of the available software. You will need to develop a plugin that will accept the webhook GET request to a new endpoint and translate that into a Signalk delta, build a proxy service and host it for translating GET into PUT, or eliminate Grafana and use something like Node-Red to poll the database and develop alerting logic in JavaScript.

Regarding your questions, you can use the Signalk websocket API to send deltas. I suggest that you read the documentation to understand how this works. If auth is configured for your Signalk server, then yes you need to setup a valid token and use it for your requests.

All of the instructions are here https://signalk.org/specification/1.5.0/doc/

Signal K Specification · Signal K Documentation

Teppo Kurki•3/3/24, 6:27 PM

You could create a webhook handler in Node-RED and raise & reset notifications there

TikaOP•3/23/24, 8:15 PM

Agree, but there are now 3 separate steps required:

TikaOP•3/23/24, 8:15 PM

Grafana -> webhook

TikaOP•3/23/24, 8:15 PM

Webhook -> node-red

TikaOP•3/23/24, 8:16 PM

Node-red -> SignalK

TikaOP•3/23/24, 8:17 PM

btw, I chose https://github.com/adnanh/webhook

TikaOP•3/23/24, 8:20 PM

The extra webhook is required bcs I was not able to make the login from Grafana into Signalk directly bcs the URL for login differs from URL for the request and there can only be one URL defined in grafana alert

Teppo Kurki•3/24/24, 12:22 PM

if I understood your point correctly: you can use to create a token that you can put in http query parameter to authenticate, no step number 2 needed

Teppo Kurki•3/24/24, 12:23 PM

if you use the SK Node-RED plugin i don't consider 3 a "step", naturally you need to pass the notification from the handler to SK server