Merge "Add information about Prometheus plugin to README"

This commit is contained in:
Zuul 2019-05-30 13:15:49 +00:00 committed by Gerrit Code Review
commit 6fa4c8fcaf
2 changed files with 31 additions and 20 deletions

View File

@ -6,28 +6,39 @@ Team and repository tags
Introduction Introduction
============ ============
The Monasca Agent is a modern Python monitoring agent for gathering The *Monasca Agent* is a modern Python monitoring agent for gathering
metrics and sending them to the Monasca API. The Agent supports metrics and sending them to the Monasca API. The Agent supports
collecting metrics from a variety of sources as follows: collecting metrics from a variety of sources as follows:
- System metrics such as cpu and memory utilization. System metrics
- Nagios plugins. The Monasca Agent can run Nagios plugins and send the such as cpu and memory utilization.
status code returned by the plugin as a metric to the Monasca API. Prometheus
- Statsd. The Monasca Agent supports an integrated Statsd daemon which The *Monasca Agent* supports scraping metrics from endpoints provided by
can be used by applications via a statsd client library. *Prometheus exporters* or *Prometheus* instrumented applications.
- Host alive. The Monasca Agent can perform active checks on a host to Statsd
determine if it is alive using ping (ICMP) or SSH. The *Monasca Agent* supports an integrated *StatsD* daemon which
- Process checks. The Monasca Agent can check a process and return can be used by applications via a statsd client library.
several metrics on the process such as a number of instances, memory, OpenStack metrics
io and threads. The agent can perform checks on OpenStack processes.
- Http Endpoint checks. The Monasca Agent can perform active checks on Host alive
http endpoints by sending an HTTP request to an API. The *Monasca Agent* can perform active checks on a host to
- Service checks. The Agent can check services such as MySQL, RabbitMQ, determine if it is alive using ping (ICMP) or SSH.
and many more. Process checks
- OpenStack metrics. The agent can perform checks on OpenStack The *Monasca Agent* can check a process and return
processes. several metrics on the process such as a number of instances, memory,
- The Agent can automatically detect and setup checks on certain io and threads.
processes and resources. 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, The Agent is extensible through the configuration of additional plugins,
written in Python. written in Python.

View File

@ -2424,7 +2424,7 @@ The process checks return the following metrics ( if detailed is set to true, ot
On Linux, if the Agent is not run as root or the owner of the process the io metrics and the open_file_descriptors metric will fail to be reported if the mon-agent user does not have permission to get it for the process. On Linux, if the Agent is not run as root or the owner of the process the io metrics and the open_file_descriptors metric will fail to be reported if the mon-agent user does not have permission to get it for the process.
## Prometheus Client ## Prometheus
This plugin is for scraping metrics from endpoints that are created by prometheus client libraries - https://prometheus.io/docs/instrumenting/clientlibs/ This plugin is for scraping metrics from endpoints that are created by prometheus client libraries - https://prometheus.io/docs/instrumenting/clientlibs/
It can be configured in two ways. One being manually setting all the endpoints that you want to scrape. The other being It can be configured in two ways. One being manually setting all the endpoints that you want to scrape. The other being