nomad-toast in an open source tool for receiving notifications based on HashiCorp Nomad events. It is designed to increase observability throughout an organisation and provide insights within chatops style environments.
nomad-toast currently supports watching the following Nomad API endpoints:
- Allocations - https://www.nomadproject.io/api/allocations.html
- Deployments - https://www.nomadproject.io/api/deployments.html
- Slack - https://slack.com/
-
The nomad-toast binary can be downloaded from the GitHub releases page using
curl -L https://github.com/jrasell/nomad-toast/releases/download/0.0.1/nomad-toast_linux_amd64 -o nomad-toast -
A docker image can be found on Docker Hub, the latest version can be downloaded using
docker pull jrasell/nomad-toast. -
nomad-toast can be built from source by firstly cloning the repository
git clone github.com/jrasell/nomad-toast.git. Once cloned the binary can be built using themakecommand.
nomad-toast supports the following global flags:
- --log-format (string: "AUTO") Specify the format of nomad-toast logs. Valid values are AUTO, ZEROLOG or HUMAN.
- --log-level (string: "INFO") The level at which nomad-toast will log. Valid values are DEBUG, INFO, WARNING, ERROR and FATAL.
- --log-use-color (bool: true) Use ANSI colors in logging output.
- --nomad-address (string: "http://localhost:4646") The HTTP(S) API endpoint for Nomad where all calls will be made.
- --nomad-allow-stale (bool: true) Allow stale Nomad consistency when making API calls.
- --slack-auth-token (string: "") The Slack API auth token for connectivity to slack.
- --slack-channel (string: "") The Slack channel to send Nomad notifications to.
Allocations triggers a watcher on the Nomad allocations endpoint and will notify you when allocations go through a state change. This can be helpful when keeping an eye on failed allocations, or just to have a general insight into allocation churn.
Deployments triggers a watcher on the Nomad deployments endpoint. This allows you to get notified of deployment activities on your cluster and allows stakeholders to gain insight.