com.datadoghq.trace.writer

Class DDAgentWriter

java.lang.Object

com.datadoghq.trace.writer.DDAgentWriter

All Implemented Interfaces:

Writer

@AutoService(value=Writer.class)
public class DDAgentWriter
extends Object
implements Writer

This writer write provided traces to the a DD agent which is most of time located on the same host.

It handles writes asynchronuously so the calling threads are automatically released. However, if too much spans are collected the writers can reach a state where it is forced to drop incoming spans.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_HOSTNAME Default location of the DD agent
static int	DEFAULT_PORT

Constructor Summary

Constructors

Constructor and Description
DDAgentWriter()
DDAgentWriter(DDApi api)
DDAgentWriter(DDApi api, com.datadoghq.trace.writer.WriterQueue<List<DDBaseSpan<?>>> queue)

Method Summary

Modifier and Type	Method and Description
void	close() Indicates to the writer that no future writing will come and it should terminates all connections and tasks
void	start() Start the writer
void	write(List<DDBaseSpan<?>> trace) Write a trace represented by the entire list of all the finished spans
void	writeServices(Map<String,Service> services) Report additional service information to the endpoint

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_HOSTNAME

public static final String DEFAULT_HOSTNAME

Default location of the DD agent

See Also:

Constant Field Values

DEFAULT_PORT

public static final int DEFAULT_PORT

See Also:

Constant Field Values

Constructor Detail

DDAgentWriter

public DDAgentWriter()

DDAgentWriter

public DDAgentWriter(DDApi api)

DDAgentWriter

public DDAgentWriter(DDApi api,
                     com.datadoghq.trace.writer.WriterQueue<List<DDBaseSpan<?>>> queue)

Method Detail

write

public void write(List<DDBaseSpan<?>> trace)

Description copied from interface: Writer

Write a trace represented by the entire list of all the finished spans

Specified by:

write in interface Writer

Parameters:

trace - the list of spans to write

writeServices

public void writeServices(Map<String,Service> services)

Description copied from interface: Writer

Report additional service information to the endpoint

Specified by:

writeServices in interface Writer

Parameters:

services - a list of extra information about services

start

public void start()

Description copied from interface: Writer

Start the writer

Specified by:

start in interface Writer

close

public void close()

Description copied from interface: Writer

Indicates to the writer that no future writing will come and it should terminates all connections and tasks

Specified by:

close in interface Writer