首页 > Golang > Go教程

Golang配置Prometheus告警教程

时间：2026-03-04 08:39:51 164浏览收藏

本文详细介绍了如何在Golang应用中集成Prometheus与AlertManager构建端到端的可观测性告警体系：从使用prometheus/client_golang在代码中定义并暴露HTTP请求等核心指标，到配置Prometheus基于响应延迟等条件触发告警规则，再到通过AlertManager实现智能分组、去重及多通道（邮件、钉钉等）通知，最后给出完整的启动验证流程和生产级优化建议——手把手带你打通监控告警全链路，让Golang服务的问题发现更及时、响应更高效。

Golang如何使用Prometheus AlertManager配置告警_Golang Prometheus告警配置实践

在使用 Golang 构建微服务或后台系统时，集成 Prometheus 和 AlertManager 实现监控告警是常见的做法。Prometheus 负责采集指标并触发告警规则，而 AlertManager 则负责处理这些告警，比如去重、分组、静默和通知（如发送邮件、钉钉、企业微信等）。下面介绍如何在 Golang 项目中结合 Prometheus 客户端暴露指标，并配置 AlertManager 实现完整的告警流程。

1. Golang 中暴露 Prometheus 指标

要在 Golang 应用中支持 Prometheus 监控，需要引入官方的 prometheus/client_golang 库来暴露自定义或系统指标。

示例代码：

package main
<p>import (
"net/http"
"github.com/prometheus/client_golang/prometheus"
"github.com/prometheus/client_golang/prometheus/promhttp"
)</p><p>var (
// 定义一个计数器指标
httpRequestsTotal = prometheus.NewCounterVec(
prometheus.CounterOpts{
Name: "http_requests_total",
Help: "Total number of HTTP requests.",
},
[]string{"method", "endpoint"},
)
)</p><p>func init() {
prometheus.MustRegister(httpRequestsTotal)
}</p><p>func handler(w http.ResponseWriter, r *http.Request) {
httpRequestsTotal.WithLabelValues(r.Method, r.URL.Path).Inc()
w.Write([]byte("Hello Prometheus!"))
}</p><p>func main() {
http.Handle("/metrics", promhttp.Handler())
http.HandleFunc("/", handler)
http.ListenAndServe(":8080", nil)
}</p>

启动后访问 :8080/metrics 可看到指标输出，Prometheus 即可通过 scrape 配置拉取这些数据。

2. Prometheus 配置告警规则

Prometheus 通过 rule_files 定义告警规则，当条件满足时会将告警发送给 AlertManager。

创建告警规则文件 alert_rules.yml：

groups:
  - name: example
    rules:
      - alert: HighRequestLatency
        expr: rate(http_requests_duration_seconds_sum[5m]) / rate(http_requests_duration_seconds_count[5m]) > 0.5
        for: 2m
        labels:
          severity: warning
        annotations:
          summary: "High latency on {{ $labels.instance }}"
          description: "The average request latency is above 500ms."

在 prometheus.yml 中启用该规则：

rule_files:
  - "alert_rules.yml"
<h1>告警发送到 AlertManager</h1><p>alerting:
alertmanagers:</p>

static_configs:
- targets: ['localhost:9093']

3. 配置 AlertManager 发送通知

AlertManager 接收来自 Prometheus 的告警事件，并根据配置进行路由和通知。

示例 alertmanager.yml 配置：

route:
  group_by: ['alertname', 'severity']
  group_wait: 30s
  group_interval: 5m
  repeat_interval: 1h
  receiver: 'email-notifier'
<p>receivers:</p>

name: 'email-notifier' email_configs:
- to: 'admin@example.com' from: 'alertmanager@example.com' smarthost: 'smtp.example.com:587' auth_username: 'alertmanager@example.com' auth_password: 'password' require_tls: true

也可配置钉钉、企业微信等 webhook，例如使用钉钉机器人：

name: 'dingtalk-webhook' webhook_configs: