로그 기반 측정항목 개요

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

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

로그 기반 측정항목에는 두 가지 유형이 있습니다.

  • 시스템 정의 로그 기반 측정항목 - Cloud Logging에서 제공하며 모든 Google Cloud 프로젝트에서 사용할 수 있습니다.
  • 사용자 정의 로그 기반 측정항목 - Google Cloud 프로젝트에서 특히 관심이 있는 항목을 추적하기 위해 사용자가 만듭니다. 예를 들어 로그 기반 측정항목을 만들어 특정 필터와 일치하는 로그 항목의 개수를 셀 수 있습니다.

로그 기반 측정항목은 단일 Google Cloud 프로젝트에만 적용되며, 로그 버킷 또는 다른 Google Cloud 리소스(Cloud Billing 계정 또는 조직)에는 만들 수 없습니다.

시작하기

Cloud 프로젝트에서 로그 기반 측정항목을 사용할 수 있는 올바른 권한이 있는지 확인하려면 이 페이지의 액세스 제어를 참조하세요.

Cloud Monitoring을 처음 사용하는 경우 이 페이지의 Cloud Monitoring 섹션을 참조하세요.

로그 기반 측정항목 보기

Google Cloud Console의 로그 기반 측정항목 페이지에서 로그 기반 측정항목을 만들 수 있으며 이 페이지에 Cloud 프로젝트의 모든 로그 기반 측정항목 목록이 포함되어 있습니다.

Google Cloud 프로젝트의 로그 기반 측정항목 목록을 보려면 다음을 수행합니다.

  1. Cloud Console에서 로그 기반 측정항목 페이지로 이동합니다.

    로그 기반 측정항목으로 이동

  2. 기존 Cloud 프로젝트를 선택합니다. Cloud 프로젝트의 로그 기반 측정항목 목록이 나타납니다.

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

각 창에는 측정항목의 테이블 요약이 포함됩니다. 각 측정항목의 행에는 다음 옵션을 제공하는 메뉴 가 있습니다.

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

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

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

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

사용자 정의 측정항목 창

로그 기반 측정항목 인터페이스의 사용자 정의 측정항목 창에는 Cloud 프로젝트에서 사용자 정의 측정항목을 관리하는 데 도움이 되는 몇 가지 기능이 있습니다.

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

  • 필터 사용자 정의 측정항목 상자에서는 텍스트 검색 또는 측정항목 이름, 설명, 필터를 기준으로 측정항목 목록을 필터링할 수 있습니다.

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

열 이름을 클릭하여 데이터를 오름차순 또는 내림차순으로 정렬할 수 있습니다. 표 하단에서 표시하려는 행 개수를 선택할 수도 있습니다.

사용자 정의 측정항목 창의 각 측정항목에 대한 메뉴 에는 측정항목 관리를 위한 추가 기능이 포함되어 있습니다.

사용자 정의 로그 기반 측정항목 창 더보기 메뉴 옵션

  • 측정항목 세부정보 보기: 측정항목의 이름, 유형, 설명, 필터, 단위, 라벨(정의된 경우)을 표시합니다.
  • 측정항목 수정: 측정항목의 특정 필드를 수정할 수 있습니다.
  • 측정항목 사용 중지: 측정항목 계산을 중지할 수 있습니다. 동일한 메뉴에서 사용 중지된 측정항목을 다시 사용 설정할 수 있습니다.
  • 측정항목 삭제: 측정항목을 삭제할 수 있습니다.
  • 측정항목 로그 보기: 로그 탐색기로 이동하여 쿼리 빌더에서 측정항목의 필터를 채우고 쿼리를 실행합니다.

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

시스템 로그 기반 측정항목은 포함된 로그에서만 계산됩니다. 사용자 정의 로그 기반 측정항목은 포함 및 제외되는 로그 모두에서 계산됩니다.

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

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

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

사용자 정의 로그 기반 측정항목은 카운터 또는 분포 측정항목 유형일 수 있습니다. 대부분의 시스템 정의 로그 기반 측정항목은 카운터 유형이지만 부울 유형도 일부 존재합니다.

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

카운터 측정항목

카운터 측정항목은 특정 필터와 일치하는 로그 항목의 개수를 셉니다. 예를 들어 다음을 수행할 수 있습니다.

  • 특정 오류 메시지를 포함하는 로그 항목의 개수를 셉니다.
  • 이 패턴과 일치하는 로그 메시지를 찾아 각 사용자가 작업을 호출하는 횟수를 계산합니다.

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

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

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

분산 측정항목

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

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

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

시계열 내의 형식 및 시각화 방법을 포함한 분포에 대한 자세한 내용은 분포 측정항목 차트 작성을 참조하세요.

분포 로그 기반 측정항목 만들기에 대한 자세한 내용은 분포 측정항목 만들기를 참조하세요.

라벨

로그 기반 측정항목에는 측정항목에서 여러 시계열을 수집하는 라벨이 있을 수 있습니다. 이 라벨의 값은 일치하는 로그 항목의 필드에서 추출됩니다. Logging은 라벨 값의 조합마다 별도의 시계열을 기록합니다.

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

사용자 정의 로그 기반 측정항목

사용자 정의 로그 기반 측정항목은 Google Cloud 프로젝트의 사용자가 만듭니다. 이 측정항목은 지정된 필터와 일치하는 로그 항목 수를 세거나 일치하는 로그 항목에 있는 특정 값을 기록합니다.

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

시스템 로그 기반 측정항목

Logging은 카운터가 포함된 측정항목 집합을 제공합니다. 카운터 측정항목은 특정 기간 동안 발생한 로깅 이벤트 수를 기록합니다. 이 측정항목에는 로그 이름과 심각도 수준별로 개수를 기록하는 라벨이 있습니다.

측정항목 목록은 Google Cloud 측정항목: 로깅을 참조하세요.

Cloud Monitoring

Cloud Monitoring에서 시스템 정의 로그 기반 측정항목과 사용자 정의 로그 기반 측정항목을 모두 사용하여 차트와 알림 정책을 만들 수 있습니다. 자세한 내용은 차트 및 알림 만들기를 참조하세요.

Cloud Monitoring에서 로그 기반 측정항목은 다음과 같은 이름 지정 패턴을 사용합니다.

  • 시스템: logging.googleapis.com/<var>SYSTEM_METRIC_NAME</var>
  • 사용자 정의: logging.googleapis.com/user/<var>...</var>

사용자 정의 측정항목에는 user 문자열이 포함됩니다.

구성

프로젝트에 Cloud Monitoring 작업공간을 구성하려면 다음 안내를 따르세요.
  1. Cloud Console에서 Google Cloud 프로젝트를 선택합니다.
    Cloud Console로 이동
  2. 탐색창에서 Monitoring을 선택합니다.

    Cloud Monitoring을 사용한 적이 없는 경우 Google Cloud Console에서 Monitoring에 처음 액세스하면 작업공간이 자동으로 생성되고 프로젝트가 해당 작업공간과 연결됩니다. 또는 프로젝트가 작업공간과 연결되어 있지 않으면 대화상자가 표시되고 작업공간을 만들거나 프로젝트를 기존 작업공간에 추가할 수 있습니다. 작업공간을 만드는 것이 좋습니다. 선택을 완료한 후 추가를 클릭합니다.

액세스 제어

Cloud 프로젝트 로그 기반 측정항목을 보려면 올바른 역할과 권한이 있는지 확인하세요.

Identity and Access Management 역할 및 권한은 Google Cloud 데이터에 대한 액세스를 제어합니다. 다음은 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).

권한 및 역할에 대한 자세한 내용은 액세스 제어 가이드를 참조하세요.

가격 책정

사용자 정의 로그 기반 측정항목은 Cloud Monitoring 커스텀 측정항목의 클래스로서 요금이 부과됩니다.

가격 책정 정보는 Cloud Logging 가격 책정: 로그 기반 측정항목을 참조하세요.

문제해결

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