mirror of
https://github.com/munin-monitoring/contrib.git
synced 2025-07-22 02:51:03 +00:00
[docker_] add multigraph support
Signed-off-by: Olivier Mehani <shtrom@ssji.net>
This commit is contained in:
Olivier Mehani
Lars Kruse
parent
2482518826
commit
1fa5558afd
1 changed files with 194 additions and 153 deletions
|
|
@ -4,8 +4,9 @@
|
|||
|
||||
docker_ - Docker wildcard-plugin to monitor a L<Docker|https://www.docker.com> host.
|
||||
|
||||
This wildcard plugin provides at the moment only the suffixes C<containers>, C<images>, C<status>,
|
||||
C<volumes>, C<cpu>, C<memory> and C<network>.
|
||||
This wildcard plugin provides series C<containers>, C<images>, C<status>,
|
||||
C<volumes>, C<cpu>, C<memory> and C<network> as separate graphs. It also
|
||||
supports a C<multi> suffix that provides all of those as a multigraph.
|
||||
|
||||
=head1 INSTALLATION
|
||||
|
||||
|
|
@ -14,6 +15,12 @@ C<volumes>, C<cpu>, C<memory> and C<network>.
|
|||
|
||||
=over 2
|
||||
|
||||
If you want all the graphs as a multigraph, create a single multi symlink.
|
||||
|
||||
ln -s /usr/share/munin/plugins/docker_ /etc/munin/plugins/docker_multi
|
||||
|
||||
Or choose a subset of those you want.
|
||||
|
||||
ln -s /usr/share/munin/plugins/docker_ /etc/munin/plugins/docker_containers
|
||||
ln -s /usr/share/munin/plugins/docker_ /etc/munin/plugins/docker_cpu
|
||||
ln -s /usr/share/munin/plugins/docker_ /etc/munin/plugins/docker_images
|
||||
|
|
@ -66,12 +73,12 @@ This section has been reverse-engineered from git logs
|
|||
|
||||
* Rowan Wookey <admin@rwky.net>: performance improvement
|
||||
|
||||
* Olivier Mehani <shtrom@ssji.net>: Network support, ClientWrapper, gerenal cleanup
|
||||
* Olivier Mehani <shtrom@ssji.net>: Network support, ClientWrapper, general cleanup, multigraph
|
||||
|
||||
=head1 MAGIC MARKERS
|
||||
|
||||
#%# family=auto
|
||||
#%# capabilities=autoconf suggest
|
||||
#%# capabilities=autoconf suggest multigraph
|
||||
|
||||
=cut
|
||||
"""
|
||||
|
|
@ -315,39 +322,7 @@ def volume_summary(volume):
|
|||
return summary
|
||||
|
||||
|
||||
def main():
|
||||
try:
|
||||
mode = sys.argv[1]
|
||||
except IndexError:
|
||||
mode = ""
|
||||
wildcard = sys.argv[0].split("docker_")[1].split("_")[0]
|
||||
|
||||
try:
|
||||
import docker
|
||||
client = docker.from_env()
|
||||
if mode == "autoconf":
|
||||
client.ping()
|
||||
print('yes')
|
||||
sys.exit(0)
|
||||
except Exception as e:
|
||||
print(f'no ({e})')
|
||||
if mode == "autoconf":
|
||||
sys.exit(0)
|
||||
sys.exit(1)
|
||||
|
||||
if mode == "suggest":
|
||||
print("cpu")
|
||||
print("images")
|
||||
print("memory")
|
||||
print("network")
|
||||
print("status")
|
||||
print("volumes")
|
||||
sys.exit(0)
|
||||
|
||||
client = ClientWrapper(client,
|
||||
exclude_re=os.getenv('EXCLUDE_CONTAINER_NAME'))
|
||||
|
||||
if wildcard == "status":
|
||||
def status(client, mode):
|
||||
if mode == "config":
|
||||
print("graph_title Docker status")
|
||||
print("graph_vlabel containers")
|
||||
|
|
@ -393,7 +368,9 @@ def main():
|
|||
"`docker container start <NAME>`")
|
||||
else:
|
||||
print_containers_status(client)
|
||||
elif wildcard == "containers":
|
||||
|
||||
|
||||
def containers(client, mode):
|
||||
if mode == "config":
|
||||
print("graph_title Docker containers")
|
||||
print("graph_vlabel containers")
|
||||
|
|
@ -401,7 +378,9 @@ def main():
|
|||
print("containers_quantity.label Containers")
|
||||
else:
|
||||
print('containers_quantity.value', len(client.containers))
|
||||
elif wildcard == "images":
|
||||
|
||||
|
||||
def images(client, mode):
|
||||
if mode == "config":
|
||||
print("graph_title Docker images")
|
||||
print("graph_vlabel images")
|
||||
|
|
@ -424,7 +403,9 @@ def main():
|
|||
print("dangling_quantity.warning 10")
|
||||
else:
|
||||
print_images_count(client)
|
||||
elif wildcard == "volumes":
|
||||
|
||||
|
||||
def volumes(client, mode):
|
||||
if mode == "config":
|
||||
print("graph_title Docker volumes")
|
||||
print("graph_vlabel volumes")
|
||||
|
|
@ -436,7 +417,9 @@ def main():
|
|||
else:
|
||||
print('volumes_quantity.value', len(client.volumes))
|
||||
print('volumes_quantity.extinfo', ', '.join(volume_summary(v) for v in client.volumes))
|
||||
elif wildcard == "cpu":
|
||||
|
||||
|
||||
def cpu(client, mode):
|
||||
if mode == "config":
|
||||
graphlimit = str(os.cpu_count() * 100)
|
||||
print("graph_title Docker containers CPU usage")
|
||||
|
|
@ -453,21 +436,9 @@ def main():
|
|||
print("{}.info {}".format(container.name, container_attributes(container)))
|
||||
else:
|
||||
print_containers_cpu(client)
|
||||
elif wildcard == "memory":
|
||||
if mode == "config":
|
||||
print("graph_title Docker containers memory usage")
|
||||
print("graph_args --base 1024 -l 0")
|
||||
print("graph_vlabel Bytes")
|
||||
print("graph_category virtualization")
|
||||
print("graph_info This graph shows docker container memory usage.")
|
||||
print("graph_total Total memory usage")
|
||||
for container in client.all_containers:
|
||||
print("{}.label {}".format(container.name, container.name))
|
||||
print("{}.draw AREASTACK".format(container.name))
|
||||
print("{}.info {}".format(container.name, container_attributes(container)))
|
||||
else:
|
||||
print_containers_memory(client)
|
||||
elif wildcard == "network":
|
||||
|
||||
|
||||
def network(client, mode):
|
||||
if mode == "config":
|
||||
print("graph_title Docker containers network usage")
|
||||
print("graph_args --base 1024 -l 0")
|
||||
|
|
@ -492,5 +463,75 @@ def main():
|
|||
print_containers_network(client)
|
||||
|
||||
|
||||
def memory(client, mode):
|
||||
if mode == "config":
|
||||
print("graph_title Docker containers memory usage")
|
||||
print("graph_args --base 1024 -l 0")
|
||||
print("graph_vlabel Bytes")
|
||||
print("graph_category virtualization")
|
||||
print("graph_info This graph shows docker container memory usage.")
|
||||
print("graph_total Total memory usage")
|
||||
for container in client.all_containers:
|
||||
print("{}.label {}".format(container.name, container.name))
|
||||
print("{}.draw AREASTACK".format(container.name))
|
||||
print("{}.info {}".format(container.name, container_attributes(container)))
|
||||
else:
|
||||
print_containers_memory(client)
|
||||
|
||||
|
||||
def main():
|
||||
series = [
|
||||
'cpu',
|
||||
'images',
|
||||
'memory',
|
||||
'network',
|
||||
'status',
|
||||
'volumes',
|
||||
]
|
||||
|
||||
try:
|
||||
mode = sys.argv[1]
|
||||
except IndexError:
|
||||
mode = ""
|
||||
wildcard = sys.argv[0].split("docker_")[1].split("_")[0]
|
||||
|
||||
try:
|
||||
import docker
|
||||
client = docker.from_env()
|
||||
if mode == "autoconf":
|
||||
client.ping()
|
||||
print('yes')
|
||||
sys.exit(0)
|
||||
except Exception as e:
|
||||
print(f'no ({e})')
|
||||
if mode == "autoconf":
|
||||
sys.exit(0)
|
||||
sys.exit(1)
|
||||
|
||||
if mode == "suggest":
|
||||
# The multigraph covers all other graphs,
|
||||
# so we only need to suggest one
|
||||
print("multi")
|
||||
sys.exit(0)
|
||||
|
||||
client = ClientWrapper(client,
|
||||
exclude_re=os.getenv('EXCLUDE_CONTAINER_NAME'))
|
||||
|
||||
if wildcard in series:
|
||||
# dereference the function name by looking in the globals()
|
||||
# this assumes that the function name matches the series name exactly
|
||||
# if this were to change, a different approach would be needed,
|
||||
# most likely using a Dict of series name string to callable
|
||||
globals()[wildcard](client, mode)
|
||||
elif wildcard == 'multi':
|
||||
for s in series:
|
||||
print(f'multigraph docker_{s}')
|
||||
# ditto
|
||||
globals()[s](client, mode)
|
||||
else:
|
||||
print(f'unknown series ({wildcard})', file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue