feat(obs): introduce gpc.client.repo span attribute

.cloudbuild/library_generation/library_generation.Dockerfile

@@ -30,7 +30,7 @@ RUN cat /java-formatter-version
 RUN V=$(cat /java-formatter-version) && curl -o "/google-java-format.jar" "https://maven-central.storage-download.googleapis.com/maven2/com/google/googlejavaformat/google-java-format/${V}/google-java-format-${V}-all-deps.jar"
 
 # Compile and install packages
-RUN mvn install -B -ntp -DskipTests -Dclirr.skip -Dcheckstyle.skip
+RUN mvn install -B -ntp -T 1.5C -DskipTests -Dcheckstyle.skip -Dclirr.skip -Denforcer.skip -Dfmt.skip
 RUN cp "/root/.m2/repository/com/google/api/gapic-generator-java/${DOCKER_GAPIC_GENERATOR_VERSION}/gapic-generator-java-${DOCKER_GAPIC_GENERATOR_VERSION}.jar" \
   "./gapic-generator-java.jar"
 

gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/Composer.java

@@ -17,6 +17,7 @@
 import com.google.api.generator.engine.ast.ClassDefinition;
 import com.google.api.generator.engine.ast.CommentStatement;
 import com.google.api.generator.gapic.composer.comment.CommentComposer;
+import com.google.api.generator.gapic.composer.common.ServiceApiTracerContextClassComposer;
 import com.google.api.generator.gapic.composer.grpc.GrpcServiceCallableFactoryClassComposer;
 import com.google.api.generator.gapic.composer.grpc.GrpcServiceStubClassComposer;
 import com.google.api.generator.gapic.composer.grpc.MockServiceClassComposer;
@@ -86,6 +87,7 @@ public static List<GapicClass> generateStubClasses(GapicContext context) {
         .services()
         .forEach(
             s -> {
+              clazzes.add(ServiceApiTracerContextClassComposer.instance().generate(context, s));
               if (context.transport() == Transport.REST) {
                 clazzes.add(
                     com.google.api.generator.gapic.composer.rest.ServiceStubClassComposer.instance()

gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceStubSettingsClassComposer.java

@@ -49,6 +49,7 @@
 import com.google.api.gax.rpc.TransportChannelProvider;
 import com.google.api.gax.rpc.UnaryCallSettings;
 import com.google.api.gax.rpc.UnaryCallable;
+import com.google.api.gax.tracing.ApiTracerContext;
 import com.google.api.generator.engine.ast.AnnotationNode;
 import com.google.api.generator.engine.ast.AnonymousClassExpr;
 import com.google.api.generator.engine.ast.AssignmentExpr;
@@ -1053,6 +1054,7 @@ private List<MethodDefinition> createClassMethods(
             SettingsCommentComposer.NEW_BUILDER_METHOD_COMMENT));
     javaMethods.addAll(createBuilderHelperMethods(service, typeStore));
     javaMethods.add(createClassConstructor(service, methodSettingsMemberVarExprs, typeStore));
+    javaMethods.add(createGetApiTracerContextMethod(service, typeStore));
     return javaMethods;
   }
 
@@ -2096,6 +2098,31 @@ private static MethodDefinition createNestedClassBuildMethod(
         .build();
   }
 
+  private MethodDefinition createGetApiTracerContextMethod(Service service, TypeStore typeStore) {
+    TypeNode returnType = FIXED_TYPESTORE.get("ApiTracerContext");
+    VariableExpr serverAddressVarExpr =
+        VariableExpr.withVariable(
+            Variable.builder().setType(TypeNode.STRING).setName("serverAddress").build());
+
+    TypeNode serviceApiTracerContextType =
+        typeStore.get(ClassNames.getServiceApiTracerContextClassName(service));
+
+    return MethodDefinition.builder()
+        .setIsOverride(true)
+        .setScope(ScopeNode.PROTECTED)
+        .setReturnType(returnType)
+        .setName("getApiTracerContext")
+        .setArguments(serverAddressVarExpr.toBuilder().setIsDecl(true).build())
+        .setReturnExpr(
+            MethodInvocationExpr.builder()
+                .setStaticReferenceType(serviceApiTracerContextType)
+                .setMethodName("create")
+                .setArguments(serverAddressVarExpr)
+                .setReturnType(returnType)
+                .build())
+        .build();
+  }
+
   private static TypeStore createStaticTypes() {
     List<Class<?>> concreteClazzes =
         Arrays.asList(
@@ -2143,7 +2170,8 @@ private static TypeStore createStaticTypes() {
             StubSettings.class,
             TransportChannelProvider.class,
             UnaryCallSettings.class,
-            UnaryCallable.class);
+            UnaryCallable.class,
+            ApiTracerContext.class);
     return new TypeStore(concreteClazzes);
   }
 
@@ -2175,6 +2203,8 @@ private TypeStore createDynamicTypes(Service service, String pakkage) {
         true,
         ClassNames.getServiceClientClassName(service));
 
+    typeStore.put(pakkage, ClassNames.getServiceApiTracerContextClassName(service));
+
     return typeStore;
   }
 

gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/ServiceApiTracerContextClassComposer.java

@@ -0,0 +1,205 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.api.generator.gapic.composer.common;
+
+import com.google.api.core.BetaApi;
+import com.google.api.core.InternalApi;
+import com.google.api.gax.tracing.ApiTracerContext;
+import com.google.api.generator.engine.ast.AnnotationNode;
+import com.google.api.generator.engine.ast.AssignmentExpr;
+import com.google.api.generator.engine.ast.ClassDefinition;
+import com.google.api.generator.engine.ast.Expr;
+import com.google.api.generator.engine.ast.ExprStatement;
+import com.google.api.generator.engine.ast.MethodDefinition;
+import com.google.api.generator.engine.ast.ScopeNode;
+import com.google.api.generator.engine.ast.Statement;
+import com.google.api.generator.engine.ast.StringObjectValue;
+import com.google.api.generator.engine.ast.ThisObjectValue;
+import com.google.api.generator.engine.ast.TypeNode;
+import com.google.api.generator.engine.ast.ValueExpr;
+import com.google.api.generator.engine.ast.Variable;
+import com.google.api.generator.engine.ast.VariableExpr;
+import com.google.api.generator.gapic.composer.store.TypeStore;
+import com.google.api.generator.gapic.composer.utils.ClassNames;
+import com.google.api.generator.gapic.model.GapicClass;
+import com.google.api.generator.gapic.model.GapicContext;
+import com.google.api.generator.gapic.model.Service;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import javax.annotation.Generated;
+import javax.annotation.Nullable;
+
+/**
+ * Composes a service-specific implementation of {@link ApiTracerContext}.
+ *
+ * <p>The generated class is used to provide client-library-specific attributes (like the repository
+ * URL) to {@link com.google.api.gax.tracing.ApiTracer}s.
+ */
+public class ServiceApiTracerContextClassComposer implements ClassComposer {
+  private static final ServiceApiTracerContextClassComposer INSTANCE =
+      new ServiceApiTracerContextClassComposer();
+
+  private static final TypeStore FIXED_TYPESTORE = createStaticTypes();
+
+  private ServiceApiTracerContextClassComposer() {}
+
+  public static ServiceApiTracerContextClassComposer instance() {
+    return INSTANCE;
+  }
+
+  @Override
+  public GapicClass generate(GapicContext context, Service service) {
+    String pakkage = String.format("%s.stub", service.pakkage());
+    String className = ClassNames.getServiceApiTracerContextClassName(service);
+    TypeStore typeStore = createDynamicTypes(service, pakkage);
+
+    ClassDefinition classDef =
+        ClassDefinition.builder()
+            .setPackageString(pakkage)
+            .setAnnotations(createClassAnnotations())
+            .setScope(ScopeNode.PUBLIC)
+            .setName(className)
+            .setExtendsType(FIXED_TYPESTORE.get("ApiTracerContext"))
+            .setStatements(createClassStatements())
+            .setMethods(createClassMethods(service, context, typeStore))
+            .build();
+
+    return GapicClass.create(GapicClass.Kind.STUB, classDef);
+  }
+
+  private static List<AnnotationNode> createClassAnnotations() {
+    return Arrays.asList(
+        AnnotationNode.withType(FIXED_TYPESTORE.get("InternalApi")),
+        AnnotationNode.withType(FIXED_TYPESTORE.get("BetaApi")),
+        AnnotationNode.builder()
+            .setType(FIXED_TYPESTORE.get("Generated"))
+            .setDescription("by gapic-generator-java")
+            .build());
+  }
+
+  private static List<Statement> createClassStatements() {
+    VariableExpr serverAddressVarExpr =
+        VariableExpr.withVariable(
+            Variable.builder().setType(TypeNode.STRING).setName("serverAddress").build());
+    return Arrays.asList(
+        ExprStatement.withExpr(
+            serverAddressVarExpr.toBuilder()
+                .setIsDecl(true)
+                .setScope(ScopeNode.PRIVATE)
+                .setIsFinal(true)
+                .build()));
+  }
+
+  private static List<MethodDefinition> createClassMethods(
+      Service service, GapicContext context, TypeStore typeStore) {
+    List<MethodDefinition> methods = new ArrayList<>();
+    methods.add(createConstructor(service, typeStore));
+    methods.add(createCreateMethod(service, typeStore));
+    methods.add(createGetServerAddressMethod());
+    methods.add(createGetRepoMethod(context));
+    return methods;
+  }
+
+  private static MethodDefinition createConstructor(Service service, TypeStore typeStore) {
+    TypeNode thisType = typeStore.get(ClassNames.getServiceApiTracerContextClassName(service));
+    VariableExpr serverAddressVarExpr =
+        VariableExpr.withVariable(
+            Variable.builder().setType(TypeNode.STRING).setName("serverAddress").build());
+
+    VariableExpr thisServerAddressVarExpr =
+        VariableExpr.builder()
+            .setVariable(serverAddressVarExpr.variable())
+            .setExprReferenceExpr(ValueExpr.withValue(ThisObjectValue.withType(thisType)))
+            .build();
+
+    return MethodDefinition.constructorBuilder()
+        .setScope(ScopeNode.PRIVATE)
+        .setReturnType(thisType)
+        .setArguments(serverAddressVarExpr.toBuilder().setIsDecl(true).build())
+        .setBody(
+            Arrays.asList(
+                ExprStatement.withExpr(
+                    AssignmentExpr.builder()
+                        .setVariableExpr(thisServerAddressVarExpr)
+                        .setValueExpr(serverAddressVarExpr)
+                        .build())))
+        .build();
+  }
+
+  private static MethodDefinition createCreateMethod(Service service, TypeStore typeStore) {
+    TypeNode thisType = typeStore.get(ClassNames.getServiceApiTracerContextClassName(service));
+    VariableExpr serverAddressVarExpr =
+        VariableExpr.withVariable(
+            Variable.builder().setType(TypeNode.STRING).setName("serverAddress").build());
+
+    return MethodDefinition.builder()
+        .setScope(ScopeNode.PUBLIC)
+        .setIsStatic(true)
+        .setReturnType(thisType)
+        .setName("create")
+        .setArguments(serverAddressVarExpr.toBuilder().setIsDecl(true).build())
+        .setReturnExpr(
+            com.google.api.generator.engine.ast.NewObjectExpr.builder()
+                .setType(thisType)
+                .setArguments(serverAddressVarExpr)
+                .build())
+        .build();
+  }
+
+  private static MethodDefinition createGetServerAddressMethod() {
+    return MethodDefinition.builder()
+        .setIsOverride(true)
+        .setScope(ScopeNode.PUBLIC)
+        .setReturnType(TypeNode.STRING)
+        .setName("getServerAddress")
+        .setReturnExpr(
+            VariableExpr.withVariable(
+                Variable.builder().setType(TypeNode.STRING).setName("serverAddress").build()))
+        .build();
+  }
+
+  private static MethodDefinition createGetRepoMethod(GapicContext context) {
+    Expr returnExpr = ValueExpr.createNullExpr();
+    if (context.repo().isPresent()) {
+      returnExpr = ValueExpr.withValue(StringObjectValue.withValue(context.repo().get()));
+    }
+    return MethodDefinition.builder()
+        .setIsOverride(true)
+        .setScope(ScopeNode.PUBLIC)
+        .setReturnType(TypeNode.STRING)
+        .setName("getRepo")
+        .setReturnExpr(returnExpr)
+        .build();
+  }
+
+  private static TypeStore createStaticTypes() {
+    return new TypeStore(
+        Arrays.asList(
+            BetaApi.class,
+            InternalApi.class,
+            Generated.class,
+            ApiTracerContext.class,
+            Nullable.class));
+  }
+
+  private TypeStore createDynamicTypes(Service service, String pakkage) {
+    TypeStore typeStore = new TypeStore();
+    typeStore.put(pakkage, ClassNames.getServiceApiTracerContextClassName(service));
+    return typeStore;
+  }
+}

gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/utils/ClassNames.java

@@ -34,6 +34,7 @@ public class ClassNames {
   private static final String TRANSPORT_SERVICE_STUB_CLASS_NAME_PATTERN = "%s%sStub";
   private static final String TRANSPORT_SERVICE_CALLABLE_FACTORY_CLASS_NAME_PATTERN =
       "%s%sCallableFactory";
+  private static final String SERVICE_API_TRACER_CONTEXT_CLASS_NAME_PATTERN = "%sApiTracerContext";
 
   private final List<String> transportPrefixes;
 
@@ -116,6 +117,12 @@ public static String getMockServiceImplClassName(Service service) {
     return String.format(MOCK_SERVICE_IMPL_CLASS_NAME_PATTERN, service.name());
   }
 
+  public static String getServiceApiTracerContextClassName(Service service) {
+    return String.format(
+        SERVICE_API_TRACER_CONTEXT_CLASS_NAME_PATTERN,
+        monolithBackwardsCompatibleName(service.name()));
+  }
+
   private static String monolithBackwardsCompatibleName(String rawServiceName) {
     return rawServiceName.startsWith("IAMCredentials")
         ? rawServiceName.replace("IAM", "Iam")

gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/GapicContext.java

@@ -95,11 +95,14 @@ static GapicMetadata defaultGapicMetadata() {
 
   public abstract Transport transport();
 
+  public abstract Optional<String> repo();
+
   public static Builder builder() {
     return new AutoValue_GapicContext.Builder()
         .setMixinServices(Collections.emptyList())
         .setGapicMetadataEnabled(false)
-        .setRestNumericEnumsEnabled(false);
+        .setRestNumericEnumsEnabled(false)
+        .setRepo(Optional.empty());
   }
 
   @AutoValue.Builder
@@ -130,6 +133,8 @@ public Builder setHelperResourceNames(Set<ResourceName> helperResourceNames) {
 
     public abstract Builder setTransport(Transport transport);
 
+    public abstract Builder setRepo(Optional<String> repo);
+
     abstract ImmutableMap<String, ResourceName> resourceNames();
 
     abstract ImmutableMap<String, ResourceName> helperResourceNames();

gapic-generator-java/src/main/java/com/google/api/generator/gapic/protoparser/Parser.java

@@ -150,6 +150,7 @@ public static GapicContext parse(CodeGeneratorRequest request) {
     Optional<GapicLanguageSettings> languageSettingsOpt =
         GapicLanguageSettingsParser.parse(gapicYamlConfigPathOpt);
     Optional<String> transportOpt = PluginArgumentParser.parseTransport(request);
+    Optional<String> repoOpt = PluginArgumentParser.parseRepo(request);
 
     boolean willGenerateMetadata = PluginArgumentParser.hasMetadataFlag(request);
     boolean willGenerateNumericEnum = PluginArgumentParser.hasNumericEnumFlag(request);
@@ -253,6 +254,7 @@ public static GapicContext parse(CodeGeneratorRequest request) {
         .setServiceYamlProto(serviceYamlProtoOpt.orElse(null))
         .setTransport(transport)
         .setRestNumericEnumsEnabled(willGenerateNumericEnum)
+        .setRepo(repoOpt)
         .build();
   }
 

gapic-generator-java/src/main/java/com/google/api/generator/gapic/protoparser/PluginArgumentParser.java

@@ -32,6 +32,7 @@ public class PluginArgumentParser {
   @VisibleForTesting static final String KEY_NUMERIC_ENUM = "rest-numeric-enums";
   @VisibleForTesting static final String KEY_SERVICE_YAML_CONFIG = "api-service-config";
   @VisibleForTesting static final String KEY_TRANSPORT = "transport";
+  @VisibleForTesting static final String KEY_REPO = "repo";
 
   private static final String JSON_FILE_ENDING = "grpc_service_config.json";
   private static final String GAPIC_YAML_FILE_ENDING = "gapic.yaml";
@@ -53,6 +54,10 @@ static Optional<String> parseTransport(CodeGeneratorRequest request) {
     return parseConfigArgument(request.getParameter(), KEY_TRANSPORT);
   }
 
+  static Optional<String> parseRepo(CodeGeneratorRequest request) {
+    return parseConfigArgument(request.getParameter(), KEY_REPO);
+  }
+
   static boolean hasMetadataFlag(CodeGeneratorRequest request) {
     return hasFlag(request.getParameter(), KEY_METADATA);
   }