Name: cloud-trace-java
Owner: Google Cloud Platform
Description: null
Created: 2015-09-01 22:46:40.0
Updated: 2018-05-07 16:23:10.0
Pushed: 2018-05-07 16:23:08.0
Homepage: null
Size: 867
Language: Java
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Stackdriver Trace is a distributed tracing system for Google Cloud Platform that collects latency data from your applications and displays it in the Google Cloud Platform Console. You can see detailed near real-time insights into application performance. Stackdriver Trace automatically analyzes all your application traces to generate in-depth performance reports to surface application performance degradations and call flow performance bottlenecks.
The Java SDK provides programmatic access to the concepts of tracing, allowing you to start and stop trace spans, annotate spans, and write the data to Stackdriver Trace or your own service using your choice of sink.
To use this SDK, you must have an application that you'd like to trace. The app can be on Google Cloud Platform, on-premise, or another cloud platform.
If you'd like to integrate the SDK with the Stackdriver Trace service, in order view your traces in the Cloud Console UI, you must:
These steps enable the API but don't require that your app is hosted on Google Cloud Platform.
If you're using the Google Cloud Platform to host your application, this SDK is a good choice for apps on App Engine flexible environment, Google Compute Engine, and Google Container Engine. Apps on App Engine standard environment are traced automatically and don't require the use of this SDK.
To use the SDK, add the following Maven dependency to your application's pom.xml
file:
<dependency>
<groupId>com.google.cloud.trace</groupId>
<artifactId>core</artifactId>
</dependency>
Additionally, add a dependency on a TraceService
artifact which will process the trace events you create.
endency>
upId>com.google.cloud.trace</groupId>
ifactId>logging-service</artifactId>
pendency>
TraceService
will write traces to the Stackdriver Trace API using gRPC.endency>
upId>com.google.cloud.trace</groupId>
ifactId>trace-grpc-api-service</artifactId>
pendency>
If you'd like to build the SDK yourself, create a clone of this project on your local machine:
git clone https://github.com/GoogleCloudPlatform/cloud-trace-java.git
The project is organized into a core module that contains the main library classes and interfaces, and optional submodules for platform-specific additions (servlets, etc.). There is a top-level Maven POM that builds them all.
To build the project, from its root directory run:
mvn install
The following sample writes a trace span to the Stackdriver Trace API using gRPC.
endencies>
endency>
roupId>com.google.cloud.trace</groupId>
rtifactId>core</artifactId>
ersion>VERSION</version>
pendency>
endency>
roupId>com.google.cloud.trace</groupId>
rtifactId>service</artifactId>
ersion>VERSION</version>
pendency>
endency>
roupId>com.google.cloud.trace</groupId>
rtifactId>trace-grpc-api-service</artifactId>
ersion>VERSION</version>
pendency>
pendencies>
ic class Example {
ic static void main(String[] args) throws IOException {
nitialize the Tracer.
eService traceService = TraceGrpcApiService.builder()
// Set the projectId.
.setProjectId("my-project-id")
// Uncomment this if you want to provide your own credentials for the Stackdriver Trace API.
// On GCE, this is optional because the Application Default Credentials are used by default.
//.setCredentials(
// GoogleCredentials.fromStream(new FileInputStream("/path/to/my/credentials.json")))
// Use a short delay of 1 second for this example. In production, you may want to use a
// higher value so that more trace events are batched together in a single request to the
// Stackdriver Trace API. By default, the delay is 15 seconds.
.setScheduledDelay(1)
ld();
e.init(traceService);
er tracer = Trace.getTracer();
eContext context = tracer.startSpan("test-span");
er.endSpan(context);
endencies>
endency>
roupId>com.google.cloud.trace</groupId>
rtifactId>core</artifactId>
ersion>VERSION</version>
pendency>
endency>
roupId>com.google.cloud.trace</groupId>
rtifactId>service</artifactId>
ersion>VERSION</version>
pendency>
Adding this dependency auto-configures tracing to write to logs. -->
endency>
roupId>com.google.cloud.trace</groupId>
rtifactId>logging-service</artifactId>
ersion>VERSION</version>
cope>runtime</scope>
pendency>
pendencies>
ic class Example {
ic static void main(String[] args) {
er tracer = Trace.getTracer();
reate a span using the given timestamps.
eContext context = tracer.startSpan("my span 1");
kTrace.Builder stackTraceBuilder = ThrowableStackTraceHelper.createBuilder(new Exception());
er.setStackTrace(context, stackTraceBuilder.build());
er.endSpan(context);
(coming soon: Concepts, Trace Java SDK on Google Cloud Platform)