Agent Gateway를 통한 트래픽 모니터링

이 페이지를 사용하여 Agent Gateway 배포를 통해 라우팅된 트래픽의 로그를 확인하고 요청 및 액세스 제어 결정을 모니터링하는 방법을 알아보세요.

로깅

Agent Gateway 로그는 networkservices.googleapis.com/Gateway 모니터링 리소스를 사용하여 생성됩니다.

이러한 로그를 사용하여 게이트웨이에 대한 액세스 요청을 모니터링할 수 있습니다. 여기에는 Agent Gateway가 테스트 실행 모드로 배포될 때 생성된 로그가 포함됩니다.

특정 게이트웨이의 로그 보기

특정 게이트웨이의 로그를 보려면 다음 단계를 완료합니다.

콘솔 쿼리

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

    로그 탐색기로 이동

  2. 쿼리 표시 전환 버튼을 클릭합니다.

  3. 다음을 쿼리 필드에 붙여넣습니다.

    resource.type="networkservices.googleapis.com/Gateway"
resource.labels.location="REGION"
resource.labels.gateway_name="AGENT_GATEWAY_NAME"

    다음을 바꿉니다.

    • REGION: 게이트웨이의 리전입니다.
    • AGENT_GATEWAY_NAME: 게이트웨이의 이름입니다.

  4. 쿼리 실행을 클릭합니다.

로깅되는 내용

에이전트 게이트웨이 로그 항목에는 게이트웨이로 오가는 트래픽을 모니터링하고 디버깅하는 데 유용한 정보가 포함됩니다.

필드 필드 형식 필드 유형: 필수 또는 선택적 설명
severity
insertID
timestamp
receiveTimestamp
trace
traceSampled
logName		 LogEntry 필수 로그 항목에 설명된 일반 필드입니다.
httpRequest HttpRequest 필수 HTTP 요청을 로깅하는 데 사용되는 공통 프로토콜입니다.
리소스 MonitoredResource 필수

MonitoredResource는 로그 항목과 연결된 리소스 유형입니다. Agent Gateway의 리소스 유형은 networkservices.googleapis.com/Gateway입니다.
jsonPayload object(Struct format) 필수

JSON 객체로 표현되는 로그 항목 페이로드입니다. JSON 객체에는 다음 Agent Gateway 필드가 포함되어 있습니다.

  • agentGatewayInfo: 에이전트 게이트웨이 요청에 관한 정보를 포함합니다.

    • mcpInfo: 요청의 MCP 메서드에 관한 정보(예: 'tools/list' 또는 'tools/call')와 메서드와 연결된 기본 매개변수(있는 경우)를 포함합니다. 예를 들어 'tools/call' 메서드의 경우 매개변수는 도구 이름입니다.
    • agentRegistryResource: 요청과 일치하는 MCP 서버, 에이전트 또는 엔드포인트의 에이전트 레지스트리 리소스 이름입니다.

  • 요청을 처리한 승인 확장 프로그램(IAP, Model Armor 등)에 관한 정보를 보려면 serviceEntensionsInfo 필드의 세부정보를 검사할 수도 있습니다.

모니터링

Agent Gateway는 일부 Service Extensions 측정항목을 Cloud Monitoring으로 내보냅니다. Service Extensions에 승인을 위임하는 경우 이러한 측정항목을 사용하여 확장 프로그램으로 오가는 트래픽을 모니터링할 수 있습니다. 자세한 내용은 Cloud Load Balancing 콜아웃 로깅 및 모니터링을 참고하세요.

관측 가능성 대시보드

에이전트 게이트웨이는 게이트웨이를 통해 라우팅되는 트래픽을 모니터링, 감사, 디버그할 수 있는 모니터링 가능성 대시보드를 제공합니다.

  • 스코어카드: 시도된 승인, 승인 실패, 초당 요청의 총수를 추적합니다.
  • 차트: 시간 경과에 따른 승인 실패율 (%) 및 초당 요청 수를 시각화합니다.
  • 이그레스 트래픽 로그: 403 거부, 등록되지 않은 엔드포인트로의 트래픽, 전체 트래픽 추세를 비롯한 이그레스 쿼리의 세부 로그를 검토합니다.

다음 단계에 따라 Google Cloud 콘솔에서 게이트웨이의 관측 가능성 대시보드에 액세스합니다.

  1. Google Cloud 콘솔에서 Agent Gateway 페이지로 이동합니다.

    에이전트 게이트웨이로 이동

  2. 모니터링할 게이트웨이의 이름을 클릭합니다.

  3. 모니터링 가능성 탭을 클릭합니다.

대시보드 데이터 요구사항

에이전트 게이트웨이 관측 가능성 대시보드는 관측 가능성 분석을 사용하여 데이터를 표시합니다. 대시보드에 데이터가 로드되지 않으면 모니터링 가능성 분석을 사용하도록 _Default 로그 버킷을 업그레이드하세요. 대시보드는 _Default 버킷의 _AllLogs 뷰에서 데이터를 가져옵니다.

다음 단계

Codelab

Gemini Enterprise Agent Platform에서 Agent Gateway를 사용하여 에이전트형 워크로드를 관리하는 방법을 알아보세요.

문제 해결

Agent Gateway 연결 문제를 해결하는 방법을 알아보세요.