38 lines
1.6 KiB
Markdown
38 lines
1.6 KiB
Markdown
## Webhook server for grafana to send SMS via twilio
|
|
|
|
### Quickstart
|
|
|
|
Pull the whole thing with git.
|
|
``` git clone https://gitea.rabjerg.de/Rabjerg/grafana_twilio_webhook.git ```
|
|
|
|
Copy ``` secrets.env.sample ``` to ``` secrets.env ``` and fill it with your twilio credientals and sender/reciever phone number.
|
|
|
|
Run ``` setup.sh ``` (do NOT do this as root), this will create a new virtual environment and install the nessecary packages in said environment.
|
|
|
|
edit ``` flask_webhook_server.py ``` line 11 and 12, what server (URL and IP) is allowed to send SMS via the webhook.
|
|
|
|
now test that everything works by running ``` run.sh ```
|
|
|
|
### Setting up webhook notification in grafana.
|
|
|
|
Go to your grafana server and select "Alerting" -> "Notifications" -> "Create new notification channel"
|
|
|
|
Name: "Twilio SMS Webhook"
|
|
type: "Webhook"
|
|
URL: "http://{server_ip}:5000/grafana_webhook"
|
|
HTTP Method: "POST"
|
|
|
|
With the server running, you can now press "test" and should get a test notification per SMS.
|
|
|
|
Save and enjoy.
|
|
|
|
### Make it run on start with systemd
|
|
copy ``` .etc/systemd/system/twilio_webhook.service ``` to ``` /etc/systemd/system/twilio_webhook.service ```.
|
|
|
|
edit the ``` /etc/systemd/system/twilio_webhook.service ``` Important is that ``` ExecStart= ``` points to the absolute path of ``` run.sh ``` and ``` WorkingDirectory= ``` points to the directory with ``` run.sh ```
|
|
|
|
|
|
Now do ``` sudo systemctl daemon-reload ``` to load the new unit.
|
|
and ``` sudo systemctl start twilio_webhook.service --now ``` to start the service.
|
|
|
|
Everything should be set up and running from now on. |