Configuration

After installation, the default configuration file is placed at /etc/goshawk.yml, owned by root and with permissions 0600 to prevent users from modifying it or reading API keys.

The file example_config.yaml file contains an explanation about every parameter to be configured.

Notifications

If you configure the notification URL to an empty string, goshawk will log every alert to standard output.

In this section you can find alternatives to get your notifications.

Telegram

This system is free and very simple.

1. Open a conversation with @botfather in Telegram, select the command /newbot and chose your bot name.
2. Talk to your new bot and, just after that, navigate to https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates to copy your chat id.
3. Configure the notification_url in goshawk to https://api.telegram.org/bot<YOUR_BOT_TOKEN>/sendMessage
4. Configure your template_body to "{ \"chat_id\": 120963222, \"text\": \"{{ .ServiceName }} is {{ if .IsActive }}active{{ else }}inactive{{ end }}\" }"