Skip to content

Latest commit

 

History

History
53 lines (36 loc) · 2.52 KB

README.md

File metadata and controls

53 lines (36 loc) · 2.52 KB

Auto-Configuration for OpenTelemetry in Google Cloud

Maven Central

SDK AutoConfiguration

OpenTelemetry Java SDK provides an autoconfigure module where all configuration can be done entirely through Java system properties or environment variables.

To leverage the GCP extensions to this, simply add the following dependency:

<dependency>
  <groupId>com.google.cloud.opentelemetry</groupId>
  <artifactId>exporter-auto</artifactId>
  <version>0.20.0-alpha</version>
</dependency>

Note: Make sure to use the latest release LatestRelease.

Then you can configure your sdk using the following system properties/environmnet variables:

Property Environment Variable Value Description
otel.traces.exporter N/A google_cloud_trace The exporter for traces.
otel.metrics.exporter N/A google_cloud_monitoring The exporter for metrics.
GOOGLE_CLOUD_PROJECT GOOGLE_CLOUD_PROJECT autodiscovered The project_id to report metrics/traces againt.
GOOGLE_APPLICATION_CREDENTIALS GOOGLE_APPLICATION_CREDENTIALS autodiscovered Credentials to use when talking to GCP APIs.

See the autoconfigure SDK module for general environmental setup configuration.

AutoInstrumentation Setup

You can use the auto-configuration jar as an Extension to the Java auto instrumentation agent.

To instrument metrics and traces using the opentelemetry-javaagent, opentelemetry-operations-java-auto-<version>.jar can be used to provide opentelemetry exporters.

java -javaagent:path/to/opentelemetry-javaagent-<version>-all.jar \
     -Dotel.javaagent.extensions=path/to/opentelemetry-operations-java-auto-<version>.jar \
     -Dotel.traces.exporter=google_cloud_trace \
     -Dotel.metrics.exporter=google_cloud_monitoring \
     -jar myapp.jar

NOTE: The use of custom exporter in Java auto instrumentation is still undergoing a lot of churn. Until it stabilizes, this module is provided for proof-of-concept work.