Cloud Run中Datastore gRPC调用未被追踪的排查求助

• 手动注入gRPC追踪拦截器
  本地用模拟器时NDB可能自动加载了拦截器，但Cloud Run环境得手动给NDB客户端加OpenTelemetry的gRPC客户端拦截器。初始化NDB的时候这么写：

from google.cloud import ndb
from opentelemetry.instrumentation.grpc import client_interceptor

# 创建追踪拦截器
tracer_interceptor = client_interceptor(tracer)
# 初始化NDB客户端时传入拦截器列表
client = ndb.Client(grpc_interceptors=[tracer_interceptor])

• 提前OpenTelemetry初始化时机
  必须在所有NDB/Datastore相关代码跑起来之前完成OpenTelemetry的初始化，包括导出器、追踪器的配置。Cloud Run的启动流程可能让初始化滞后，把追踪配置放在代码最开头执行。

• 给服务账号加Cloud Trace权限
  Cloud Run用的服务账号得有cloudtrace.agent角色，不然追踪数据没法正常上报。去Cloud Console的IAM页面给对应账号加上这个角色就行。

• 禁用Cloud Run自动追踪避免冲突
  Cloud Run默认自带请求追踪，可能和你手动配的OpenTelemetry打架。部署的时候关掉自动追踪：

gcloud run deploy 你的服务名 --no-enable-trace

或者在控制台部署时，取消“启用Cloud Trace”的勾选。

• 确保Span上下文能传下去
  要保证请求的Span上下文能传到Datastore的gRPC调用里。在处理请求的入口（比如Flask路由），得确保当前Span处于活跃状态，NDB调用能继承父Span的上下文。可以在调用NDB前显式获取当前Span：

from opentelemetry.trace import get_current_span

def handle_request():
    current_span = get_current_span()
    with client.context():
        # 这里执行NDB操作
        MyModel.query().fetch()

内容的提问来源于stack exchange，提问作者Tom Keen