프록시 트랜잭션 로그 보기

프록시 트랜잭션 로그는 Secure Web Proxy가 처리하는 각 요청에 대한 자세한 정보를 제공합니다. 이러한 로그에는 Secure Web Proxy가 사용자와 인터넷 간에 중재하는 모든 트랜잭션의 레코드가 포함됩니다. 이 문서에서는 Secure Web Proxy 인스턴스에서 생성하는 트랜잭션 로그에 액세스하고 해석하는 방법을 설명합니다.

프록시 트랜잭션 로그 항목 유형

프록시 트랜잭션 로그 항목에는 세 가지 유형이 있습니다.

이러한 로그는 다음 작업에 유용합니다.

  • 보안 분석 및 위협 감지
  • 연결 및 정책 문제 해결
  • 웹 액세스 감사
  • Secure Web Proxy 성능 분석

HttpRequest

이러한 로그 항목에는 다음 정보가 포함됩니다.

이름 유형 설명
requestMethod 문자열 요청 메서드 유형입니다(예: GET, HEAD, PUT, POST).
requestUrl 문자열 요청된 URL의 스키마(http 또는 https), 호스트 이름, 경로, 쿼리 부분입니다. 예를 들면 http://example.com/some/info?color=red와 같습니다.
requestSize

문자열(int64 형식)

요청 헤더 및 요청 본문을 포함하는 HTTP 요청 메시지의 크기(바이트)입니다.
status 정수 응답을 나타내는 HTTP 또는 HTTPS 상태 코드입니다. 예를 들면 200 OK 또는 404 Not Found입니다.
responseSize 문자열(int64 형식) 헤더와 본문을 포함하여 클라이언트로 다시 전송되는 HTTP 상태 코드의 크기(바이트)입니다.
userAgent 문자열 클라이언트가 전송하는 사용자 에이전트입니다(예: Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)).
remoteIp 문자열 HTTP 요청을 실행한 클라이언트의 IP 주소(IPv4 또는 IPv6)입니다. 이 필드에는 포트 정보가 포함될 수 있습니다. 예를 들면 192.168.1.1, 10.0.0.1:80, FE80::0202:B3FF:FE1E:8329입니다.
serverIp 문자열 요청을 전송한 원본 서버의 IP 주소(IPv4 또는 IPv6)입니다. 이 필드에는 포트 정보가 포함될 수 있습니다. 예를 들면 192.168.1.1, 10.0.0.1:80, FE80::0202:B3FF:FE1E:8329입니다.
referrer 문자열 HTTP/1.1 헤더 필드 정의에 정의된 요청의 리퍼러 URL입니다.
latency 문자열(기간 형식) 요청이 수신된 시점부터 응답이 전송될 때까지 서버의 요청 처리 지연 시간입니다.

지연 시간은 초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 s로 끝납니다(예: 3.5s).

cacheLookup 불리언 캐시 조회가 시도되었는지 여부를 나타냅니다.
cacheHit 불리언 캐시에서 항목이 제공되었는지 여부를 나타냅니다(검증 유무에 관계없음).
cacheValidatedWithOriginServer 불리언 캐시에서 제공되기 전에 원본 서버로 응답이 검증되었는지 여부를 나타냅니다. 이 필드는 cacheHit가 True인 경우에만 의미가 있습니다.
cacheFillBytes 문자열(int64 형식) 삽입된 HTTP 상태 코드 바이트 수입니다.
protocol 문자열 요청에 사용된 프로토콜입니다(예: HTTP/1.1, HTTP/2, websocket).

LoadBalancerLogEntry

이러한 로그 항목에는 다음 정보가 포함됩니다.

이름 유형 설명
insertId 문자열 고유한 로그 ID입니다.
jsonPayload.@type 문자열 로그 유형입니다. 로그 유형 값은 항상 type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry입니다.
jsonPayload.enforcedGatewaySecurityPolicy.hostname 문자열 요청과 연결된 호스트 이름입니다.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action 문자열 요청에 대해 취해진 조치입니다.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.rule 문자열 요청에 적용된 규칙의 이름입니다.
jsonPayload.enforcedGatewaySecurityPolicy.clientServiceAccount 문자열 요청과 연결된 서비스 계정입니다.
jsonPayload.enforcedGatewaySecurityPolicy.clientSecureTags 문자열 요청과 연결된 보안 태그입니다.

GatewayLogEntry

이러한 로그 항목에는 다음 정보가 포함됩니다.

이름 유형 설명
resource_container 문자열 게이트웨이와 연결된 컨테이너입니다.
location 문자열 게이트웨이가 정의된 리전의 이름입니다.
network_name 문자열 게이트웨이가 생성된 Virtual Private Cloud(VPC) 네트워크의 이름입니다.
gateway_type 문자열 게이트웨이의 enum 유형입니다. Secure Web Proxy의 경우 값은 SECURE_WEB_GATEWAY여야 합니다.
gateway_name 문자열 게이트웨이 리소스의 이름입니다.

프록시 트랜잭션 로그 형식

프록시 트랜잭션 로그는 로그 이름이 projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests인 Cloud Logging에 기록됩니다.

각 로그 항목의 JSON 페이로드에는 트랜잭션에 대한 자세한 정보가 포함됩니다. 로그 항목에는 다음 키 필드가 포함됩니다.

이름 유형 설명
destination_ip 문자열 목적지의 확인된 IP 주소입니다.
instance 문자열 요청을 처리한 Secure Web Proxy 인스턴스의 이름입니다.
mtls_info 객체 mTLS 핸드셰이크에 관한 정보입니다(해당하는 경우).
policy_evaluation_results 객체 일치하는 규칙 및 결과 작업에 대한 정보(예: allow 또는 deny)
request_host 문자열 요청된 호스트 이름입니다.
request_method 문자열 HTTP 메서드(예: GET 또는 POST)
request_path 문자열 요청 경로입니다.
request_port 정수 대상 포트.
request_protocol 문자열 HTTP 프로토콜 버전입니다.
request_scheme 문자열 URL 요청의 스키마입니다(예: http 또는 https).
request_time 타임스탬프 프록시가 요청을 수신한 날짜 및 시간입니다. 타임스탬프는 ISO 8601 형식(YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset)으로 지정됩니다. 예를 들면 2025-06-03T11:52:26.452Z입니다.
response_code 정수 클라이언트에 반환되는 HTTP 상태 코드입니다.
response_size 정수 응답 본문의 크기(바이트)입니다.
response_time 타임스탬프 프록시가 클라이언트에 응답을 보낸 날짜 및 시간입니다. 타임스탬프는 ISO 8601 형식으로 지정됩니다(YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset). 예를 들면 2025-06-03T11:52:26.452Z입니다.
source_ip 문자열 클라이언트 IP 주소입니다.
source_port 정수 클라이언트 소스 포트입니다.
tls_cipher_suite 문자열 TLS 연결에 사용되는 암호화 스위트입니다.
tls_version 문자열 연결에 사용되는 TLS 버전입니다.

프록시 트랜잭션 로그 모니터링

  1. Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

    로그 탐색기로 이동

  2. Google Cloud 프로젝트를 선택합니다.

  3. 다음 쿼리를 사용하여 모든 Secure Web Proxy 트랜잭션 로그를 확인합니다.

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

    PROJECT_ID를 대상Google Cloud 프로젝트의 ID로 바꿉니다.

    다음은 특정 세부정보를 보는 데 사용할 수 있는 몇 가지 샘플 쿼리입니다.

    • 거부된 모든 요청을 찾습니다.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
      jsonPayload.policy_evaluation_results.policy_action="DENY"
      
    • 특정 소스 IP 주소의 요청을 찾습니다.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
      jsonPayload.source_ip="192.0.2.1"
      
    • 특정 호스트에 대한 요청을 찾습니다.

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

Cloud Trace와 프록시 트랜잭션 로그의 상관관계 분석

Secure Web Proxy 게이트웨이에서 분산 추적이 사용 설정된 경우 다음 단계에 따라 프록시 트랜잭션 로그 항목을 Trace의 trace 스팬과 상호 연결할 수 있습니다.

  1. Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

    로그 탐색기로 이동

  2. gateway_requests 로그 항목을 펼칩니다.

  3. 최상위 trace 필드를 찾습니다.

      projects/PROJECT_ID/traces/TRACE_ID
      

    다음을 바꿉니다.

    • PROJECT_ID: Google Cloud 프로젝트 ID
    • TRACE_ID: 클라이언트 또는 trace 스팬의 128비트(32자 16진수) trace ID입니다. 예를 들면 4bf92f3577b34da6a3ce929d0e0e4736입니다.
  4. trace URL을 클릭한 후 trace 세부정보 보기를 선택하여 Cloud Trace의 trace 폭포식 구조로 직접 이동합니다.

  5. OpenTelemetry 계측 클라이언트에서 알려진 trace ID의 로그를 필터링하려면 로그 탐색기에서 다음 쿼리를 실행합니다.

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

자세한 내용은 분산 추적 개요 및 Cloud Trace로 아웃바운드 트래픽 추적을 참조하세요.

Agent Gateway 트랜잭션 로그 항목

Secure Web Proxy를 Agent Gateway로 배포하면 트랜잭션 로그가 표준 networkservices.googleapis.com/Gateway 모니터링 리소스에 기록됩니다.

jsonPayload 필드에는 표준 HTTP 요청 메타데이터 외에도 에이전트 트래픽에 대한 다음과 같은 특수 필드가 포함됩니다.

  • agentGatewayInfo: 에이전트 트랜잭션에 대한 세부정보입니다.

    • agentRegistryResource: 일치하는 에이전트 레지스트리 타겟의 전체 리소스 이름(예: 모델 콘텐츠 플랫폼(MCP) 서버 또는 스킬)
    • destinationUrn: 대상 URN에 대한 정보(예: MCP 서버 주소)
    • mcpInfo: 메서드(예: tools/call 또는 resources/read) 및 도구 이름 또는 리소스 URI(parameter)를 포함한 MCP JSON-RPC 호출 세부정보
  • result(ALLOWED 또는 DENIED) 및 일치하는 정책 이름을 포함하여 트랜잭션에 적용되는 승인 정책의 평가 결과authzPolicyInfo

  • tls: TLS 세부정보 및 암호화 클라이언트 인증서(mTLS) 확인 속성(예: clientCertPresent 및 clientCertSha256Fingerprint)

Agent Gateway 트랜잭션 로그 필터링

로그 탐색기에서 Secure Web Proxy가 Agent Gateway에 대해 처리하는 요청을 보려면 다음과 유사한 쿼리를 사용합니다.

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

SECURE_WEB_PROXY_NAME를 Secure Web Proxy 게이트웨이 이름으로 바꿉니다.

승인 정책에서 거부한 요청을 필터링하려면 다음 쿼리를 사용합니다.

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

프록시 트랜잭션 로그 라우팅

로그 싱크를 사용하여 프록시 트랜잭션 로그를 Cloud Storage, BigQuery 또는 Pub/Sub와 같은 다른 대상으로 라우팅할 수 있습니다. 자세한 내용은 로그 항목 라우팅을 참조하세요.

다음 단계