com.percolate.foam

Class Graphite

java.lang.Object

com.percolate.foam.ServiceImpl

com.percolate.foam.Graphite

All Implemented Interfaces:

EventTrackingService, Service

class Graphite
extends ServiceImpl
implements EventTrackingService

Service Object. Represents a service to which we will send data.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) java.lang.String	apiKey
(package private) java.lang.String	host
(package private) int	port

Fields inherited from class com.percolate.foam.ServiceImpl

context, utils

Constructor Summary

Constructors

Constructor and Description
Graphite(android.content.Context context)

Method Summary

Modifier and Type	Method and Description
(package private) void	closeSocket(java.net.Socket socket) Close the given Socket object, checking for null
void	enable(java.lang.String url) Enable this service.
ServiceType	getServiceType() Returns on of ServiceType that corresponds to this service.
(package private) long	getTimeStamp() Return unix epoch for the current time
boolean	isEnabled() This service is enabled
void	logEvent(android.content.Context context, java.lang.String event) Send data to graphite in the format "metric_path value timestamp\n".
(package private) void	sendData(java.lang.String graphiteEvent) Start new background thread to send data with.
(package private) java.net.Socket	sendDataOverSocket(java.lang.String graphiteEvent) Create new DataOutputStream to send data over.
(package private) void	sendUdpData(java.lang.String graphiteEvent) Send data to Graphite server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

host

java.lang.String host

port

int port

apiKey

java.lang.String apiKey

Constructor Detail

Graphite

Graphite(android.content.Context context)

Method Detail

enable

public void enable(java.lang.String url)

Enable this service. Pass in the respective API Key (or similar)

Specified by:

enable in interface Service

Parameters:

url - API Key (aka, Tracking ID, Application Key, Project Token, etc, etc)

isEnabled

public boolean isEnabled()

This service is enabled

Specified by:

isEnabled in interface Service

Returns:

true if enabled, otherwise false.

getServiceType

public ServiceType getServiceType()

Returns on of ServiceType that corresponds to this service.

Specified by:

getServiceType in interface Service

Returns:

enum. on of ServiceType.

logEvent

public void logEvent(android.content.Context context,
                     java.lang.String event)

Send data to graphite in the format "metric_path value timestamp\n". Example: "com.myapp.activities.MainActivity 1 1429801333\n" ApiKey will be appended to the metric_path as expected by hosted providers. Send the given event to the backing service.

Specified by:

logEvent in interface EventTrackingService

Parameters:

context - Context.

event - Event to track. This will be sent to the service represented by this class.

getTimeStamp

long getTimeStamp()

Return unix epoch for the current time

Returns:

Epoch in for the current time.

sendData

void sendData(java.lang.String graphiteEvent)

Start new background thread to send data with.

Parameters:

graphiteEvent - Event data to send to graphite.

sendUdpData

void sendUdpData(java.lang.String graphiteEvent)

Send data to Graphite server.

Parameters:

graphiteEvent - Event data to send to graphite.

sendDataOverSocket

java.net.Socket sendDataOverSocket(java.lang.String graphiteEvent)
                            throws java.io.IOException

Create new DataOutputStream to send data over.

Parameters:

graphiteEvent - Event data to send to graphite.

Returns:

created Socket object. Should be closed after calling this method.

Throws:

java.io.IOException - propagates if there was a network issue.

closeSocket

void closeSocket(java.net.Socket socket)

Close the given Socket object, checking for null

Parameters:

socket - socket to close.