75 lines
2.6 KiB
ReStructuredText
75 lines
2.6 KiB
ReStructuredText
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
|
|
|
|
* License: Simplified BSD License
|
|
* Source: https://opendev.org/openstack/monasca-agent
|
|
* Bugs: https://storyboard.openstack.org/#!/project/861 (please use `bug` tag)
|
|
|
|
.. |Team and repository tags| image:: https://governance.openstack.org/tc/badges/monasca-agent.svg
|
|
:target: https://governance.openstack.org/tc/reference/tags/index.html
|