fix: do a quick check if the application runs on GCP (#4163)

* fix: do a quick check if the application runs on GCP

The check whether the application runs on GCP did not use a timeout. This introduces
a default 500ms timeout for that check.

Fixes googleapis/java-spanner-jdbc#2250

* make location static and fetch it only once

* chore: generate libraries at Mon Oct 13 07:06:03 UTC 2025

* changing the timeout to 5 sec

* review comments

---------

Co-authored-by: Surbhi Garg <gargsurbhi@google.com>
Co-authored-by: surbhigarg92 <surbhigarg.92@gmail.com>
Co-authored-by: cloud-java-bot <cloud-java-bot@google.com>

Author: 3 people

.github/workflows/update_generation_config.yaml

@@ -26,7 +26,7 @@ jobs:
       # the branch into which the pull request is merged
       base_branch: main
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
         token: ${{ secrets.CLOUD_JAVA_BOT_TOKEN }}

google-cloud-spanner/src/main/java/com/google/cloud/spanner/BuiltInMetricsProvider.java

@@ -32,6 +32,7 @@
 import com.google.cloud.opentelemetry.detection.AttributeKeys;
 import com.google.cloud.opentelemetry.detection.DetectedPlatform;
 import com.google.cloud.opentelemetry.detection.GCPPlatformDetector;
+import com.google.common.base.Strings;
 import com.google.common.hash.HashFunction;
 import com.google.common.hash.Hashing;
 import io.grpc.ManagedChannelBuilder;
@@ -43,11 +44,17 @@
 import io.opentelemetry.sdk.metrics.SdkMeterProvider;
 import io.opentelemetry.sdk.metrics.SdkMeterProviderBuilder;
 import io.opentelemetry.sdk.resources.Resource;
+import java.io.BufferedReader;
 import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
 import java.lang.management.ManagementFactory;
 import java.lang.reflect.Method;
+import java.net.HttpURLConnection;
 import java.net.InetAddress;
+import java.net.URL;
 import java.net.UnknownHostException;
+import java.nio.charset.StandardCharsets;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.UUID;
@@ -63,6 +70,10 @@ final class BuiltInMetricsProvider {
 
   private static String taskId;
 
+  private static String location;
+
+  private static final String default_location = "global";
+
   private OpenTelemetry openTelemetry;
 
   private BuiltInMetricsProvider() {}
@@ -95,6 +106,36 @@ OpenTelemetry getOrCreateOpenTelemetry(
     }
   }
 
+  // TODO: Remove when
+  // https://github.com/GoogleCloudPlatform/opentelemetry-operations-java/issues/421
+  //       has been fixed.
+  static boolean quickCheckIsRunningOnGcp() {
+    int timeout = 5000;
+    try {
+      timeout =
+          Integer.parseInt(System.getProperty("spanner.check_is_running_on_gcp_timeout", "5000"));
+    } catch (NumberFormatException ignore) {
+      // ignore
+    }
+    try {
+      URL url = new URL("http://metadata.google.internal/computeMetadata/v1/project/project-id");
+      HttpURLConnection connection = (HttpURLConnection) url.openConnection();
+      connection.setConnectTimeout(timeout);
+      connection.setRequestProperty("Metadata-Flavor", "Google");
+      if (connection.getResponseCode() == 200
+          && ("Google").equals(connection.getHeaderField("Metadata-Flavor"))) {
+        InputStream input = connection.getInputStream();
+        try (BufferedReader reader =
+            new BufferedReader(new InputStreamReader(input, StandardCharsets.UTF_8))) {
+          return !Strings.isNullOrEmpty(reader.readLine());
+        }
+      }
+    } catch (IOException ignore) {
+      // ignore
+    }
+    return false;
+  }
+
   void enableGrpcMetrics(
       InstantiatingGrpcChannelProvider.Builder channelProviderBuilder,
       String projectId,
@@ -171,14 +212,20 @@ static String generateClientHash(String clientUid) {
   }
 
   static String detectClientLocation() {
-    GCPPlatformDetector detector = GCPPlatformDetector.DEFAULT_INSTANCE;
-    DetectedPlatform detectedPlatform = detector.detectPlatform();
-    // All platform except GKE uses "cloud_region" for region attribute.
-    String region = detectedPlatform.getAttributes().get("cloud_region");
-    if (detectedPlatform.getSupportedPlatform() == GOOGLE_KUBERNETES_ENGINE) {
-      region = detectedPlatform.getAttributes().get(AttributeKeys.GKE_CLUSTER_LOCATION);
+    if (location == null) {
+      location = default_location;
+      if (quickCheckIsRunningOnGcp()) {
+        GCPPlatformDetector detector = GCPPlatformDetector.DEFAULT_INSTANCE;
+        DetectedPlatform detectedPlatform = detector.detectPlatform();
+        // All platform except GKE uses "cloud_region" for region attribute.
+        String region = detectedPlatform.getAttributes().get("cloud_region");
+        if (detectedPlatform.getSupportedPlatform() == GOOGLE_KUBERNETES_ENGINE) {
+          region = detectedPlatform.getAttributes().get(AttributeKeys.GKE_CLUSTER_LOCATION);
+        }
+        location = region == null ? location : region;
+      }
     }
-    return region == null ? "global" : region;
+    return location;
   }
 
   /**