List alertmanager-graphmail-forwarder in integrations.md

[trensetim]

Preamble

Thank you, Prometheus-Team, for creating this cool software.
I want to contribute something back to the community, so I want to share my own alertmanager receiver implementation.

Architecture

alertmanager ---webhook---> [this app] ---REST---> Microsoft Graph API ---Mail---> Recipient

The app is a python/Flask web server that receives alertmanager webhooks and forwards them via SendMail to the recipients.

The reason for having this integration is that Alertmanager cannot authenticate SMTP using SASL/XOAuth (OAuth2) when connecting with the server. Thus, integration with modern enterprise mail servers (such as MS Exchange) is no longer possible using their default configuration (with disabled SMTP BasicAuth). This integration bridges that gap for EntraID+Exchange users.

Example usage

docker run --rm -it -p $PORT:$PORT \
    -e "TO=someone@example.com,another@example.com" \
    -e "FROM=prometheus@example.com" \
    -e "CLIENT_ID=prometheus" \
    -e "TENANT_ID=$TENANT_ID" \
    -e "CLIENT_SECRET=$CLIENT_SECRET" \
    -e "AUTH_TOKEN=$AUTH_TOKEN" \
    docker-registry.timtrense.com/tim/alertmanager-graphmail-forwarder:latest

[trensetim]

[jan--f]

Thank you for your contribution. I'm afraid we need to decline this for now. We are happy to feature integrations that are actively developed and used. Unfortunately this one has so far only a limited community behind it and seemingly low adoption. Please try again at a later stage.