Product Concepts
You can send metrics data to HostedMetrics by using the StatsD protocol.
There are many client libraries for using StatsD metrics in any application framework. This makes StatsD quite popular for custom application metrics.
Connection Details for Your StatsD Client
Address: statsd.hostedmetrics.com
StatsD port: 48172
You must prefix all your metric names with your api key. The StatsD library you're using most likely has support for this. It should automatically add a period character too to separate the prefix from the metric name.
Tags
You can make use of tags by appending comma-separated key/value
pairs to the metric name, like such:
servers.health.cpu,ip_address=163.14.90.221,server_name=pelican
Field names can be specified by appending them with a period character
to the metric name (and before the tags, that is). So, if you send these two lines:
servers.health.cpu,ip_address=163.14.90.221,server_name=pelican
servers.health.memory,ip_address=163.14.90.221,server_name=pelican
the data will be stored under a measurement named servers.health
.
It will contain the fields cpu
and memory
.
Lastly, the measurements will be tagged with:
ip_address
= 163.14.90.221
, and
server_name
= pelican
For more details on field names, please see the Measurement Naming page.