Google Cloud Logging 가이드: 로그 조회, 라우팅, 비용 관리

Logs Explorer에서 GKE 오류를 찾고 로그 싱크 권한을 설정합니다. 로그 저장, 보존, 내보내기 비용도 구분합니다.

모범 사례
로그 이벤트 수집과 데이터 분석을 보여 주는 그림

결제 요청이 실패해 GKE Pod의 stdout을 확인하니 로그는 계속 쌓입니다. 그런데 Logs Explorer에서 해당 주문이 나오지 않습니다. 우선 같은 워크로드의 최신 로그 한 건을 열어 보세요. 쿠버네티스 네임스페이스는 resource.labels.namespace_name에, 애플리케이션이 기록한 order_id는 jsonPayload에 있습니다. 경로 하나만 틀려도 수집이 끊긴 것처럼 보일 수 있습니다.

Cloud Logging에 들어오는 로그는 서비스별 수집 설정에 따라 달라집니다. 이 글에서는 합성 GKE 로그 한 건을 조회하고 내보내는 과정을 따라가며 저장, 보존, 목적지 서비스의 비용을 구분합니다.

저장된 로그에서 필드 위치 확인하기

다음은 수집 이후의 합성 LogEntry입니다. 모니터링 대상 리소스, 숫자형 주문 ID, 트레이스 참조가 들어 있습니다.

{
  "logName": "projects/example-prod/logs/stdout",
  "timestamp": "2026-11-10T14:55:22.123Z",
  "severity": "ERROR",
  "resource": {
    "type": "k8s_container",
    "labels": {
      "project_id": "example-prod",
      "location": "asia-southeast1",
      "cluster_name": "payments",
      "namespace_name": "prod",
      "pod_name": "checkout-7f8c",
      "container_name": "checkout"
    }
  },
  "jsonPayload": {"message": "payment failed", "order_id": 1024},
  "trace": "projects/example-prod/traces/4bf92f3577b34da6a3ce929d0e0e4736"
}

timestamp, resource, severity는 최상위 필드입니다. 페이로드는 JSON, 일반 텍스트, protobuf일 수 있습니다. GKE와 Cloud Run의 관리형 수집기는 stdout에 기록된 한 줄짜리 JSON을 구조화할 수 있습니다. severity나 logging.googleapis.com/trace처럼 수집기가 인식하는 키는 LogEntry의 최상위 필드로 옮겨질 수 있으므로 쿼리를 쓰기 전에 실제 저장 형태를 확인합니다. 구조화된 로깅 · 모니터링 리소스 유형

GKE에서 워크로드 로깅을 켜면 관리형 Agent가 컨테이너의 stdout과 stderr를 수집합니다. Standard 클러스터는 수집 구성 요소를 바꿀 수 있습니다. 워크로드 로그를 수집하려면 시스템 로그도 켜야 하며 Autopilot에서는 클러스터 로깅을 끌 수 없습니다. Compute Engine VM에 있는 애플리케이션 파일 로그를 수집할 때는 Ops Agent가 설치됐는지, 해당 파일 경로를 읽는 수신기가 설정됐는지 확인합니다. GKE 로그 · Ops Agent

Logs Explorer에서 GKE 오류 찾기

로그가 들어 있는 프로젝트 또는 로그 뷰를 선택하고, 시간 범위에 장애 시점을 포함합니다. 아래 필터를 붙여 넣습니다. 각 줄은 암시적으로 AND로 결합됩니다. 네임스페이스와 주문 번호는 실제 값으로 바꾸세요.

resource.type="k8s_container"
resource.labels.namespace_name="prod"
severity>=ERROR
jsonPayload.order_id=1024

같은 필터를 Google Cloud CLI에서도 쓸 수 있습니다. 아래 읽기 전용 명령은 최근 24시간에서 최대 20건을 조회합니다. Google Cloud CLI를 구성하고 대상 로그를 읽을 권한을 확보한 뒤 프로젝트 ID를 실제 값으로 바꿉니다.

gcloud logging read '
resource.type="k8s_container"
resource.labels.namespace_name="prod"
severity>=ERROR
jsonPayload.order_id=1024
' --project=example-prod --freshness=24h --limit=20 --format=json

결과가 비어 있으면 resource.type만 남겨 검색한 뒤 다른 조건을 하나씩 추가합니다. 특정 Pod는 resource.labels.pod_name으로 좁히고, 같은 트레이스의 로그는 실제 저장된 trace 값으로 찾습니다. 히스토그램은 시간 범위 안에 필터와 일치하는 로그가 어떻게 분포하는지 보여 줍니다. 재시도 때문에 주문 하나가 여러 오류 로그를 남길 수 있으므로 로그 건수와 실패 주문 수는 구분합니다. 로깅 쿼리 언어 · gcloud logging read

새 로그를 어느 목적지로 보낼지 정하기

싱크는 새로 들어온 로그가 포함 필터와 제외 필터에 맞는지 판단합니다. 싱크를 만들기 전에 들어온 로그를 자동으로 다시 보내지 않습니다. 일반적인 프로젝트에서는 싱크마다 판단하므로 Pub/Sub에 보낸 로그가 _Default 싱크를 통해 저장될 수도 있습니다. 싱크와 권한을 설정한 뒤 필터와 일치하는 새 로그로 동작을 확인합니다.

목적지 로그가 전달되는 방식
BigQuery 데이터 세트 새 로그를 SQL 조인이나 보고서에 씁니다. 데이터 세트 저장과 쿼리 비용을 고려합니다.
Cloud Storage 버킷 JSON 파일을 일괄 작성합니다. 라우팅은 시간 단위로 처리되며 새 싱크는 전달을 시작하기까지 몇 시간이 걸릴 수 있습니다. 스토리지 클래스를 고를 때 읽기 비용과 최소 저장 기간을 확인합니다.
Pub/Sub 주제 구독자에게 거의 실시간으로 전달합니다. JSON 메시지의 message.data에는 Base64로 인코딩한 LogEntry가 들어 있습니다.

싱크를 만드는 계정과 실제로 로그를 쓰는 writerIdentity는 역할이 다릅니다. 쓰기 ID가 표시되면 공식 절차에 따라 라우팅에 필요한 권한과 목적지 쓰기 권한을 부여합니다. Pub/Sub는 대상 주제에 게시자 역할이 필요합니다. 구독에서 메시지를 읽는 프로그램에는 별도의 권한을 부여합니다. 로그 싱크 설정 · Pub/Sub 로그 메시지

구독자가 Guance로 전달한다면 실제 메시지 한 건을 디코딩한 뒤 Pipeline 규칙을 작성합니다. 이벤트 발생 시각을 보존하고, severity를 지원되는 status 값으로 변환하고, 숫자 필드의 타입을 유지합니다. 트레이스가 전체 리소스 이름으로 들어온 경우 ID를 추출한 뒤 Guance에 수집된 트레이스의 표기와 대조합니다. 구독 인증, 재시도, 중복 처리는 전달 경로에서 맡습니다. Guance 로그 Pipeline · 로그와 트레이스 연결

알림에 쓸 메트릭의 집계 범위 정하기

ERROR와 일치하는 로그를 카운터 메트릭으로 집계해 Cloud Monitoring에서 알림을 설정할 수 있습니다. 라벨은 서비스나 오류 유형처럼 값의 종류가 제한된 것을 고릅니다. 주문 ID를 라벨로 추가하면 시계열이 늘어나고 메트릭 비용에 영향을 줄 수 있습니다.

결제가 활성화된 프로젝트에서 사용자 정의 로그 기반 메트릭을 만들면 생성 이후의 로그를 집계합니다. 프로젝트 범위 메트릭은 프로젝트가 받은 로그 중 싱크에서 저장을 제외한 항목도 셀 수 있습니다. 버킷 범위 메트릭은 해당 버킷에 저장되는 로그를 집계하며, 시스템 정의 메트릭도 Google 라우팅 규칙에 따라 저장된 로그를 집계합니다. 메트릭 범위와 당직자가 볼 수 있는 로그 뷰를 맞춥니다. 결제 실패율이 필요하다면 분모는 집계 대상 결제 요청 수입니다. 오류 로그 건수만으로는 그 비율을 구할 수 없습니다. 로그 기반 메트릭 · 버킷 범위 메트릭

저장, 보존, 목적지 비용을 나눠 계산하기

일부 로그를 _Default 버킷에 둘 필요가 없다면 _Default 싱크에 좁은 범위의 제외 필터를 적용합니다. 다른 싱크나 알림이 그 로그를 사용하는지 먼저 확인합니다. API가 로그를 받은 다음에 제외하므로 쓰기 요청 수와 할당량 사용량은 줄지 않습니다.

프로젝트의 _Default와 사용자 정의 로그 버킷은 기본 30일 보존이며 1~3,650일로 설정할 수 있습니다. 폴더와 조직의 _Default는 30일 고정입니다. _Required는 일부 감사 로그를 400일 보존하며 Cloud Logging의 저장 및 보존 요금이 없습니다. 일반 로그 저장과 30일을 넘는 보존은 별도 과금 항목입니다. Log Router 자체의 추가 라우팅 비용은 없으며 BigQuery, Cloud Storage, Pub/Sub에는 각 서비스의 사용량 요금이 적용됩니다. 비용을 추정할 때 최신 요금표와 네트워크 텔레메트리 로그에 대한 예외를 확인합니다. 보존 기간과 한도 · Google Cloud Observability 가격

개별 요청이나 리소스를 조사할 때는 Logs Explorer가 편리합니다. 지원되는 로그 버킷에 저장된 데이터를 SQL로 살펴보려면 Observability Analytics를 사용합니다. 거래 테이블과 정기적으로 조인해야 한다면 BigQuery 싱크로 새 로그를 보고용 데이터 세트에 쓸 수 있습니다. 원본 로그 버킷과 내보낸 데이터 세트의 보존 설정은 따로 관리합니다. 저장된 로그를 SQL로 분석하기

관련 글

맞춤형 플랜 상담

문의하기

커뮤니티 가입

WeChat으로 스캔하여
커뮤니티에 가입하세요

Guance 사용해 보기

온라인에서 바로 시작하고 사용한 만큼만 결제하세요.

시작하기

Guance 요금제 선택

코드 저장소