Notifiers

Interaction notifiers

1: App Log

2: Discord

3: Slack

4: Webhook

Notifiers are used to send notifications to external services or log interactions to the app log.

Filters

Each notifier will accept a filter configuration option. This option will be compiled into a golang regexp object. What it is executed against depends on the event it is executing against. For HTTPX events it will be the entire HTTP request. This would be a simple example of matching a specific path prefix (GET|POST|HEAD|DELETE|PUT|PATCH|TRACE) /x/.

Be sure to check each handler for mor information on what it’s event supplies for filter matching.

1 - App Log

Log to application log

Structured loggoing output

time=2025-02-26T14:57:03.838-07:00 level=INFO msg="InteractionEvent received" xodbox.pkg=github.com/defektive/xodbox/pkg/notifiers/app_log details="HTTPX: GET /l/face from 127.0.0.1:56407"

Configuration

Key	Values
notifier	Must be `app_log`

2 - Discord

Discord notification

Discord Notification

Configuration

Key	Values
notifier	Must be `discord`
url	Webhook URL
author	Username to appear in slack. (optional) d
author_image	Emoji code to use for user’s avatar. (optional)
filter	Golang regexp.

3 - Slack

Slack notifications

Slack Notification

Configuration

Key	Values
notifier	Must be `slack`
url	Webhook URL
author	Username to appear in slack. (optional)
author_image	Emoji code to use for user’s avatar. (optional)
channel	Channel to post to, can be a user’s ID. (optional)
filter	Golang regexp.

4 - Webhook

Generic HTTP Webhook

Post logic is used by the Slack and Discord webhooks.