Monitoring agent for gathering metrics and sending them to the Monasca API.


Keywords
openstack, monitoring
License
Apache-2.0
Install
pip install monasca-agent==2.4.0

Documentation

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