로그 기반 측정항목 개요

이 페이지에서는 로그 기반 측정항목의 개념 개요를 제공합니다.

로그 기반 측정항목은 로그 항목 콘텐츠에 기반한 Cloud Monitoring 측정항목입니다. 예를 들어 이 측정항목은 특정 메시지를 포함하는 로그 항목의 개수를 기록하거나 로그 항목에 기록된 지연 시간 정보를 추출할 수 있습니다. Cloud Monitoring 차트와 알림 정책에서 로그 기반 측정항목을 사용할 수 있습니다.

시스템(로그 기반) 측정항목은 Logging에 의해 미리 정의됩니다. 이 측정항목은 특정 기간에 발생하는 로깅 이벤트의 개수를 기록합니다.

사용자 정의(로그 기반) 측정항목은 프로젝트의 사용자에 의해 생성됩니다. 이 측정항목은 지정된 쿼리와 일치하는 로그 항목 수를 세거나 일치하는 로그 항목에 있는 특정 값을 추적합니다. 측정항목에 포함할 로그 항목을 필터링할 때 정규 표현식을 사용할 수 있습니다.

Logging은 일치하는 로그 항목이 수신될 때마다 로그 기반 측정항목에 관한 정보를 축적합니다. Logging은 측정항목의 시계열에 분당 데이터 포인트 1개의 속도로 새로운 데이터 포인트를 기록하여 이 데이터를 Cloud Monitoring에 제공합니다.

로그 기반 측정항목의 데이터는 측정항목이 생성된 후에 수신되는 로그 항목에서 가져옵니다. 이 측정항목은 이미 Logging에 존재하는 로그 항목의 데이터로 채워지지 않습니다.

시작하기

  1. Cloud Console의 Google Cloud의 작업 제품군 Logging > 로그 기반 측정항목페이지로 이동합니다.

    로그 기반 측정항목 페이지로 이동

  2. 페이지 상단에서 기존 Google Cloud 프로젝트를 선택합니다. Google Cloud 프로젝트의 로그 기반 측정항목 목록이 나타납니다.

로그 기반 측정항목 목록을 표시하는 사용자 인터페이스입니다.

액세스 제어

Identity and Access Management 역할 및 권한은 Google Cloud 데이터에 대한 액세스를 제어합니다. 다음은 Google Cloud 프로젝트 구성원이 로그 기반 측정항목에 액세스하는 데 필요한 일반적인 역할 및 권한을 요약한 것입니다.

  • Logging/로그 구성 작성자(roles/logging.configWriter)를 사용하면 로그 기반 측정항목을 나열, 만들기, 가져오기, 업데이트 및 삭제할 수 있습니다.

  • Logging/로그 뷰어(roles/logging.viewer)를 사용하면 기존 측정항목을 볼 수 있습니다. 또한 커스텀 역할에 logging.logMetrics.getlogging.logMetrics.list 권한을 추가할 수도 있습니다.

  • 모니터링 뷰어(roles/monitoring.viewer)를 사용하면 로그 기반 측정항목에 포함된 시계열을 읽을 수 있습니다. 또한 커스텀 역할에 monitoring.timeSeries.list 권한을 추가할 수도 있습니다.

  • Logging 관리자(roles/logging.admin), 편집자(roles/editor), 소유자(roles/owner)는 로그 기반 측정항목을 만들 수 있는 권한이 있는 광범위한 수준의 역할입니다(logging.logMetrics.create).

자세한 내용은 Logging: 액세스 제어를 참조하세요.

로그 기반 측정항목 인터페이스

로그 기반 측정항목 인터페이스는 시스템 측정항목사용자 정의 측정항목의 두 가지 측정항목 유형 영역으로 나뉩니다.

두 영역 모두 측정항목을 표로 요약하여 보여줍니다. 표의 행마다 오른쪽 끝에 메뉴 가 있으며, 여기에는 다음과 같은 옵션이 있습니다.

더보기 메뉴를 보여주는 로그 기반 측정항목 목록입니다.

  • 측정항목 탐색기에서 보기를 사용하면 Cloud Monitoring 측정항목 탐색기를 열어 시스템 로그 기반 측정항목의 데이터를 볼 수 있습니다.

    측정항목 탐색기를 사용하여 알림 정책의 대상 측정항목을 지정할 수 있습니다. 대상 영역 옆의 차트는 대상 측정항목에서 캡처하는 데이터에 대한 시각적 피드백을 제공합니다.

  • 측정항목에서 알림 생성을 사용하면 로그 기반 측정항목에 기초하여 알림 정책을 만들 수 있습니다.

    이 옵션을 선택하면 Cloud Monitoring 콘솔이 열리며 여기서 알림 정책을 만들고 수정하고 관리할 수 있습니다. 자세한 내용은 알림 정책 만들기를 참조하세요.

사용자 정의 측정항목 인터페이스

로그 기반 측정항목 페이지의 사용자 정의 측정항목 영역은 프로젝트에서 사용자 정의 측정항목을 관리하는 데 유용한 몇 가지 추가 기능을 제공합니다.

  • 사용자 정의 측정항목 표에는 이름, 설명, 유형, 필터 열이 있습니다. 이러한 열은 측정항목이 생성될 때 지정됩니다.

  • 필터 측정항목 상자에서는 텍스트 검색 또는 측정항목 이름, 설명, 필터를 통해 측정항목 목록을 필터링할 수 있습니다.

필터링 옵션을 보여주는 로그 기반 측정항목 목록입니다.

  • 사용자 정의 측정항목 표에는 지난달 사용량사용량(이번 달 누적) 열이 있습니다. 예를 들어 가장 많은 데이터를 수집하는 측정항목을 확인하거나 청구 비용을 추산하려는 경우 이러한 사용량 측정항목이 유용합니다.

  • 테이블의 행 끝에 있는 메뉴 를 사용하여 측정항목 수정측정항목 삭제를 수행할 수 있습니다.

또한 열 이름을 클릭하면 오름차순 또는 내림차순으로 데이터를 정렬할 수 있고, 테이블 맨 아래에서 표시하려는 행 개수를 선택할 수도 있습니다.

Cloud Console을 사용하여 사용자 정의 측정항목을 관리하는 방법에 대한 자세한 내용은 카운터 측정항목 만들기분산 측정항목 만들기를 참조하세요.

로그 기반 측정항목 유형 개요

Logging 로그 기반 측정항목은 두 가지 측정항목 유형, 즉 카운터 측정항목과 분포 측정항목 유형 중 하나입니다. 모든 시스템 로그 기반 측정항목은 카운터 유형입니다. 사용자 정의 로그 기반 측정항목은 카운터 유형일 수도 있고 분포 유형일 수도 있습니다.

로그 기반 측정항목의 시계열에 있는 각 데이터 포인트는 이전 데이터 포인트 이후로 수신된 추가 정보(델타)만 나타냅니다.

다음 섹션에서는 카운터 유형 및 분포 유형 측정항목의 특징을 설명합니다.

카운터 측정항목

카운터 측정항목고급 로그 쿼리와 일치하는 로그 항목 개수를 셉니다. 예를 들어 다음을 수행할 수 있습니다.

  • 특정 오류 메시지를 포함하는 로그 항목을 계수하는 측정항목을 만듭니다.
  • 다음과 같은 로그 메시지를 찾아 각 사용자가 작업을 호출하는 횟수를 계산합니다.

    ... user [USERNAME] called  [OPERATION] ...
    

    [USERNAME] 및 [OPERATION]을 추출하고 2개 라벨 값에 사용하여 나중에 'sallyUPDATE 작업을 몇 번 호출했나요?', '몇 명이 READ 작업을 호출했나요?', 'george가 작업을 몇 번 호출했나요?' 등과 같이 질문할 수 있습니다.

자세한 내용은 카운터 측정항목 만들기를 참조하세요.

분산 측정항목

분산 측정항목은 특정 쿼리와 일치하는 로그 항목의 숫자 데이터를 누적합니다. 이 측정항목은 분산 객체의 시계열을 포함하며, 각각 다음을 포함합니다.

  • 분산에 있는 값의 수.
  • 여러 값의 평균
  • 편차 제곱 합계: 합계i=1..n(xi–평균)2
  • 각 버킷 값의 수가 기록된 히스토그램 버킷 집합. 기본 버킷 레이아웃을 사용하거나 직접 선택할 수 있습니다.

분산 측정항목의 일반적인 용도는 지연 시간을 추적하는 것입니다. 각 로그 항목이 수신될 때 로그 항목의 특정 위치에서 지연 시간 값이 추출되어 분산에 추가됩니다. 누적된 분산이 일정한 간격으로 Cloud Monitoring에 기록됩니다.

자세한 내용은 분산 측정항목 만들기를 참조하세요.

라벨

필요에 따라 한 측정항목이 여러 시계열을 보유하게 해주는 라벨을 로그 기반 측정항목에 지정할 수 있습니다. 이 라벨의 값은 일치하는 로그 항목의 필드에서 추출됩니다. Logging은 라벨의 각 값마다 별도의 시계열을 기록합니다.

시스템 로그 기반 측정항목에는 라벨이 미리 정의되어 있습니다. 사용자 정의 측정항목에 사용자의 고유한 라벨을 정의할 수 있습니다. 자세한 내용은 로그 기반 측정항목 라벨을 참조하세요.

시스템 로그 기반 측정항목

Logging은 수신되는 로그 항목의 수와 양을 추적하는 사전 정의된 카운터 측정항목 몇 가지를 제공합니다. 이 측정항목에는 로그 이름과 심각도 수준별로 개수를 기록하는 라벨이 있습니다. 아래는 측정항목을 나열한 표입니다.

측정항목의 이름과 설명 유형 라벨
logging.googleapis.com/log_entry_count

수신된 로그 항목의 총 개수입니다.

delta int64 log: 로그의 이름입니다. 예: "appengine.googleapis.com/request_log"

severity: 로그 항목의 심각도입니다. 예: "ERROR"

logging.googleapis.com/byte_count

로그 항목에서 수신한 총 크기(바이트)입니다.

delta int64 log: 로그의 이름입니다. 예: "appengine.googleapis.com/request_log"
logging.googleapis.com/excluded_log_entry_count

제외된 로그 항목의 총 개수입니다.

delta int64
logging.googleapis.com/excluded_byte_count

제외된 로그 항목의 총 바이트 수입니다.

delta int64
logging.googleapis.com/exports/log_entry_count

싱크를 사용하여 내보낸 로그 항목의 총 개수입니다.

delta int64
logging.googleapis.com/exports/byte_count

싱크를 사용하여 내보낸 로그 항목의 총 바이트 수입니다.

delta int64
logging.googleapis.com/exports/error_count

내보내기 오류로 인해 내보내지 않은 로그 항목의 총 개수입니다.

delta int64
logging.googleapis.com/logs_based_metrics_error_count

늦게 도착하는 로그 항목 개수입니다.1

delta int64 log: 로그의 이름입니다. 예: "appengine.googleapis.com/request_log"

1 늦게 도착한 로그 항목은 log_entry_count 또는 byte_count 측정항목에 포함되지 않습니다.

시스템 로그 기반 측정항목의 전체 목록은 Logging 측정항목을 참조하세요.

Cloud Monitoring

Cloud Monitoring에서 시스템 정의 로그 기반 측정항목과 사용자 정의 로그 기반 측정항목을 모두 사용하여 차트와 알림 정책을 만들 수 있습니다. 사용자 정의 로그 기반 측정항목 이름은 앞에 user/가 붙고 시스템 로그 기반 측정항목은 그렇지 않습니다.

Cloud Monitoring API를 사용하는 경우 로그 기반 측정항목 이름은 다음과 같습니다.

logging.googleapis.com/user/[USER_METRIC_NAME]
logging.googleapis.com/[SYSTEM_METRIC_NAME]

자세한 내용은 차트 및 알림 만들기를 참조하세요.

문제해결

로그 기반 측정항목을 사용할 때 문제가 발생하면 문제해결을 참조하세요.