Product Concepts

You can send metrics data to HostedMetrics by using the StatsD protocol.

Most programming languages have a third-party de-facto/popular StatsD package or library that you can use. For example, for python there's the statsd package.

Connection Details

Address: statsd.hostedmetrics.com
StatsD port: 48172

API Key

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

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.

Want to see it in action?

You can trial it risk-free with our InfluxDB solution.