contiv/stats

Contiv/stats镜像说明

镜像概述

Contiv/stats镜像实现了Contiv网络与Prometheus监控平台的集成，用于在Kubernetes集群中收集Netmaster和Open vSwitch（OVS）的网络数据，并将其转化为Prometheus可识别的键值对指标，支持集群网络状态的实时监控。

核心功能

1. 数据收集：从Netmaster获取租户、网络、端点组及端点ID等信息，从OVS获取各端点的流量统计数据；
2. 数据关联：通过端点ID关联Netmaster和OVS的数据；
3. 指标转化：将关联后的数据转化为Prometheus支持的键值对格式；
4. 指标暴露：通过REST端点（Netplugin pod暴露9004端口，Netmaster pod暴露9005端口）向Prometheus提供/metrics接口。

使用场景

适用于采用Contiv网络的Kubernetes集群，需要通过Prometheus监控网络流量、租户资源使用情况及端点状态的场景。

配置说明

Prometheus配置

1. 参考https://github.com/contiv/stats_exporter/blob/master/prometheus.yml%E6%96%87%E4%BB%B6%E9%85%8D%E7%BD%AEPrometheus%EF%BC%9B
2. 将该配置文件从VM内的/var/contiv目录挂载到Prometheus的ReplicaSet（配置见https://github.com/contiv/stats_exporter/blob/master/contiv-prometheus.yml%EF%BC%89%EF%BC%9B
3. 为Prometheus配置RBAC权限，允许其获取、列出和监视pod。

Netplugin/Netmaster Exporter配置

1. Exporter作为容器与Netplugin、Netmaster pod一同部署（Dockerfile见https://github.com/contiv/stats_exporter/blob/master/Dockerfile%EF%BC%89%EF%BC%9B
2. Exporter基于Ruby和Sinatra框架实现，提供HTTP服务；
3. Netplugin pod的Exporter暴露9004端口，Netmaster pod的Exporter暴露9005端口，均通过/metrics端点提供指标。

Netplugin/Netmaster Pod注解

为Netplugin和Netmaster pod添加以下注解，使Prometheus能够自动发现并抓取指标：

• prometheus.io/scrape: 'true'
• prometheus.io/port: '9004'（Netplugin）或prometheus.io/port: '9005'（Netmaster）

OVS数据访问

通过OVS命令行接口访问本地数据库获取流量统计：

bash
ovs-vsctl --db=tcp:127.0.0.1:6640 list interface | egrep '^name|external_ids|statistics'

Docker部署示例

运行Netplugin Exporter容器：

bash
docker run -d --name contiv-stats-netplugin -p 9004:9004 contiv/stats

运行Netmaster Exporter容器：

bash
docker run -d --name contiv-stats-netmaster -p 9005:9005 contiv/stats