org.kairosdb.client.TelnetClient Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of client Show documentation

Java client for pushing and querying data to/from KairosDB

There is a newer version: 3.1.1

package org.kairosdb.client;

import org.kairosdb.client.builder.*;

import java.io.BufferedOutputStream;
import java.io.IOException;
import java.io.PrintWriter;
import java.net.Socket;
import java.util.List;
import java.util.Map;

/**
 * Communicates with KairosDB using the Telnet protocol. Only pushing of metrics is supported. Querying must be done
 * using the HTTP client.
 *
 * The socket is opened in the constructor and left open until the close() method is called. Note that no response is
 * returned. This allows data to flow more quickly. If you need to guarantee arrival of metrics then use the HTTP
 * client.
 */
public class TelnetClient
{
	private Socket socket;
	private PrintWriter writer;

	public TelnetClient(String host, int port) throws IOException
	{
		socket = new Socket(host, port);
		writer = new PrintWriter(new BufferedOutputStream(socket.getOutputStream()));
	}

	/**
	 * @deprecated As of KairosDB 1.0, use putMetrics. PutMetrics uses putm rather
	 * than put.
	 *
	 * Sends metrics from the builder to the Kairos server.
	 *
	 * @param builder metrics builder
	 */
	@Deprecated
	public void pushMetrics(MetricBuilder builder)
	{
		List metrics = builder.getMetrics();
		for (Metric metric : metrics)
		{
			StringBuilder tags = new StringBuilder();
			for (Map.Entry tag : metric.getTags().entrySet())
			{
				tags.append(tag.getKey()).append("=").append(tag.getValue());
			}

			for (DataPoint dataPoint : metric.getDataPoints())
			{
				writer.println("put" + " " + metric.getName() + " " + dataPoint.getTimestamp() + " " +
						dataPoint.getValue() +
						" " + tags.toString());
			}
		}
		writer.flush();
	}

	public void putMetrics(MetricBuilder builder)
	{
		List metrics = builder.getMetrics();
		for (Metric metric : metrics)
		{
			StringBuilder tags = new StringBuilder();
			for (Map.Entry tag : metric.getTags().entrySet())
			{
				tags.append(tag.getKey()).append("=").append(tag.getValue());
			}

			for (DataPoint dataPoint : metric.getDataPoints())
			{
				writer.println("putm" + " " + metric.getName() + " " + dataPoint.getTimestamp() + " " +
						dataPoint.getValue() +
						" " + tags.toString());
			}
		}
		writer.flush();
	}

	/**
	 * Closes the socket.
	 *
	 * @throws IOException if the socket could not be closed.
	 */
	public void shutdown() throws IOException
	{
		socket.close();
	}
}