Skip to content

Slack

Send TSDProxy status alerts to a Slack channel using an incoming webhook.

Setup

  1. Create a Slack app with incoming webhooks enabled
  2. Or use the legacy Incoming Webhooks integration
  3. Copy the webhook URL — it looks like https://hooks.slack.com/services/T00/B00/xxx

Configuration

/config/tsdproxy.yaml
webhooks:
  - url: "https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
    type: slack
    events:
      - Running
      - Stopped
      - Error

Message Format

TSDProxy sends a Block Kit formatted message:

  • Fallback text: TSDProxy: Proxy 'myapp' status changed to Running
  • Block content:
    *TSDProxy Status Update*
    Proxy: `myapp`
    Status: `Running`
    Previous: `Starting`

Filtering to Critical Events

/config/tsdproxy.yaml
webhooks:
  - url: "https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
    type: slack
    events:
      - Error

Notes

  • @mention safety. If a proxy name contains @, TSDProxy inserts a zero-width space to prevent accidental mentions.
  • Multiple channels. Create separate Slack webhooks for each channel and add them as separate entries in the webhooks list.
Last updated on