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:
LOCATION: the region where you registered the cluster.PROJECT_ID: your Google Cloud project ID.
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
- Review the Agent Gateway for cross-cloud overview
- Enforce cross-cloud governance policies
- Monitor Agent Gateway traffic
- View agent traces