openstack/monasca-agent
Code Issues Proposed changes
Agent for Monasca
1,192 Commits 8 Branches 49 Tags 26 MiB
Python 94.9%
Shell 3.6%
Jinja 0.7%
Dockerfile 0.2%
Makefile 0.2%
Other 0.4%
a72f907eef
Go to file
Donagh McCabe a72f907eef Add json_plugin: simple way to post metrics to Monasca 
This patch adds a plugin that reads metrics from JSON files. This
makes it very easy to integrate with Monasca -- instead of writing
a new plugin, simply write your metrics to a file.

The advantage of this mechanism is that:
- It's simple and easy to understand
- It is asynchronous with Monasca Agent. There are two technical
  advantages to this:
    - Your check does not need to run at same frequency as
      the agent.
    - If your check blocks, this does not affect other checks
      in the agent because the agent is not blocked.
- You can create the metrics as a side effect of doing other
  stuff. For example, a server process can write the JSON
  file while it is processing requests. With the normal plugin
  architecture, you need to write code that talks to your
  server process to access the metrics.
- You can write the check code in any language.

Change-Id: I1e998fa677e16cc04d46edd46d0e6433131825e7
2016-12-09 14:04:02 +00:00
conf.d Add json_plugin: simple way to post metrics to Monasca 2016-12-09 14:04:02 +00:00
docs Add json_plugin: simple way to post metrics to Monasca 2016-12-09 14:04:02 +00:00
monasca_agent Add json_plugin: simple way to post metrics to Monasca 2016-12-09 14:04:02 +00:00
monasca_setup Add json_plugin: simple way to post metrics to Monasca 2016-12-09 14:04:02 +00:00
packaging Fix typo 2015-09-24 16:00:56 +09:00
tests Add json_plugin: simple way to post metrics to Monasca 2016-12-09 14:04:02 +00:00
tests_to_fix Change assertTrue(isinstance()) by optimal assert 2016-10-25 10:38:29 +08:00
.gitignore Fixing keystone singleton problem 2015-08-17 10:59:44 -06:00
.gitreview Added detection check to find process by service command. 2016-07-01 16:30:14 +01:00
agent.yaml.template Add config option 2016-10-05 05:02:20 +00:00
bindep.txt Move other-requirements.txt to bindep.txt 2016-08-25 06:43:35 +00:00
LICENSE Add HPE copyright 2016-02-02 10:34:10 -07:00
mkdocs.yml Add HPE copyright 2016-02-02 10:34:10 -07:00
README.md Show team and repo badges on README 2016-11-25 18:32:16 +01:00
requirements.txt Fix version mismatch of oslo.utils 2016-11-22 09:32:08 -07:00
setup.cfg add a one-line summary to the package metadata 2016-12-05 10:55:05 -05:00
setup.py Add HPE copyright 2016-02-02 10:34:10 -07:00
test-requirements.txt Revert "Adjusting flake8 so that gate passes" 2016-11-09 01:50:01 +00:00
tox.ini Fixing problems with tox 2016-11-16 13:05:25 +00:00

README.md

Team and repository tags

Team and repository tags

Table of Contents

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.
  • 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.
  • Statsd. The Monasca Agent supports an integrated Statsd daemon which can be used by applications via a statsd client library.
  • 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 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 Agent can check service such as MySQL, RabbitMQ, and many more.
  • OpenStack metrics. The agent can perform checks on OpenStack processes.
  • The Agent can automatically detect and setup checks on certain processes and resources.

The Agent is extensible through 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 configuration of additional check and setup plugins, written in Python. See the "Agent Customizations" detailed documentation.

Agent github.com/openstack/monasca-agent/blob/master/docs/Agent.md

Agent Customizations github.com/openstack/monasca-agent/docs/Customizations.md

Monasca Metrics github.com/openstack/monasca-agent/docs/MonascaMetrics.md

Agent Plugin details github.com/openstack/monasca-agent/docs/Plugins.md

License

(C) Copyright 2015 Hewlett Packard Enterprise Development Company LP