# Dockbix agent

## 一.概述

Dockbix意为docker+zabbix，即使用zabbix来监控docker容器的插件或者模块，既然有专业的cadvisor、prometheus等容器监控方案，为什么还要用传统的zabbix呢？

* 在docker刚出现时，还没有专业的容器监控方案
* 公司已有zabbix的成熟实践，想直接集成到zabbix中(虽然不太优雅)

使用zabbix来监控docker有几种方案，比如:

* 自己写agent，利用docker的api获取stats信息，暴露api接口给zabbix采集
* 使用zabbix的Module，将docker的采集展示集成到现有的zabbix系统中

## 如何使用

### 写API

python sdk：<https://docker-py.readthedocs.io/en/stable/containers.html#docker.models.containers.Container.stats>

```yaml
stats(**kwargs)
Stream statistics for this container. Similar to the docker stats command.

Parameters:    
decode (bool) – If set to true, stream will be decoded into dicts on the fly. Only applicable if stream is True. False by default.
stream (bool) – If set to false, only the current stats will be returned instead of a stream. True by default.
Raises:    
docker.errors.APIError – If the server returns an error.
```

如计算cpu：

```python
def calculate_cpu_percent(d):
    cpu_count = len(d["cpu_stats"]["cpu_usage"]["percpu_usage"])
    cpu_percent = 0.0
    cpu_delta = float(d["cpu_stats"]["cpu_usage"]["total_usage"]) - \
                float(d["precpu_stats"]["cpu_usage"]["total_usage"])
    system_delta = float(d["cpu_stats"]["system_cpu_usage"]) - \
                   float(d["precpu_stats"]["system_cpu_usage"])
    if system_delta > 0.0:
        cpu_percent = cpu_delta / system_delta * 100.0 * cpu_count
    return cpu_percent
```

### Zabbix Module

通过部署一个zabbix agent的docker容器来监控宿主机器和宿主机器上docker的状态。

搬运下开源项目：<https://github.com/monitoringartist/zabbix-docker-monitoring>

**1.在需要监控的宿主机器上运行运行Agent容器**

```bash
docker run \
  --name=dockbix-agent-xxl \
  --net=host \
  --privileged \
  -v /:/rootfs \
  -v /var/run:/var/run \
  --restart unless-stopped \
  -e "ZA_Server=<ZABBIX SERVER IP/DNS NAME/IP RANGE>" \
  -e "ZA_ServerActive=<ZABBIX SERVER IP/DNS NAME>" \
  -d monitoringartist/dockbix-agent-xxl-limited:latest
```

**2.配置监控模板**

在zabbix server上导入监控docker的模版，可用模板包括：

* [Zabbix-Template-App-Docker.xml](https://raw.githubusercontent.com/monitoringartist/zabbix-docker-monitoring/master/template/Zabbix-Template-App-Docker.xml) - 标准推荐模板：被动
* [Zabbix-Template-App-Docker-active.xml](https://raw.githubusercontent.com/monitoringartist/zabbix-docker-monitoring/master/template/Zabbix-Template-App-Docker-active.xml) - 检查模板：主动
* [Zabbix-Template-App-Docker-Mesos-Marathon-Chronos.xml](https://raw.githubusercontent.com/monitoringartist/zabbix-docker-monitoring/master/template/Zabbix-Template-App-Docker-Mesos-Marathon-Chronos.xml) - Mesos (Marathon/Chronos)集群的docker模板&#x20;

也可以用docker镜像直接运行，来导入模板：[monitoringartist/zabbix-templates](https://hub.docker.com/r/monitoringartist/zabbix-templates/)，如：

```bash
docker run --rm \
  -e XXL_apiurl=http://zabbix.org/zabbix \
  -e XXL_apiuser=Admin \
  -e XXL_apipass=zabbix \
  monitoringartist/zabbix-templates
```

item为：

![](http://www.xuyasong.com/wp-content/uploads/2019/05/15541225490693.jpg)

详细的metric的值可以参考：<https://github.com/monitoringartist/zabbix-docker-monitoring/blob/master/README.md>

**3.可视化**

zabbix的监控图：

![](http://www.xuyasong.com/wp-content/uploads/2019/05/15541257580098.jpg)

grafana中也有zabbix的[数据模板](https://github.com/monitoringartist/grafana-zabbix-dashboards)

![](http://www.xuyasong.com/wp-content/uploads/2019/05/15541258462560.jpg)

本文为容器监控实践系列文章，完整内容见：[container-monitor-book](https://yasongxu.gitbook.io/container-monitor/)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://yasongxu.gitbook.io/container-monitor/yi-.-kai-yuan-fang-an/di-1-zhang-cai-ji/dockbix.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.