08ac1308b8
To allow monasca detecting network congestion, we add a new agent plugin for monasca-agent module based on Explicit Congestion Notification (ECN) tos bits. The agent will create a map between the number of Congestion Encountered(CE) packets/bytes and the source ip address responsible of the congestion. The source could be a compute or (if activated) a set of VMs deployed in a compute. First, we ensure that ECN marking is enabled for both edges. Second, we check ecn.packets and ecn.bytes and calculate ecn.cong.rate associated to each source of congestion. Last, the agent sends the three metrics and their timestamp to monasca API for any further processing and keeps the metric counters into a cache file. This piece of information could be used to trigger a new kind of performance alarm in monasca threshold. Change-Id: I98405524588582065c7825ca511c489d59826cda Task: 5750 Story: 2001234 |
||
---|---|---|
conf.d | ||
docs | ||
monasca_agent | ||
monasca_setup | ||
packaging | ||
tests | ||
tests_to_fix | ||
tools | ||
.gitignore | ||
.gitreview | ||
.testr.conf | ||
LICENSE | ||
README.md | ||
agent.yaml.template | ||
bindep.txt | ||
mkdocs.yml | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
test-requirements.txt | ||
tox.ini |
README.md
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