TCP Connection

A simple way to send metrics to us is via a TCP connection. First, ensure each metric name is prefixed by your API key, then send your metric(s) using the Metric Data Format.

Host: carbon.hostedgraphite.com Port: 2003

It is not necessary (nor recommended) to create a new connection for each metric. You can put multiple metrics on separate lines. A long-lived connection will be faster because you won’t have to wait to establish a new connection each time. The following simple example shows how to send a single metric using Netcat on linux:

echo "YOUR-API-KEY.conc_users 1.2" | nc carbon.hostedgraphite.com 2003

   

For programming language-specific examples of sending metrics via TCP, check out our Language Guide.