io.opencensus.exporter.trace.stackdriver

Class StackdriverTraceExporter

java.lang.Object

io.opencensus.exporter.trace.stackdriver.StackdriverTraceExporter

public final class StackdriverTraceExporter
extends Object

An OpenCensus span exporter implementation which exports data to Stackdriver Trace.

Example of usage on Google Cloud VMs:

 public static void main(String[] args) {
   StackdriverTraceExporter.createAndRegister(
       StackdriverTraceConfiguration.builder()
           .setProjectId("MyStackdriverProjectId")
           .build());
   ... // Do work.
 }
 

Since:

0.12

Method Summary

Modifier and Type	Method and Description
static void	createAndRegister(StackdriverTraceConfiguration configuration) Creates and registers the Stackdriver Trace exporter to the OpenCensus library.
static void	unregister() Unregisters the Stackdriver Trace exporter from the OpenCensus library.

Methods inherited from class java.lang.Object

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

Method Detail

createAndRegister

public static void createAndRegister(StackdriverTraceConfiguration configuration)
                              throws IOException

Creates and registers the Stackdriver Trace exporter to the OpenCensus library. Only one Stackdriver exporter can be registered at any point.

If the credentials in the provided StackdriverTraceConfiguration is not set, the exporter will use the default application credentials. See GoogleCredentials.getApplicationDefault().

If the projectId in the provided StackdriverTraceConfiguration is not set, the exporter will use the default project ID. See ServiceOptions.getDefaultProjectId().

Parameters:

configuration - the StackdriverTraceConfiguration used to create the exporter.

Throws:

IllegalStateException - if a Stackdriver exporter is already registered.

IOException

Since:

0.12

unregister

public static void unregister()

Unregisters the Stackdriver Trace exporter from the OpenCensus library.

Throws:

IllegalStateException - if a Stackdriver exporter is not registered.

Since:

0.12