veertu/anka-prometheus-exporter

Anka Prometheus Exporter

概述

Anka Prometheus Exporter是由Veertu Inc.开发的Prometheus导出器，专门用于从Anka虚拟化平台收集性能指标和状态数据。该导出器将Anka平台的相关信息转换为Prometheus可识别的格式，使管理员能够使用Prometheus和Grafana等工具监控Anka环境的运行状态和性能表现。

核心功能和特性

• 收集Anka虚拟机的性能指标，如CPU使用率、内存消耗、磁盘I/O等
• 监控Anka节点和集群的状态信息
• 提供Anka模板和虚拟机实例的详细统计数据
• 支持Prometheus的指标拉取机制
• 可配置的指标收集频率和超时设置
• 轻量级设计，资源占用低

使用场景和适用范围

• Anka虚拟化平台的集中监控
• 性能问题排查和分析
• 资源使用趋势分析和容量规划
• 自动化告警配置
• 与现有监控系统集成
• Anka环境的运维和管理

使用方法和配置说明

前提条件

• Docker环境
• Prometheus服务器
• Anka虚拟化平台访问权限

Docker Run 示例

bash
docker run -d \
  --name anka-prometheus-exporter \
  -p 9876:9876 \
  -e ANKA_CONTROLLER_URL=http://anka-controller:8080 \
  -e ANKA_API_KEY=your-api-key \
  docker.xuanyuan.run/veertu/anka-prometheus-exporter:latest

Docker Compose 示例

yaml
version: '3'
services:
  anka-exporter:
    image: docker.xuanyuan.run/veertu/anka-prometheus-exporter:latest
    container_name: anka-prometheus-exporter
    ports:
      - "9876:9876"
    environment:
      - ANKA_CONTROLLER_URL=http://anka-controller:8080
      - ANKA_API_KEY=your-api-key
      - SCRAPE_INTERVAL=30s
      - TIMEOUT=10s
    restart: unless-stopped

环境变量配置

Prometheus配置

要让Prometheus收集Anka Exporter的数据，请在Prometheus配置文件中添加以下内容：

yaml
scrape_configs:
  - job_name: 'anka'
    static_configs:
      - targets: ['anka-exporter:9876']

可用指标

Anka Prometheus Exporter提供以下主要指标：

• anka_vm_running_count - 运行中的虚拟机数量
• anka_vm_stopped_count - 已停止的虚拟机数量
• anka_vm_total_count - 虚拟机总数
• anka_node_online_count - 在线节点数量
• anka_node_offline_count - 离线节点数量
• anka_template_count - 模板总数
• anka_vm_cpu_usage_percent - 虚拟机CPU使用率百分比
• anka_vm_memory_usage_bytes - 虚拟机内存使用量
• anka_vm_disk_usage_bytes - 虚拟机磁盘使用量

故障排除

常见问题

1. 无法连接到Anka Controller

   • 确保ANKA_CONTROLLER_URL环境变量设置正确
   • 验证网络连接和防火墙设置
   • 检查Anka Controller是否正常运行

2. Prometheus未收集到指标

   • 检查LISTEN_PORT是否正确配置
   • 验证Prometheus配置中的targets是否正确
   • 查看Exporter日志获取更多信息

相关资源

• Anka虚拟化平台官方文档
• https://prometheus.io/docs/
• https://github.com/veertuinc/anka-prometheus-exporter