This is an automated email from the ASF dual-hosted git repository. gongchao pushed a commit to branch integte-extern-alarm in repository https://gitbox.apache.org/repos/asf/hertzbeat.git
commit 43e0aed6910caa351dfb428f3710286cf501b307 Author: tomsun28 <[email protected]> AuthorDate: Sat Jan 11 17:03:32 2025 +0800 [webapp] add alert integration Signed-off-by: tomsun28 <[email protected]> --- .../doc/alert-integration/alertmanager.en-US.md | 43 ++++++++++++++++++++-- 1 file changed, 40 insertions(+), 3 deletions(-) diff --git a/web-app/src/assets/doc/alert-integration/alertmanager.en-US.md b/web-app/src/assets/doc/alert-integration/alertmanager.en-US.md index e3fcba8621..9b57a6ffcc 100644 --- a/web-app/src/assets/doc/alert-integration/alertmanager.en-US.md +++ b/web-app/src/assets/doc/alert-integration/alertmanager.en-US.md @@ -1,9 +1,46 @@ # Prometheus Alert Integration -HertzBeat is fully compatible with Prometheus alert data format. You can configure Prometheus alerting rules to send alerts to HertzBeat. +This document describes how to send alerts from Prometheus AlertManager to the HertzBeat alert platform. -## Prometheus Alert Configuration +### Alertmanager Configuration Webhook -Add the following configuration to your Prometheus configuration file: +1. Add the webhook configuration to the Alertmanager configuration file. + ```yaml + receivers: + - name: 'webhook' + webhook_configs: + - url: 'http://${hertzbeat_host}:1157/api/alerts/report/alertmanager' + http_config: + headers: + Authorization: 'Bearer {token}' + send_resolved: true + ``` +- `http://${hertzbeat_ip}:8080/api/alerts/report` is the webhook interface address provided by HertzBeat. +- `send_resolved: true` indicates that alert recovery information will be sent. +- The {token} in `Authorization` is the token provided by HertzBeat. + +2. Restart the Alertmanager service. + +### Configuration Verification + +- Trigger Prometheus AlertManager alerts. +- Check the alert data processing in the HertzBeat alert platform to verify if the alert data is correct. + +### Data Flow: + +```mermaid +graph LR + A[Prometheus Alertmanager] --> B[Webhook] + B --> C[HertzBeat Alert Platform] + C --> D[Grouping Convergence] + D --> E[Alert Suppression] + E --> F[Alert Silence] + F --> G[Alert Center] + F --> H[Message Distribution] ``` + +### Common Issues + +- Ensure that the webhook address in the Alertmanager configuration file is correct and that the network is smooth. +- Check whether the alerts from Alertmanager are triggered and sent to the HertzBeat alert platform. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
