Slack Manager REST API (0.30.0)
Send alerts to Slack Manager, which groups them into issues in Slack channels.
The REST API of the Slack Manager core library (github.com/slackmgr/core/restapi). It accepts alerts from monitoring systems and other clients, validates and routes them to a Slack channel, and queues them for the manager, which creates and updates issues in Slack.
The API is embedded in a host application, so the base URL, port and any authentication depend on the deployment. The default port is 8080.
The Slack channel of an alert is determined in this order:
- The
slackChannelIdfield in the alert body - The
slackChannelIdpath parameter (for the endpoints that have one) - A routing rule matching the alert
routeKey(andtype) - The fallback routing rule, if the alert has no route key
Channel names are accepted in place of channel IDs, and are mapped to IDs by the API (for channels that the Slack Manager integration is a member of).
Alerts are rate limited per Slack channel with a token bucket. A request is accepted or rejected as a whole: if any channel in the request has too few tokens left, the request is rejected with HTTP 429 and no alert is queued. All alerts and channels are validated before the rate limit is checked, so a rejected request can be retried without duplicating alerts. Accepted and rate limited requests get RateLimit-* headers (IETF draft-ietf-httpapi-ratelimit-headers-11) for the most constrained channel in the request.