Skip to content

Commit

Permalink
Merge pull request #14 from rpsedlak/integration
Browse files Browse the repository at this point in the history
Release 1.0.0
  • Loading branch information
rpsedlak committed Dec 19, 2015
2 parents 248f265 + af78580 commit 1efc499
Show file tree
Hide file tree
Showing 15 changed files with 4,946 additions and 54 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
memkiller
26 changes: 22 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,32 @@
# zabbix-docker
# zabbix-docker 1.0.0
This repository contains monitoring code for Zabbix to discover and monitor Docker instances on Linux platforms.

This repo is not yet ready for production release.
This module once installed provides monitoring capabilities through Zabbix 2.x for Docker version 1.7 and later.

File(s):
If you experience any software defects related to this module, please notify the author by submitting an issue on [Github](https://github.com/rpsedlak/zabbix-docker/issues).

## Installation Instructions:
* Run package.sh to create the ZabbixDocker.tar.gz file.
* Copy the ZabbixDocker.tar.gz file to necessary servers.
* On the server: tar zxvf ZabbixDocker.tar.gz. It is recommended that this is done in it's own directory.
* Restart the zabbix-agent process.
* Import the ZabbixDockerTemplate.xml file into Zabbix using the GUI. You can do this from your local computer.
* Please note that if you are running a previous version of this monitoring component then you may have to completely remove the template before reinstalling it.

## Files:
* userparameter_zabbixdocker.conf - Client-side agent parameter definition
* ZabbixDockerTemplate.xml - File to be imported into Zabbix UI for "Template App Docker" template
* zabbix-docker-discover.py - Python script to provide docker instance discovery.
* zabbix-docker-stats.py - Python helper script to provide information from 'docker stats'
* zabbix-docker-convert.py - Python helper script to convert byte calculations (i.e. GB -> B)

NOTE: First integration version
## Notes:
* Approximately half of the discovered keys for a container that are available are disabled by default. You may enable these to your taste and needs. The more data you collect the more storage and processing power you will need.
* The "lifetime" setting for discovered containers is 2 days. You may vary this based on your needs through the Zabbix UI. This value only affects the cleanup of containers that are no longer available.

## Testing Information:
* This module was tested using CentOS 6.7 and Zabbix 2.0.16, 2.2.11, and 2.4.7.

## Disclaimer:
* This code is provided without warranty and responsibility rests completely on the end user for testing, etc. The author is not responsible for any production issues in any way.
* This code is licensed under [GPLv2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html).
Loading

0 comments on commit 1efc499

Please sign in to comment.