sysadminliip/clamav-prometheus-exporter

ClamAV Prometheus Exporter

概述

ClamAV Prometheus Exporter是一个轻量级工具，用于将ClamAV防病毒引擎的运行指标导出为Prometheus可抓取的格式。通过该工具，用户可以轻松监控ClamAV的各种关键性能指标，如扫描文件数量、检测到的病毒数量、扫描速度以及病毒库更新状态等。

核心功能和特性

• 导出ClamAV扫描相关指标（扫描文件数、扫描大小、扫描时间等）
• 提供病毒检测统计（总检测数、最近检测时间等）
• 监控病毒库更新状态和版本信息
• 支持Prometheus自动发现
• 轻量级设计，资源占用低
• 可配置的指标收集间隔
• 支持ClamAV的TCP端口连接

使用场景和适用范围

• ClamAV服务器监控
• 邮件服务器防病毒扫描监控
• 文件共享服务病毒防护监控
• 大规模ClamAV部署的集中监控
• 安全运营中心(SOC)的防病毒状态监控
• DevOps环境中的安全组件监控

使用方法和配置说明

环境要求

• Docker引擎
• 运行中的ClamAV实例
• Prometheus服务器（可选，用于指标收集和可视化）

Docker运行示例

基本运行命令：

bash
docker run -d \
  --name clamav-exporter \
  -p 9726:9726 \
  -e CLAMAV_HOST=clamav \
  -e CLAMAV_PORT=3310 \
  liip/clamav-prometheus-exporter

自定义收集间隔（默认为30秒）：

bash
docker run -d \
  --name clamav-exporter \
  -p 9726:9726 \
  -e CLAMAV_HOST=clamav \
  -e CLAMAV_PORT=3310 \
  -e SCRAPE_INTERVAL=60 \
  liip/clamav-prometheus-exporter

Docker Compose配置示例

yaml
version: '3'

services:
  clamav:
    image: clamav/clamav
    ports:
      - "3310:3310"
    volumes:
      - clamav_data:/var/lib/clamav
    restart: always

  clamav-exporter:
    image: liip/clamav-prometheus-exporter
    ports:
      - "9726:9726"
    environment:
      - CLAMAV_HOST=clamav
      - CLAMAV_PORT=3310
      - SCRAPE_INTERVAL=30
    depends_on:
      - clamav
    restart: always

  prometheus:
    image: prom/prometheus
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    ports:
      - "9090:9090"
    depends_on:
      - clamav-exporter
    restart: always

volumes:
  clamav_data:

配置参数

环境变量

导出的主要指标

Prometheus配置示例

在Prometheus配置文件中添加以下job：

yaml
scrape_configs:
  - job_name: 'clamav'
    static_configs:
      - targets: ['clamav-exporter:9726']

故障排除

• 连接问题：确保ClamAV服务正在运行且网络可访问
• 权限问题：验证exporter是否有权限连接ClamAV服务
• 指标缺失：检查ClamAV是否已执行扫描操作（部分指标需要扫描历史）
• 高CPU使用率：考虑增加指标收集间隔（SCRAPE_INTERVAL）

资源链接

• https://github.com/liip-elearning/clamav-prometheus-exporter
• ClamAV官方网站
• Prometheus官方文档