|
| 1 | +/* |
| 2 | + * Copyright 2025 Google LLC |
| 3 | + * |
| 4 | + * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | + * you may not use this file except in compliance with the License. |
| 6 | + * You may obtain a copy of the License at |
| 7 | + * |
| 8 | + * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | + * |
| 10 | + * Unless required by applicable law or agreed to in writing, software |
| 11 | + * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | + * See the License for the specific language governing permissions and |
| 14 | + * limitations under the License. |
| 15 | + */ |
| 16 | + |
| 17 | +package com.example.bigquery; |
| 18 | + |
| 19 | +// [START bigquery_enable_otel_tracing] |
| 20 | +import com.google.cloud.bigquery.BigQuery; |
| 21 | +import com.google.cloud.bigquery.BigQueryOptions; |
| 22 | +import com.google.cloud.bigquery.Dataset; |
| 23 | +import com.google.cloud.bigquery.DatasetInfo; |
| 24 | +import io.opentelemetry.api.OpenTelemetry; |
| 25 | +import io.opentelemetry.api.common.AttributeKey; |
| 26 | +import io.opentelemetry.api.trace.Span; |
| 27 | +import io.opentelemetry.api.trace.Tracer; |
| 28 | +import io.opentelemetry.context.Scope; |
| 29 | +import io.opentelemetry.sdk.OpenTelemetrySdk; |
| 30 | +import io.opentelemetry.sdk.common.CompletableResultCode; |
| 31 | +import io.opentelemetry.sdk.trace.SdkTracerProvider; |
| 32 | +import io.opentelemetry.sdk.trace.data.SpanData; |
| 33 | +import io.opentelemetry.sdk.trace.export.SimpleSpanProcessor; |
| 34 | +import io.opentelemetry.sdk.trace.samplers.Sampler; |
| 35 | +import java.util.Collection; |
| 36 | +import java.util.HashMap; |
| 37 | +import java.util.Map; |
| 38 | + |
| 39 | +public class EnableOpenTelemetryTracing { |
| 40 | + // Maps Span names to their Span IDs. |
| 41 | + private static final Map<String, String> OTEL_SPAN_IDS = new HashMap<>(); |
| 42 | + |
| 43 | + // Create a SpanExporter to determine how to handle captured Span data. |
| 44 | + // See more at https://opentelemetry.io/docs/languages/java/sdk/#spanexporter |
| 45 | + private static class SampleSpanExporter |
| 46 | + implements io.opentelemetry.sdk.trace.export.SpanExporter { |
| 47 | + |
| 48 | + // TODO(developer): Replace export output before running the sample. |
| 49 | + @Override |
| 50 | + public CompletableResultCode export(Collection<SpanData> collection) { |
| 51 | + // Export data. This data can be sent out of process via netowork calls, though |
| 52 | + // for this example local data structures are used. |
| 53 | + if (collection.isEmpty()) { |
| 54 | + // No span data was collected. |
| 55 | + return CompletableResultCode.ofFailure(); |
| 56 | + } |
| 57 | + |
| 58 | + for (SpanData data : collection) { |
| 59 | + OTEL_SPAN_IDS.put(data.getName(), data.getSpanId()); |
| 60 | + } |
| 61 | + return CompletableResultCode.ofSuccess(); |
| 62 | + } |
| 63 | + |
| 64 | + // TODO(developer): Replace these functions to suit your needs. |
| 65 | + @Override |
| 66 | + public CompletableResultCode flush() { |
| 67 | + // Export any data that has been queued up but not yet exported. |
| 68 | + return CompletableResultCode.ofSuccess(); |
| 69 | + } |
| 70 | + |
| 71 | + @Override |
| 72 | + public CompletableResultCode shutdown() { |
| 73 | + // Shut down the exporter and clean up any resources. |
| 74 | + return CompletableResultCode.ofSuccess(); |
| 75 | + } |
| 76 | + } |
| 77 | + |
| 78 | + public static void main(String[] args) { |
| 79 | + // TODO(developer): Replace Tracer name |
| 80 | + final String tracerName = "Sample Tracer"; |
| 81 | + enableOpenTelemetry(tracerName); |
| 82 | + } |
| 83 | + |
| 84 | + public static void enableOpenTelemetry(String tracerName) { |
| 85 | + // Create TracerProvider using the custom SpanExporter. |
| 86 | + SdkTracerProvider tracerProvider = |
| 87 | + SdkTracerProvider.builder() |
| 88 | + .addSpanProcessor(SimpleSpanProcessor.create(new SampleSpanExporter())) |
| 89 | + .setSampler(Sampler.alwaysOn()) |
| 90 | + .build(); |
| 91 | + |
| 92 | + // Create global OpenTelemetry instance using the TracerProvider. |
| 93 | + OpenTelemetry otel = |
| 94 | + OpenTelemetrySdk.builder().setTracerProvider(tracerProvider).buildAndRegisterGlobal(); |
| 95 | + |
| 96 | + // Create Tracer instance from the global OpenTelemetry object. Tracers are used to create |
| 97 | + // Spans. There can be multiple Tracers in a global OpenTelemetry instance. |
| 98 | + Tracer tracer = otel.getTracer(tracerName); |
| 99 | + |
| 100 | + // Create BigQuery client to trace. EnableOpenTelemetryTracing and OpenTelemetryTracer must |
| 101 | + // be set to enable tracing. |
| 102 | + BigQueryOptions otelOptions = |
| 103 | + BigQueryOptions.newBuilder() |
| 104 | + .setEnableOpenTelemetryTracing(true) |
| 105 | + .setOpenTelemetryTracer(tracer) |
| 106 | + .build(); |
| 107 | + BigQuery bigquery = otelOptions.getService(); |
| 108 | + |
| 109 | + // Create dataset. |
| 110 | + final String datasetId = "sampleDatasetId"; |
| 111 | + DatasetInfo info = DatasetInfo.newBuilder(datasetId).build(); |
| 112 | + Dataset dataset = bigquery.create(info); |
| 113 | + |
| 114 | + if (OTEL_SPAN_IDS.containsKey("com.google.cloud.bigquery.BigQuery.createDataset")) { |
| 115 | + System.out.println("createDataset Span was captured!"); |
| 116 | + } |
| 117 | + |
| 118 | + bigquery.delete(datasetId); |
| 119 | + } |
| 120 | +} |
| 121 | +// [END bigquery_enable_otel_tracing] |
0 commit comments