Melihat log transaksi proxy

Log transaksi proxy memberikan informasi mendetail tentang setiap permintaan yang diproses oleh Secure Web Proxy. Log ini mencakup data setiap transaksi yang dimediasi oleh Secure Web Proxy antara pengguna dan internet. Dokumen ini menjelaskan cara mengakses dan menafsirkan log transaksi yang dihasilkan oleh instance Secure Web Proxy Anda.

Jenis entri log transaksi proxy

Entri log transaksi proxy terdiri dari tiga jenis:

Log ini berguna untuk tindakan berikut:

  • Analisis keamanan dan deteksi ancaman
  • Memecahkan masalah konektivitas dan kebijakan
  • Mengaudit akses web
  • Analisis performa Secure Web Proxy

HttpRequest

Entri log ini berisi informasi berikut:

Nama Jenis Deskripsi
requestMethod String Jenis metode permintaan, seperti GET, HEAD, PUT, atau POST.
requestUrl String Skema (http atau https), nama host, jalur, dan bagian kueri dari URL yang diminta. Contoh, http://example.com/some/info?color=red.
requestSize

String (format int64)

 Ukuran, dalam byte, pesan permintaan HTTP, termasuk header permintaan dan isi permintaan.
status Bilangan bulat Kode status HTTP atau HTTPS yang menunjukkan respons. Misalnya, 200 OK atau 404 Not Found.
responseSize String (format int64) Ukuran, dalam byte, kode status HTTP yang dikirim kembali ke klien, termasuk header dan isi.
userAgent String Agen pengguna yang dikirim klien, seperti Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705).
remoteIp String Alamat IP (IPv4 atau IPv6) klien yang menerbitkan permintaan HTTP. Kolom ini dapat menyertakan informasi port. Misalnya, 192.168.1.1, 10.0.0.1:80, dan FE80::0202:B3FF:FE1E:8329.
serverIp String Alamat IP (IPv4 atau IPv6) server asal tempat permintaan dikirim. Kolom ini dapat menyertakan informasi port. Misalnya, 192.168.1.1, 10.0.0.1:80, dan FE80::0202:B3FF:FE1E:8329.
referrer String URL perujuk permintaan, seperti yang ditentukan dalam Definisi Kolom Header HTTP/1.1.
latency String (format Duration) Latensi pemrosesan permintaan di server, dari saat permintaan diterima hingga respons dikirim.

Latensi adalah durasi dalam detik dengan maksimal sembilan digit pecahan dan diakhiri dengan s, seperti 3.5s.
cacheLookup Boolean Menunjukkan apakah pencarian cache dicoba.
cacheHit Boolean Menunjukkan apakah entity disajikan dari cache (dengan atau tanpa validasi).
cacheValidatedWithOriginServer Boolean Menunjukkan apakah respons divalidasi dengan server asal sebelum disajikan dari cache. Kolom ini hanya bermakna jika cacheHit adalah True.
cacheFillBytes String (format int64) Jumlah byte kode status HTTP yang disisipkan.
protocol String Protokol yang digunakan untuk permintaan, seperti HTTP/1.1, HTTP/2, dan websocket.

LoadBalancerLogEntry

Entri log ini berisi informasi berikut:

Nama Jenis Deskripsi
insertId String ID log unik.
jsonPayload.@type String Jenis log. Nilai jenis log selalu type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry.
jsonPayload.enforcedGatewaySecurityPolicy.hostname String Nama host yang terkait dengan permintaan.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action String Tindakan yang diambil atas permintaan.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.rule String Nama aturan yang diterapkan ke permintaan.
jsonPayload.enforcedGatewaySecurityPolicy.clientServiceAccount String Akun layanan yang terkait dengan permintaan.
jsonPayload.enforcedGatewaySecurityPolicy.clientSecureTags String Tag aman yang terkait dengan permintaan.

GatewayLogEntry

Entri log ini berisi informasi berikut:

Nama Jenis Deskripsi
resource_container String Container yang terkait dengan gateway.
location String Nama region tempat gateway ditentukan.
network_name String Nama jaringan Virtual Private Cloud (VPC) tempat gateway dibuat.
gateway_type String Jenis enum gateway. Untuk Secure Web Proxy, nilainya harus SECURE_WEB_GATEWAY.
gateway_name String Nama resource gateway.

Format log transaksi proxy

Log transaksi proxy ditulis ke Cloud Logging dengan nama log sebagai projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests.

Payload JSON dari setiap entri log berisi informasi mendetail tentang transaksi. Entri log berisi kolom kunci berikut:

Nama Jenis Deskripsi
destination_ip String Alamat IP tujuan yang di-resolve.
instance String Nama instance Secure Web Proxy yang memproses permintaan.
mtls_info Objek Informasi tentang handshake mTLS, jika ada.
policy_evaluation_results Objek Informasi tentang aturan mana yang cocok dan tindakan yang dihasilkan, seperti allow atau deny.
request_host String Nama host yang diminta.
request_method String Metode HTTP, seperti GET atau POST.
request_path String Jalur permintaan.
request_port Bilangan bulat Port tujuan.
request_protocol String Versi protokol HTTP.
request_scheme String Skema permintaan URL, seperti http atau https.
request_time Stempel waktu Tanggal dan waktu saat proxy menerima permintaan. Stempel waktu ditentukan dalam format ISO 8601: YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. Misalnya, 2025-06-03T11:52:26.452Z.
response_code Bilangan bulat Kode status HTTP yang ditampilkan ke klien.
response_size Bilangan bulat Ukuran isi respons, diukur dalam byte.
response_time Stempel waktu Tanggal dan waktu saat proxy mengirim respons ke klien. Stempel waktu ditentukan dalam format ISO 8601: YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. Misalnya, 2025-06-03T11:52:26.452Z.
source_ip String Alamat IP klien.
source_port Bilangan bulat Port sumber klien.
tls_cipher_suite String Cipher suite yang digunakan untuk koneksi TLS.
tls_version String Versi TLS yang digunakan untuk koneksi.

Memantau log transaksi proxy

  1. Di konsol Google Cloud , buka halaman Logs Explorer.

    Buka Logs Explorer

  2. Pilih project Google Cloud Anda.

  3. Gunakan kueri berikut untuk melihat semua log transaksi Secure Web Proxy:

    logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"

    Ganti PROJECT_ID dengan ID projectGoogle Cloud target Anda.

    Berikut beberapa contoh kueri yang dapat Anda gunakan untuk melihat detail tertentu:

    • Menemukan semua permintaan yang ditolak.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
jsonPayload.policy_evaluation_results.policy_action="DENY"

    • Menemukan permintaan dari alamat IP sumber tertentu.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
jsonPayload.source_ip="192.0.2.1"

    • Menemukan permintaan ke host tertentu.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
jsonPayload.request_host="example.com"

Menghubungkan log transaksi proxy dengan Cloud Trace

Jika pelacakan terdistribusi diaktifkan di gateway Secure Web Proxy, Anda dapat menghubungkan entri log transaksi proxy dengan span rekaman aktivitas di Trace dengan mengikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Logs Explorer.

    Buka Logs Explorer

  2. Luaskan entri log gateway_requests apa pun.

  3. Temukan kolom trace level teratas: 

      projects/PROJECT_ID/traces/TRACE_ID

    Ganti kode berikut:

    • PROJECT_ID: ID project Google Cloud Anda
    • TRACE_ID: ID trace 128-bit (heksadesimal 32 karakter) dari klien atau span trace Anda. Contoh, 4bf92f3577b34da6a3ce929d0e0e4736.

  4. Klik URL trace, lalu pilih View trace details untuk langsung membuka waterfall trace di Cloud Trace.

  5. Untuk memfilter log ID trace yang diketahui dari klien yang diinstrumentasi OpenTelemetry, jalankan kueri berikut di Logs Explorer:

    logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
trace="projects/PROJECT_ID/traces/TRACE_ID"

Untuk mengetahui informasi selengkapnya, lihat Ringkasan pelacakan terdistribusi dan Melacak traffic keluar dengan Cloud Trace.

Entri log transaksi Agent Gateway

Saat Anda men-deploy Secure Web Proxy sebagai Gateway Agen, log transaksi dicatat dalam resource yang dipantau networkservices.googleapis.com/Gateway standar.

Selain metadata permintaan HTTP standar, kolom jsonPayload menyertakan kolom khusus berikut untuk traffic agentic:

  • agentGatewayInfo: detail tentang transaksi agen:

    • agentRegistryResource: nama resource lengkap target Agent Registry yang cocok, seperti server atau kemampuan Model Context Protocol (MCP)
    • destinationUrn: informasi tentang URN tujuan, seperti alamat server MCP
    • mcpInfo: Detail panggilan JSON-RPC MCP, termasuk metode (seperti, tools/call atau resources/read) dan nama alat atau URI resource (parameter)

  • authzPolicyInfo: hasil evaluasi dari kebijakan otorisasi yang diterapkan ke transaksi, termasuk result (ALLOWED atau DENIED) dan nama kebijakan kecocokan

  • tls: Detail TLS dan atribut verifikasi sertifikat klien kriptografis (mTLS), seperti clientCertPresent dan clientCertSha256Fingerprint

Memfilter log transaksi Agent Gateway

Untuk melihat permintaan yang diproses Secure Web Proxy untuk Gateway Agen di Logs Explorer, gunakan kueri yang mirip dengan berikut ini:

resource.type="networkservices.googleapis.com/Gateway"
resource.labels.gateway_name="SECURE_WEB_PROXY_NAME"
jsonPayload.agentGatewayInfo:*

Ganti SECURE_WEB_PROXY_NAME dengan nama gateway Secure Web Proxy Anda.

Untuk memfilter permintaan yang ditolak oleh kebijakan otorisasi Anda, gunakan kueri berikut:

resource.type="networkservices.googleapis.com/Gateway"
resource.labels.gateway_name="SECURE_WEB_PROXY_NAME"
jsonPayload.authzPolicyInfo.result="DENIED"

Merutekan log transaksi proxy

Anda dapat merutekan log transaksi proxy ke tujuan lain seperti Cloud Storage, BigQuery, atau Pub/Sub menggunakan sink log. Untuk mengetahui informasi selengkapnya, lihat Entri log rute.

Apa langkah selanjutnya?