The following integrations are optional - chiadog
is not dependent on any of them and can also run standalone. That being said, you'll get the most value out of it, when
you connect with one of the services below to receive real-time notifications about important events. You can also
enable more than one at the same time - please refer to the config-example.yaml.
Pushover is available for both Android and iOS. High priority notifications can be configured from the Pushover app to overwrite any Silence or Do-Not-Disturb modes on your phone and sound a loud alarm at any time of the day to make you aware of any issues in a timely manner.
To test live:
rm tests/cassette/pushover_notifier/*
PUSHOVER_API_TOKEN=<api_token> PUSHOVER_USER_KEY=<user_key> python3 -m unittest tests.notifier.test_pushover_notifier
Pushcut is available for both Android and iOS. High priority notifications can be configured from the Pushcut app to overwrite any Silence or Do-Not-Disturb modes on your phone and sound a loud alarm at any time of the day to make you aware of any issues in a timely manner.
Test with:
PUSHCUT_API_TOKEN=<api_token> PUSHCUT_NOTIFICATION_NAME=<notification_name> python3 -m unittest tests.notifier.test_pushcut_notifier
This integration uses SMTP to send an e-mail to a designated address. Alert information is sent in the subject line of the e-mail. There several free SMTP relay providers with reasonable limits, some require that you have a domain name to verify the sender email.
Test with:
SMTP_SENDER="[email protected]" \
SMTP_SENDER_NAME="ChiaDog" \
SMTP_RECIPIENT="[email protected]" \
SMTP_HOST=smtp.example.com \
SMTP_PORT=587 \
SMTP_ENABLE_AUTH=true \
SMTP_USERNAME=username \
SMTP_PASSWORD=password \
python3 -m unittest tests.notifier.test_smtp_notifier
Slack apps are a simple way to get notifications in a channel in your Slack workspace. Follow the instructions for Creating an App on the Getting started with Incoming Webhooks guide.
Copy & paste the Webhook URL into your config.yaml, that's it!
Test with:
SLACK_WEBHOOK_URL=<webhook_url> python3 -m unittest tests.notifier.test_slack_notifier
Discord built in Webhooks are a super simple way to get notifications sent to a text channel in
your server. Follow the instructions for Making a Webhook on
the Intro to Webhooks page. Copy & paste
the Webhook URL into your config.yaml, that's it!
Test with:
DISCORD_WEBHOOK_URL=<webhook_url> python3 -m unittest tests.notifier.test_discord_notifier
This integration uses the Telegram's Bot API. You can create a new bot for yourself by sending a message to BotFather.
For chat_id you need to enter your Telegram username or ID. For me only ID worked, you can find out your Telegram ID
by messaging the IDBot. You need to also first message your bot to make sure it knows
about you and can send you notifications.
Test with:
TELEGRAM_BOT_TOKEN=<bot_token> TELEGRAM_CHAT_ID=<your_id> python3 -m unittest tests.notifier.test_telegram_notifier
Beware: This feature is in beta stage and future versions might not maintain backward compatibility! Currently, you need to parse out information from the message text which might change. In the future there'll be a different mechanism for identifying message type and payload.
Test with:
python3 -m unittest tests.notifier.test_script_notifier
This integration uses the Paho MQTT client to send JSON-formatted messages to a remote MQTT broker. The integration allows using optional username/password verification. Instructions on setting up an MQTT broker can be found here.
Messages sent to the MQTT topic look like this:
{"type": "USER", "prio": "HIGH", "msg": "Disconnected HDD? The total plot count decreased from 70 to 0"}
Important: In order for the MQTT Notifier to work, you will need to manually install the paho-mqtt module:
pip3 install paho-mqtt
Test with:
MQTT_HOST=<hostname> MQTT_PORT=<port> MQTT_TOPIC=<mqtt_topic> python3 -m unittest tests.notifier.test_mqtt_notifier
Or with full parameters:
HOST=<hostname> PORT=<port> TOPIC=<mqtt_topic> MQTT_USERNAME=<username> MQTT_PASSWORD=<password>
QOS=<quality_of_service> RETAIN=<retain> python3 -m unittest tests.notifier.test_mqtt_notifier
Grafana is a great way to monitor your hardware. This integration automatically creates annotations on your Dashboard so that you can inspect the state of your hardware right when there was a notification triggered by Chiadog.
This is a great article on how to use Grafana and Prometheus for monitoring your hardware: https://oastic.com/posts/how-to-monitor-an-ubuntu-server-with-grafana-prometheus/
For this notifier, you will need the following credentials:
- base_url: the base url of your Grafana instance.
- api_token: instructions on how to create an API token are available here. Make sure to give the client
editorpermissions - dashboard_id: You can find the dashboard id by navigating to Settings > JSON Model within your dashboard.
- panel_id: You can find the panel id by clicking the panel and then selecting Inspect > Panel JSON
Dashboard ID and Panel ID are both optional. If left out, a global annotation will be created.
Test with:
GRAFANA_BASE_URL=<webhook_url> GRAFANA_API_TOKEN=<api_token> python3 -m unittest tests.notifier.test_grafana_notifier
Ifttt is available for both Android and iOS. Can be used to send push notifications and to integrate with various other APIs. For example if you wanted to flash a Philips hue lightbulb when you have a Chiadog notification.
Test with:
IFTTT_API_TOKEN=<api_token> IFTTT_WEBHOOK_NAME=<user_key> python3 -m unittest tests.notifier.test_ifttt_notifier
When running unit tests on Windows, you will want to use PowerShell to set environment variables like this:
$env:PUSHOVER_API_TOKEN=<api_token>
$env:PUSHOVER_USER_KEY=<user_key>
python.exe -m unittest tests.notifier.test_pushover_notifier
Remove-Item Env:\PUSHOVER_API_TOKEN
Remove-Item Env:\PUSHOVER_USER_KEY