Configure cross-cloud agent observability

This guide explains how to configure observability and telemetry for Agent Gateway for cross-cloud in Gemini Enterprise Agent Platform.

Cross-cloud agent observability is enabled by default through an OpenTelemetry (OTel) collector, which sends access logs and agent telemetry to Cloud Logging and Cloud Trace. The collector runs in the geap-system namespace. It receives Layer 8 (L8) agentic signals for large language model (LLM), Model Context Protocol (MCP), and Agent-to-Agent (A2A) traffic, and exports them with each agent's Agent Identity.

View Agent Gateway access logs

Agent Gateway for cross-cloud writes an access log entry to Cloud Logging for every request that passes through the gateway. The entries use the networkservices.googleapis.com/AgentGateway resource type.

To read the access logs, run the following command:

gcloud logging read \
    'resource.type="networkservices.googleapis.com/AgentGateway"
    resource.labels.location="LOCATION"
    logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fagent_gateway_hybrid_access"' \
    --project=PROJECT_ID

Replace the following:

Configure agents to emit traces

You can configure your agents to emit trace spans that follow the OpenTelemetry semantic conventions for generative AI agent spans. The OTel collector forwards these spans to Cloud Trace.

To send spans to the collector, configure your agent's OTel exporter to use one of the following OTLP endpoints. The collector accepts OTLP over both gRPC and HTTP:

  • gRPC: http://gboc.geap-system.svc.cluster.local:4317
  • HTTP: http://gboc.geap-system.svc.cluster.local:4318

Many OTel SDKs read the OTEL_EXPORTER_OTLP_ENDPOINT and OTEL_EXPORTER_OTLP_PROTOCOL environment variables. For example, to export over gRPC:

env:
- name: OTEL_EXPORTER_OTLP_ENDPOINT
  value: "http://gboc.geap-system.svc.cluster.local:4317"
- name: OTEL_EXPORTER_OTLP_PROTOCOL
  value: "grpc"

To export over HTTP:

env:
- name: OTEL_EXPORTER_OTLP_ENDPOINT
  value: "http://gboc.geap-system.svc.cluster.local:4318"
- name: OTEL_EXPORTER_OTLP_PROTOCOL
  value: "http/protobuf"

The agent that emits the telemetry must be registered in Agent Registry.

What's next