statsd-blueflood-backend
v0.0.5
Published
blueflood statsD backend
Downloads
2
Readme
Blueflood StatsD Backend
This is a statsD backend that will send metrics aggregated in statsD to an instance of Blueflood.
Blueflood Configuration
The Blueflood statsD endpoint is new and has experimental status.
See blueflood/pull/201.
Assumed endpoint is http://host:port/v1.0/:tenantId/experimental/metrics/statsd.
StatsD Configuration
Your statsD configuration file will need a blueflood
section similar to the way you would have one for graphite or the console if you were using those backends.
Here are the values that are currently honored:
tenantId
: (required) This tenantId will be used to publish metrics to Blueflood.endpoint
: (required) The location of the API. e.g.: 'http://metrics.example.com:8080'
Example configuration:
"blueflood": {
"tenantId": "333333",
"endpoint": "http://127.0.0.1:19000"
},
You can also send metrics into the Rackspace Cloud Metrics API service by adding the follwing auth section to the configuration:
"blueflood": {
"tenantId": "333333",
"endpoint": "http://iad.metrics-ingest.api.rackspacecloud.com:80",
"authModule": "./auth",
"authClass": "RaxAuth",
"authParams": {
"raxusername": "my_cloud_user_name",
"raxapikey": "my_rax_api_key"
}
}
If you happen to use some other Openstack identity service, or even something home-grown, you can create your own
authenticator, just make sure to implement the methods indicated by auth.EmptyAuth
.
Detailed Installation Instructions
https://github.com/gdusbabek/blueflood-statsd-backend/wiki/Installing-the-Blueflood-Statsd-Backend
Payload format
Payloads sent to Blueflood are currently formatted like this:
{
"tenantId": "xxxxxxxx",
"timestamp": 111111111,
"gauges": [
{
"name": "gauge_name",
"value": 42
},
{
"name":"another_gauge",
"value": 4343
}
],
"counters": [
{
"name": "counter_name",
"value": 32,
"rate": 2.32
},
{
"name": "another_counter",
"value": 4424,
"rate": 52.1
}
],
"timers": [
{
"name": "timer_name",
"count": 32,
"rate": 2.3,
"min": 1,
"max": 5,
"sum": 21,
"avg": 2.1,
"median": 3,
"std": 1.01,
"percentiles": {
"999": 1.22222,
"98": 1.11111
},
"histogram": {
"bin_50": 0,
"bin_100": 0,
"bin_inf": 0
}
}
],
"sets": [
{
"name": "set_name",
"values": ["foo", "bar", "baz"]
},
{
"name": "another_set",
"values": ["boo", "far", "zab"]
}
]
}
License
This code is licensed under the Apache 2.0 open source license.