)]}'
{"docs/Agent.md":[{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":17,"context_line":""},{"line_number":18,"context_line":"# Architecture"},{"line_number":19,"context_line":"The Monasca Agent is the component of the [Monasca](https://wiki.openstack.org/wiki/Monasca) monitoring system that collects metrics from the system it is running on and sends them to the Monasca API."},{"line_number":20,"context_line":" "},{"line_number":21,"context_line":"A metric is identified by a name and dimensions.  The fields required in a metric are name, timestamp, and value.  A metric can also have 0..n dimensions.  Some standard dimensions are sent with all metrics that are sent by the agent."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"\u003cimg src\u003d\"https://github.com/stackforge/monasca-agent/raw/master/docs/monasca-agent_arch.png\" alt\u003d\"Monasca Agent Diagram\"\u003e"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_2d9b78cb","line":20,"updated":"2015-04-28 20:48:11.000000000","message":"Trailing space","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":65,"context_line":"The Agent requires configuration in order to run. There are two ways to configure the agent, either using the [monasca-setup](#monasca-setup) script or manually."},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"## monasca-setup (Recommended)"},{"line_number":68,"context_line":"The Monasca agent has a script, called \"monasca-setup\", that should be used to automatically configure the Agent to send metrics to a Monasca API. This script will create the agent.yaml configuration file as well as any plugin configuration yaml files needed to monitor the processes on the local machine. Additionally this will create an appropriate startup script for the system and enable the agent to start on boot. The monasca-setup script will then auto-detect certain applications and OpenStack processes that are running on the machine. Lastly it will start the agent."},{"line_number":69,"context_line":""},{"line_number":70,"context_line":"The agent configuration files are located in /etc/monasca/agent."},{"line_number":71,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_0dbf9cd1","line":68,"updated":"2015-04-28 20:48:11.000000000","message":"Should say where monasca-setup is","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":83,"context_line":"| ----------- | ------------ | ----------- |"},{"line_number":84,"context_line":"| username | This is a required parameter that specifies the username needed to login to Keystone to get a token | myuser |"},{"line_number":85,"context_line":"| password | This is a required parameter that specifies the password needed to login to Keystone to get a token | mypassword |"},{"line_number":86,"context_line":"| project_name | This is a required parameter that specifies the name of the Keystone project name to store the metrics under | myproject |"},{"line_number":87,"context_line":"| keystone_url | This is a required parameter that specifies the url of the keystone api for retrieving tokens | http://192.168.1.5:35357/v3 |"},{"line_number":88,"context_line":"| dimensions | A comma seperated list of key:value pairs to include as dimensions in all submitted metrics| region:a,az:1 |"},{"line_number":89,"context_line":"| service | This is an optional parameter that specifies the name of the service associated with this particular node | nova, cinder, myservice |"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_ed8100fd","line":86,"updated":"2015-04-28 20:48:11.000000000","message":"I don\u0027t believe this is required if the user has a default project","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":84,"context_line":"| username | This is a required parameter that specifies the username needed to login to Keystone to get a token | myuser |"},{"line_number":85,"context_line":"| password | This is a required parameter that specifies the password needed to login to Keystone to get a token | mypassword |"},{"line_number":86,"context_line":"| project_name | This is a required parameter that specifies the name of the Keystone project name to store the metrics under | myproject |"},{"line_number":87,"context_line":"| keystone_url | This is a required parameter that specifies the url of the keystone api for retrieving tokens | http://192.168.1.5:35357/v3 |"},{"line_number":88,"context_line":"| dimensions | A comma seperated list of key:value pairs to include as dimensions in all submitted metrics| region:a,az:1 |"},{"line_number":89,"context_line":"| service | This is an optional parameter that specifies the name of the service associated with this particular node | nova, cinder, myservice |"},{"line_number":90,"context_line":"| monasca_url | This is a optional parameter that specifies the url of the monasca api for retrieving tokens. By default this is obtained from the registered service in keystone. | http://192.168.1.4:8080/v2.0 |"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_4dc1142e","line":87,"updated":"2015-04-28 20:48:11.000000000","message":"Must be a v3 endpoint","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":85,"context_line":"| password | This is a required parameter that specifies the password needed to login to Keystone to get a token | mypassword |"},{"line_number":86,"context_line":"| project_name | This is a required parameter that specifies the name of the Keystone project name to store the metrics under | myproject |"},{"line_number":87,"context_line":"| keystone_url | This is a required parameter that specifies the url of the keystone api for retrieving tokens | http://192.168.1.5:35357/v3 |"},{"line_number":88,"context_line":"| dimensions | A comma seperated list of key:value pairs to include as dimensions in all submitted metrics| region:a,az:1 |"},{"line_number":89,"context_line":"| service | This is an optional parameter that specifies the name of the service associated with this particular node | nova, cinder, myservice |"},{"line_number":90,"context_line":"| monasca_url | This is a optional parameter that specifies the url of the monasca api for retrieving tokens. By default this is obtained from the registered service in keystone. | http://192.168.1.4:8080/v2.0 |"},{"line_number":91,"context_line":"| skip_enable | This is an optional parameter. By default the service is enabled, which requires the script run as root. Set this parameter to skip that step. | |"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_edafc07b","line":88,"updated":"2015-04-28 20:48:11.000000000","message":"separated","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":159,"context_line":""},{"line_number":160,"context_line":"If a detection plugin exists for monasca-setup you can run monasca-setup with the --detection_plugins flage, ie `monasca-setup --detection-plugins kafka`."},{"line_number":161,"context_line":""},{"line_number":162,"context_line":"To manully configure a plugin follow the steps below:"},{"line_number":163,"context_line":""},{"line_number":164,"context_line":"Agent plugins are activated by placing a valid configuration file in the /etc/monasca/agent/conf.d/ directory. Configuration files are in YAML format, with the file extension .yaml. You may find example configuration files in /usr/local/share/monasca/agent/conf.d/"},{"line_number":165,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_2d2b78ed","line":162,"updated":"2015-04-28 20:48:11.000000000","message":"manually","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":181,"context_line":"A plugin config is specified something like this:"},{"line_number":182,"context_line":""},{"line_number":183,"context_line":"    init_config:"},{"line_number":184,"context_line":"    \tis_jmx: true"},{"line_number":185,"context_line":""},{"line_number":186,"context_line":"    \t# Metrics collected by this check. You should not have to modify this."},{"line_number":187,"context_line":"    \tconf:"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_6d4970d0","line":184,"updated":"2015-04-28 20:48:11.000000000","message":"Not sure why this is showing up as red","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":210,"context_line":"             newDim: test"},{"line_number":211,"context_line":""},{"line_number":212,"context_line":"# Running"},{"line_number":213,"context_line":"The monasca-setup command will create an appropriate startup script for the agent and so the agent can be run by using the standard daemon control tool for your operating system. If you have configured manually the startup script templates can be found in the "},{"line_number":214,"context_line":""},{"line_number":215,"context_line":""},{"line_number":216,"context_line":"# License"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_cd1084ab","line":213,"updated":"2015-04-28 20:48:11.000000000","message":"Fragment","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"}],"docs/ConfigurationManagement.md":[{"author":{"_account_id":11094,"name":"Tim Kuhlman","email":"timothy.kuhlman@canonical.com","username":"kuhlmant"},"change_message_id":"4dc1ba3a397ebaf609f1311dcfef4828cc7ff638","unresolved":false,"context_lines":[{"line_number":1,"context_line":"\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e"},{"line_number":2,"context_line":"\u003c!-- DON\u0027T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e"},{"line_number":3,"context_line":"**Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"- [Configuration Management](#configuration-management)"}],"source_content_type":"text/x-markdown","patch_set":7,"id":"5ad0253b_48c58259","line":2,"updated":"2015-04-28 20:53:26.000000000","message":"I explicitly deleted this file because it is incomplete, inaccurate and arguabably doesn\u0027t belong in the agent documentation since it deals with code outside of this repo and beyond the scope of the agent.","commit_id":"07017ecd1af368bba35531bbd28b5e5e895e97d8"}],"docs/Customizations.md":[{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":50,"context_line":""},{"line_number":51,"context_line":"### Configuring Built-In Check Plugins"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"The built-in Python check plugin scripts are installed as part of the monasca-agent package, and are available in `[installed base dir]/monasca_agent/collector/checks_d`. A sample `yaml` configuration file for each of these plugins is available in `[prefix_dir]/share/monasca/agent/conf.d`, where the stem name of the `yaml` file matches the stem name of the corresponding Python check script."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"Config files for the plugin scripts can be added directly to the standard plugin configuration directory, `/etc/monasca/agent/conf.d` or added by a `monasca-setup` plugin script that auto-detects that the checks are required and then generates and adds the appropriate config file to enable them."},{"line_number":56,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_6d4e10c3","line":53,"updated":"2015-04-28 20:48:11.000000000","message":"What is [prefix_dir]?","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":83,"context_line":""},{"line_number":84,"context_line":"### Disabling Built-In Check Plugins"},{"line_number":85,"context_line":""},{"line_number":86,"context_line":"`monasca-setup` is run to detect local or remote manageable entities and generate `yaml` configuration files to enable the required check plugins. The setup script runs Python detection plugins to accomplish this. By default it will run all of the available detection plugins. To avoid running detection plugins first create the primary configuration by running monasca-setup with the \u0027--system-only\u0027 argument. You can then run with the `--detection_plugins` argument followed by a space seperated list of plugins you would like to run."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"## Customization Best Practices"},{"line_number":89,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_6d93b0fb","line":86,"updated":"2015-04-28 20:48:11.000000000","message":"separated","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":95,"context_line":""},{"line_number":96,"context_line":"Here are some best practices concerning appropriate use of metrics:"},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"- Be aware of [naming conventions](#https://github.com/stackforge/monasca-agent/blob/master/docs/MonascaMetrics)  with metrics."},{"line_number":99,"context_line":"- Considerations affecting system performance"},{"line_number":100,"context_line":"  - Before installing and configuring a custom check plugin, be certain that you have identified consumers who will actually make use of the metric."},{"line_number":101,"context_line":"  - Before defining a new metric, make sure that a metric that is essentially the same hasn\u0027t already been defined. If it has, use that definition. Re-use is good!"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_cd3f64d5","line":98,"updated":"2015-04-28 20:48:11.000000000","message":"This link does not exist","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d1695b9c313672895ec8e6aa9609c7242e775c8d","unresolved":false,"context_lines":[{"line_number":101,"context_line":"  - Before defining a new metric, make sure that a metric that is essentially the same hasn\u0027t already been defined. If it has, use that definition. Re-use is good!"},{"line_number":102,"context_line":"  - Only include metric dimensions that are required by the consumers of the metric. Don\u0027t include extra dimensions simply because someone may someday be interested in them."},{"line_number":103,"context_line":"  - Follow the common and openstack naming conventions, as appropriate, when defining metrics."},{"line_number":104,"context_line":"  - Include only the necessary dimensions in your metric definitions. Measurement data stored in the database stays there for some value of \"forever\"."},{"line_number":105,"context_line":"  - Include value_meta data only when necessary, e.g. when the metric value returned with a measurement can only be understood in the context of the text included in the value_meta. In your plugins, be as economical as possible with the text returned as value_meta. Like other measurement data, value_meta is stored in the database \"forever\"."},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"### Custom Plugin Best Practices"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_4d035410","line":104,"updated":"2015-04-28 20:48:11.000000000","message":"How is this different from the one two above?","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"}],"docs/MonascaMetrics.md":[{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":19,"context_line":""},{"line_number":20,"context_line":"# Nature of Metrics"},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"In Monasca, a metric type is uniquely identified by a name and a specific set of dimensions. The set of dimensions of a metric are a dictionary of (key, value) pairs. A measurement is a metric instance with a value and a timestamp. Measurements are searchable from the Monasca API by name and dimension (key, value)."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Optionally, a measurement may also contain extra data about the value, which is known as `value_meta`. `value_ meta`[wiki.openstack.org/wiki/Monasca/Value_Metadata](https://wiki.openstack.org/wiki/Monasca/Value_Metadata) is a dictionary of (key, value) pairs that contain textual data that relates to the value of the measurement. If value_meta is included with a measurement, it is returned when the measurement is read via the Monasca API. Unlike dimensions, value_meta is not searchable from the Monasca API, and it is ignored when computing statistics on measurements such as `average`."},{"line_number":25,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_d29dc55a","line":22,"updated":"2015-04-28 20:24:19.000000000","message":"\"is a dictionary\" instead of \"are a dictionary\"","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":31,"context_line":"Although metric names in the Monasca API can be any string the Monasca Agent uses several naming conventions as follows:"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"* All lowercase characters."},{"line_number":34,"context_line":"* \u0027.\u0027 is used to hierarchially group. This is done for compatabilty with Graphite as Graphite assumes a \u0027.\u0027 as a delimiter."},{"line_number":35,"context_line":"* \u0027_\u0027 is used to separate words in long names that are not meant to be hierarchal."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"### System Dimensions"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_d2eb85af","line":34,"updated":"2015-04-28 20:24:19.000000000","message":"compatibilty","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":32,"context_line":""},{"line_number":33,"context_line":"* All lowercase characters."},{"line_number":34,"context_line":"* \u0027.\u0027 is used to hierarchially group. This is done for compatabilty with Graphite as Graphite assumes a \u0027.\u0027 as a delimiter."},{"line_number":35,"context_line":"* \u0027_\u0027 is used to separate words in long names that are not meant to be hierarchal."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"### System Dimensions"},{"line_number":38,"context_line":"Dimensions are a dictionary of (key, value) pairs that can be used to describe metrics."}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_1230dd55","line":35,"updated":"2015-04-28 20:24:19.000000000","message":"hierarchical","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":57,"context_line":"| observer_hostname | The FQDN of the host that runs a check against another host. |"},{"line_number":58,"context_line":"| url | In the case of the http endpoint check the url of the http endpoint being checked. |"},{"line_number":59,"context_line":"| device | The device name |"},{"line_number":60,"context_line":"| service | The sevice name that owns this metric |"},{"line_number":61,"context_line":"| component | The component name within the service that the metric comes from |"},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"## OpenStack Specific Naming Conventions"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_b2548954","line":60,"updated":"2015-04-28 20:24:19.000000000","message":"service not device","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":64,"context_line":"This section documents some of the naming conventions that are used for monitoring OpenStack."},{"line_number":65,"context_line":""},{"line_number":66,"context_line":"### Metric Names"},{"line_number":67,"context_line":"Where applicable, each metric name will list the name of the service, such as \"compute\", component, such as \"nova-api\", and check that is done, such as \"process_exists\". For example, \"nova.api.process_exists\"."},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"### OpenStack Dimensions"},{"line_number":70,"context_line":"This section documents the list of dimensions that are commonly used in monitoring OpenStack."}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_72e5d1a6","line":67,"updated":"2015-04-28 20:24:19.000000000","message":"and the check","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":67,"context_line":"Where applicable, each metric name will list the name of the service, such as \"compute\", component, such as \"nova-api\", and check that is done, such as \"process_exists\". For example, \"nova.api.process_exists\"."},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"### OpenStack Dimensions"},{"line_number":70,"context_line":"This section documents the list of dimensions that are commonly used in monitoring OpenStack."},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"| Name | Description | Examples |"},{"line_number":73,"context_line":"| ---- | ----------- | -------- |"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_f29e8106","line":70,"updated":"2015-04-28 20:24:19.000000000","message":"Make the header just Dimensions and remove the first sentence. That is implied from above","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":79,"context_line":"| tenant_name | The tenant name of the owner of an OpenStack resource. | |"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"# Cross-Tenant Metric Submission"},{"line_number":82,"context_line":"If the owner of the VM is to receive his or her own metrics, the Agent needs to be able to submit metrics on their behalf.  This is called cross-tenant metric submission.  For this to work, a Keystone role called \"monitoring-delegate\" needs to be created, and the Agent\u0027s Keystone username and project (tenant) assigned to it.  This username is contained as `username` in `/etc/monasca/agent/agent.yaml`, and passed to `monasca-setup` as the `-u` parameter.   The Agent\u0027s project name which is contained in `agent.yaml` as the variable `project_name`, and passed to `monasca-setup` as the `--project-name` parameter."},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"In the below example, the Agent\u0027s Keystone username is \"monasca-agent\" and the Agent\u0027s Keystone project name is \"mini-mon\"."},{"line_number":85,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_9274edcf","line":82,"updated":"2015-04-28 20:24:19.000000000","message":"remove which","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":99,"context_line":"# Statsd"},{"line_number":100,"context_line":"The Monasca Agent ships with a Statsd daemon implementation called monasca-statsd. A statsd client can be used to send metrics to the Forwarder via the Statsd daemon."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"monascastatsd will accept metrics submitted by functions in either the standard statsd Python client library, or the monasca-agent\u0027s [monasca-statsd Python client library](https://github.com/stackforge/monasca-statsd). The advantage of using the python-monasca-statsd library is that it is possible to specify dimensions on submitted metrics. Dimensions are not handled by the standard statsd client."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Statsd metrics are not bundled along with the metrics gathered by the Collector, but are flushed to the agent Forwarder on a separate schedule (every 10 seconds by default, rather than 60 seconds for Collector metrics)."},{"line_number":105,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_f23a01e7","line":102,"updated":"2015-04-28 20:24:19.000000000","message":"Use monasca-statsd instead of monascastatsd","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"}],"docs/Plugins.md":[{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":262,"context_line":" default dimensions:"},{"line_number":263,"context_line":"    observer_host: fqdn"},{"line_number":264,"context_line":"    target_host: fqdn | supplied"},{"line_number":265,"context_line":"    "},{"line_number":266,"context_line":" default value_meta"},{"line_number":267,"context_line":"    0, 1, 2, 3, 4"},{"line_number":268,"context_line":"    OK, Warning, Critical, Unknown"}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_b2cec981","line":265,"updated":"2015-04-28 20:24:19.000000000","message":"Remove trailing spaces","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"}],"docs/index.md":[{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"For project launchpad visit [launchpad.net/monasca](https://launchpad.net/monasca)"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"Github [github.com/stackforge/monasca-agent/blob/master/docs/](https://github.com/stackforge/monasca-agent/blob/master/docs/)"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"ReadTheDocs [monasca-agent.readthedocs.org/en/latest/](http://monasca-agent.readthedocs.org/en/latest/)"},{"line_number":19,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_320519c2","line":16,"updated":"2015-04-28 20:24:19.000000000","message":"This link doesn\u0027t work","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"},{"author":{"_account_id":11809,"name":"Craig Bryant","email":"craig.bryant@hpe.com","username":"craig-bryant"},"change_message_id":"d811219228c05b8b7c91a5c86f693530aa0e88b8","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"    ##### Install mkdocs"},{"line_number":24,"context_line":"    sudo pip install mkdocs"},{"line_number":25,"context_line":"    "},{"line_number":26,"context_line":"    ##### Install Nodejs Package Manager NPM"},{"line_number":27,"context_line":"    https://nodejs.org/download/"},{"line_number":28,"context_line":"    "}],"source_content_type":"text/x-markdown","patch_set":5,"id":"5ad0253b_123c5d92","line":25,"updated":"2015-04-28 20:24:19.000000000","message":"Can you remove the trailing spaces? It makes it harder to read in gerrit with all of the red","commit_id":"613062bb0fe33904a9eb0d78d1feede74b48b756"}]}