Traefik Helm Chart 监控与日志：Prometheus 集成教程

【免费下载链接】traefik-helm-chart 项目地址: https://gitcode.com/gh_mirrors/tra/traefik-helm-chart

Traefik 是一款功能强大的云原生反向代理和负载均衡工具，通过 Traefik Helm Chart 部署后，集成 Prometheus 监控和日志收集能帮助开发者实时掌握服务运行状态。本教程将详细介绍如何通过 Helm Chart 配置 Traefik 的 Prometheus 监控与日志功能，无需复杂代码即可实现专业级可观测性。

快速了解 Traefik 监控配置

Traefik Helm Chart 内置了完善的监控支持，主要通过 values.yaml 文件进行配置。核心监控功能包括：

• Prometheus 指标暴露：默认启用，通过 /metrics 端点提供详细的性能数据
• ServiceMonitor 自动发现：与 Prometheus Operator 无缝集成
• 访问日志配置：记录所有 HTTP 请求的详细信息
• 指标标签自定义：可添加 entrypoints、routers 和 services 标签

核心配置文件位置

监控相关的关键配置文件路径：

• 主配置：traefik/values.yaml
• ServiceMonitor 模板：traefik/templates/servicemonitor.yaml
• 测试配置示例：traefik/tests/values/prometheusrules.yaml

一键启用 Prometheus 监控

启用 Traefik 的 Prometheus 监控只需修改 values.yaml 中的 metrics 部分，无需复杂的手动配置。

基础配置步骤

1. 编辑 values.yaml，确保 Prometheus 配置已启用：

   metrics:
     prometheus:
       entryPoint: metrics  # 指标暴露端点
       addEntryPointsLabels: true  # 启用入口点标签
       addRoutersLabels: true      # 启用路由器标签
       addServicesLabels: true     # 启用服务标签
   

2. 配置指标端口（通常已默认配置）：

   ports:
     metrics:
       port: 9100           # 指标端口
       expose: false        # 不对外暴露，仅集群内部访问
       protocol: TCP
   

3. 部署或升级 Helm Chart：

   helm repo add traefik https://traefik.github.io/charts
   helm install traefik traefik/traefik -f values.yaml
   # 或升级现有部署
   helm upgrade traefik traefik/traefik -f values.yaml
   

配置 ServiceMonitor 实现自动发现

对于使用 Prometheus Operator 的环境，Traefik Helm Chart 提供了 ServiceMonitor 资源，可实现监控目标的自动发现。

启用 ServiceMonitor

在 values.yaml 中添加以下配置：

metrics:
  prometheus:
    serviceMonitor:
      enabled: true
      interval: 15s                # 抓取间隔
      scrapeTimeout: 5s            # 抓取超时时间
      honorLabels: true            # 保留指标原有标签
      # 添加自定义标签（可选）
      additionalLabels:
        monitoring: traefik

ServiceMonitor 配置会生成对应的 Kubernetes 资源，Prometheus 将自动发现并开始抓取 Traefik 指标。相关模板定义在 traefik/templates/servicemonitor.yaml 中。

配置 Prometheus Rules 实现告警

Traefik Helm Chart 支持配置 Prometheus 告警规则，帮助及时发现异常情况。

添加告警规则

在 values.yaml 中配置：

metrics:
  prometheus:
    prometheusRule:
      enabled: true
      rules:
        - alert: TraefikDown
          expr: up{job="traefik"} == 0
          for: 5m
          labels:
            severity: critical
          annotations:
            summary: "Traefik 服务不可用"
            description: "Traefik 实例 {{ $labels.pod }} 已宕机超过5分钟"
            
        - alert: HighErrorRate
          expr: sum(rate(traefik_http_requests_total{code=~"5.."}[5m])) / sum(rate(traefik_http_requests_total[5m])) > 0.05
          for: 2m
          labels:
            severity: warning
          annotations:
            summary: "Traefik 错误率过高"
            description: "5xx错误率超过5%，当前值: {{ $value | humanizePercentage }}"

日志配置与收集

Traefik 提供两种日志类型：访问日志和普通日志，通过 values.yaml 可轻松配置。

启用访问日志

logs:
  general:
    level: INFO  # 普通日志级别：DEBUG, INFO, WARN, ERROR
  access:
    enabled: true
    format: json  # 日志格式：common (CLF) 或 json
    # 可选：输出到文件
    # filePath: "/var/log/traefik/access.log"
    fields:
      general:
        defaultmode: keep
        names:
          ClientUsername: drop  # 不记录客户端用户名
      headers:
        defaultmode: drop
        names:
          User-Agent: keep      # 保留User-Agent头
          Content-Type: keep    # 保留Content-Type头

集成日志收集工具

如需将日志发送到 ELK 或 Loki 等系统，可通过添加 sidecar 容器实现：

deployment:
  additionalContainers:
    - name: logshipper
      image: your-logshipper-image:latest
      volumeMounts:
        - name: traefik-logs
          mountPath: /var/log/traefik
  additionalVolumes:
    - name: traefik-logs
      emptyDir: {}

验证监控配置

部署完成后，可通过以下方式验证监控是否正常工作：

1. 检查 metrics 端点：

   kubectl port-forward $(kubectl get pods -l app.kubernetes.io/name=traefik -o name) 9100:9100
   curl http://localhost:9100/metrics
   

2. 在 Prometheus UI 中查看目标： 访问 Prometheus 界面，在 "Targets" 页面查看 traefik 相关目标是否处于 "UP" 状态。

3. 查看 ServiceMonitor 状态：

   kubectl get servicemonitor traefik -o yaml
   

常见问题解决

问题1：Prometheus 无法发现 Traefik 指标

• 解决方案：检查 ServiceMonitor 是否正确创建，标签选择器是否匹配 Traefik 服务标签
• 验证命令：kubectl describe servicemonitor traefik

问题2：指标中缺少 entrypoints 或 routers 标签

• 解决方案：确保 values.yaml 中启用了相关标签：

  metrics:
    prometheus:
      addEntryPointsLabels: true
      addRoutersLabels: true
      addServicesLabels: true
  

问题3：访问日志不记录或格式错误

• 解决方案：检查日志配置是否正确，确保 volume 挂载正常
• 验证命令：kubectl exec -it <traefik-pod> -- cat /var/log/traefik/access.log

通过以上步骤，您已成功配置 Traefik Helm Chart 与 Prometheus 的集成，实现了对 Traefik 服务的全面监控和日志收集。这些配置可根据实际需求进一步调整，以满足不同环境的监控需求。

【免费下载链接】traefik-helm-chart 项目地址: https://gitcode.com/gh_mirrors/tra/traefik-helm-chart