Agent Engineに追加されたオブザーバビリティ機能をコード上から有効化する方法

概要

2025年11月7日に、Agent Engineのコンソール上にオブザーバビリティ機能が追加されました。（プレビュー状態）

Configure, manage, and view observability features such as sessions, traces, logs, and events for your agent in the Google Cloud console.

https://docs.cloud.google.com/agent-builder/release-notes#November_07_2025

具体的には、以下の2つがコンソール上から確認可能になりました。

• OpenTelemetryによるトレース
• 入出力内容のログ

この2つの制御は、Agent Engineのコンソール上から可能で、トグルボタンを操作することで有効化が可能です。

ただし、関連ライブラリのバージョンが低いと有効化は不可能です。

オブザーバビリティ設定は、エージェントが google-cloud-aiplatform ≥ v1.126.1 および google-adk ≥ v1.18.0 を使用している場合にのみサポートされます。エージェントの依存関係を更新して再デプロイしてください。

有効化後、コンソール上からAgentとやりとりを行った際の、トレースの詳細（スパンの有向非巡回グラフ（DAG）、入力と出力、メタデータ属性など）を確認することが可能です。

また、ログ上から入出力の内容を確認することも可能です。

ここまでで、OpenTelemetryによるトレースと入出力内容のログの制御がコンソール上から可能なことを確認しました。
では、コード上から有効化する方法はあるのでしょうか？

コード上から設定を有効化する

Agent Development Kit（ADK）の場合、以下の環境変数を追加することで、制御可能です。

• GOOGLE_CLOUD_AGENT_ENGINE_ENABLE_TELEMETRY（OpenTelemetryによるトレース）
• OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT（入出力内容のログ）

https://docs.cloud.google.com/agent-builder/agent-engine/manage/tracing#write-traces

ソースコード上では、env_varsに追加します。

app = agent_engines.AdkApp(agent=root_agent)

remote_app = agent_engines.create(
    display_name=AGENT_NAME,
    agent_engine=app,
    # この部分
    env_vars={
        "GOOGLE_CLOUD_AGENT_ENGINE_ENABLE_TELEMETRY": "true",
        "OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT": "true",
    },
    requirements=[
        "google-cloud-aiplatform[adk,agent_engines]",
    ],
)

AdkAppのenable_tracingではなく環境変数で制御することが推奨されている

AdkAppのenable_tracingでも同様にAgent Engineのトレースを有効化にすることが可能です。

app = agent_engines.AdkApp(agent=root_agent, enable_tracing=True)

remote_app = agent_engines.create(
    display_name=AGENT_NAME,
    agent_engine=app,
    requirements=[
        "google-cloud-aiplatform[adk,agent_engines]",
    ],
)

しかし、環境変数で制御が可能になってからは、enable_tracingよりも環境変数で制御することが推奨されています。

Note: If you were previously setting the enable_tracing flag, we recommend you use the environment variables instead. For example, set GOOGLE_CLOUD_AGENT_ENGINE_ENABLE_TELEMETRY=true instead of enable_tracing=true, and set GOOGLE_CLOUD_AGENT_ENGINE_ENABLE_TELEMETRY=false instead of enable_tracing=false.

https://docs.cloud.google.com/agent-builder/agent-engine/manage/tracing#write-traces

まとめ

• 新たにAgent Engineのコンソール上に追加されたオブザーバビリティ機能を確認しました。
• コード上からは環境変数で制御可能なことを確認しました。
• 環境変数で制御が可能になってからは、enable_tracingよりも環境変数で制御することが推奨されていることを確認しました。