-
Notifications
You must be signed in to change notification settings - Fork 27
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #14 from rpsedlak/integration
Release 1.0.0
- Loading branch information
Showing
15 changed files
with
4,946 additions
and
54 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
memkiller |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
Oops, something went wrong.