Agent for Monasca
Go to file
likui 38c6f3af51 Replace assertItemsEqual with assertCountEqual
assertItemsEqual was removed from Python's unittest.TestCase in
Python 3.3 [1][2]. We have been able to use them since then, because
testtools required unittest2, which still included it. With testtools
removing Python 2.7 support [3][4], we will lose support for
assertItemsEqual, so we should switch to use assertCountEqual.

[1] - https://bugs.python.org/issue17866
[2] - https://hg.python.org/cpython/rev/d9921cb6e3cd
[3] - testing-cabal/testtools#286
[4] - testing-cabal/testtools#277

Change-Id: I1b269b5c06a99e8f62f7c5a33b2314de06389041
2020-11-10 14:48:15 +08:00
conf.d Add swift_handoffs check plugin to monasca 2019-10-18 17:16:14 +02:00
docker Update hacking for Python3 2020-03-31 06:49:33 +00:00
docs Fix libvirt ping_checks documentation 2020-05-14 11:08:02 +00:00
monasca_agent Convert byte-stream to 'utf-8' 2020-08-10 12:28:09 +00:00
monasca_setup Update API version of monitored Cinder 2020-08-17 16:05:25 +02:00
packaging Removed dependency on supervisor 2018-06-27 11:28:43 +02:00
playbooks Push Docker image to Docker Hub from Zuul 2019-09-25 12:30:41 +02:00
releasenotes/notes Merge "Add support for gathering Slab memory usage" 2020-01-13 18:00:27 +00:00
tests Replace assertItemsEqual with assertCountEqual 2020-11-10 14:48:15 +08:00
tests_to_fix Add python36 support 2018-10-25 09:09:53 -04:00
.gitignore Removed dependency on supervisor 2018-06-27 11:28:43 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:40:33 +00:00
.stestr.conf Switch to using stestr 2018-08-13 11:19:12 -04:00
.zuul.yaml Add Python3 wallaby unit tests 2020-10-12 13:56:12 +00:00
CONTRIBUTING.rst Add CONTRIBUTING.rst 2020-05-19 16:14:45 +02:00
LICENSE Add HPE copyright 2016-02-02 10:34:10 -07:00
README.rst Start README.rst with a better title 2020-06-16 15:39:04 +08:00
agent.yaml.template Support setting statsd metric aggregation interval 2019-02-21 14:23:21 +00:00
bindep.txt Adding python3-libvirt for Ubuntu-focal 2020-10-09 15:24:31 +02:00
mkdocs.yml Add HPE copyright 2016-02-02 10:34:10 -07:00
requirements.txt [ussuri][goal] Drop python 2.7 support and testing 2019-11-16 14:09:24 +00:00
setup.cfg bump py37 to py38 in tox.ini 2020-10-14 09:13:04 +08:00
setup.py Cleanup py27 support 2020-04-14 19:25:34 +02:00
test-requirements.txt Fix hacking min version to 3.0.1 2020-05-12 19:29:40 -05:00
tox.ini bump py37 to py38 in tox.ini 2020-10-14 09:13:04 +08:00

README.rst

Openstack Monasca Agent

Team and repository tags

Introduction

The Monasca Agent is a modern Python monitoring agent for gathering metrics and sending them to the Monasca API. The Agent supports collecting metrics from a variety of sources as follows:

System metrics

such as cpu and memory utilization.

Prometheus

The Monasca Agent supports scraping metrics from endpoints provided by Prometheus exporters or Prometheus instrumented applications.

Statsd

The Monasca Agent supports an integrated StatsD daemon which can be used by applications via a statsd client library.

OpenStack metrics

The agent can perform checks on OpenStack processes.

Host alive

The Monasca Agent can perform active checks on a host to determine if it is alive using ping (ICMP) or SSH.

Process checks

The Monasca Agent can check a process and return several metrics on the process such as a number of instances, memory, io and threads.

Http Endpoint checks

The Monasca Agent can perform active checks on http endpoints by sending an HTTP request to an API.

Service checks

The Monasca Agent can check services such as MySQL, RabbitMQ, and many more.

Nagios plugins

The Monasca Agent can run Nagios plugins and send the status code returned by the plugin as a metric to the Monasca API.

The Agent can automatically detect and setup checks on certain processes and resources.

The Agent is extensible through the configuration of additional plugins, written in Python.

Detailed Documentation

For an introduction to the Monasca Agent, including a complete list of the metrics that the Agent supports, see the "Agent" detailed documentation.

The Agent is extensible through the configuration of additional check and setup plugins, written in Python. See the "Agent Customizations" detailed documentation.

Agent

https://opendev.org/openstack/monasca-agent/src/branch/master/docs/Agent.md

Agent Customizations

https://opendev.org/openstack/monasca-agent/src/branch/master/docs/Customizations.md

Monasca Metrics

https://opendev.org/openstack/monasca-agent/src/branch/master/docs/MonascaMetrics.md

Agent Plugin details

https://opendev.org/openstack/monasca-agent/src/branch/master/docs/Plugins.md