로그 기반 측정항목 개요

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

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

로그 기반 측정항목의 소스

Cloud Logging에서 정의한 측정항목을 사용하여 일반 사용 정보를 수집하고, 자체 로그 기반 측정항목을 정의하여 애플리케이션 또는 비즈니스와 관련된 정보를 캡처할 수 있습니다.

로그 기반 측정항목은 단일 Google Cloud 프로젝트 내에서만 적용됩니다. Cloud Billing 계정 또는 조직 등의 다른 Google Cloud 리소스에 대한 로그 기반 측정항목은 만들 수 없습니다.

시스템 정의 측정항목

Logging은 프로젝트에서 내부 데이터화된 로그 항목 수 또는 내보낸 바이트 수와 같은 사용량 값의 측정항목 집합을 제공합니다. 시스템 정의 측정항목의 전체 목록은 Google Cloud 측정항목: 로깅을 참조하세요.

Logging은 Logging에서 수집한 로그에서만 시스템 정의 로그 기반 측정항목을 계산합니다. 로그가 명시적으로 Logging에서 수집에서 제외되면 이러한 측정항목에 포함되지 않습니다.

사용자 정의 측정항목

사용자 정의 로그 기반 측정항목을 만들어 프로젝트에 중요한 다른 측정항목을 추적할 수 있습니다. 예를 들어 로그 기반 측정항목을 만들어 특정 필터와 일치하는 로그 항목의 개수를 셀 수 있습니다.

기본적으로 사용자 정의 로그 기반 측정항목은 클라우드 프로젝트에 적용될 수 있는 포함 필터 또는 제외 필터에 관계없이 클라우드 프로젝트의 Logging API에서 수신한 모든 로그에서 계산됩니다.

미리보기: Cloud 프로젝트의 특정 로그 버킷에 대한 사용자 정의 로그 기반 측정항목을 만들 수도 있습니다. 버킷 수준 로그 기반 측정항목은 로그의 출처와 관계없이 버킷을 대상으로 하는 모든 로그에서 계산됩니다. 자세한 내용은 로그 버킷의 로그 기반 측정항목을 참조하세요.

로그 기반 측정항목의 데이터 유형

로그 기반 측정항목은 로그에서 데이터를 추출하여 다음 유형의 측정항목을 만들 수 있습니다.

  • 카운터: 이 측정항목은 특정 기간 내에 지정된 필터와 일치하는 로그 항목 개수를 카운트합니다. 로그에 값 또는 문자열이 나타나는 횟수를 추적하려면 카운터를 사용하세요.
  • 분산: 이 측정항목도 값의 수를 세지만 값 범위(히스토그램 버킷)로 개수를 수집합니다. 지연 시간과 같은 값을 추출하려면 분포를 사용하세요.
  • 부울: 이 측정항목은 로그 항목이 지정된 필터와 일치하는지 여부를 캡처합니다.

사용자 정의 로그 기반 측정항목은 카운터 또는 분포 측정항목 유형일 수 있습니다. 대부분의 시스템 정의 로그 기반 측정항목은 카운터 유형이지만 부울 유형도 일부 존재합니다. 카운터와 분산의 특징에 대해서는 이후 섹션에서 자세히 설명합니다.

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

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

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

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

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

카운터 측정항목

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

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

    ... user USERNAME called OPERATION ...

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

자세한 내용은 카운터 측정항목 구성을 참조하세요.

분산 측정항목

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

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

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

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

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

라벨

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

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

Cloud Monitoring의 차트 및 알림

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

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

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

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

Monitoring 측정항목 범위에 대한 가시성

로그 기반 측정항목은 Cloud Monitoring에서 수집되며, 클라우드 프로젝트의 측정항목 데이터 가시성은 측정항목 범위에 따라 결정됩니다. 측정항목 범위는 측정항목 범위를 호스팅하는 프로젝트에서 모니터링하는 프로젝트의 목록이며, 호스팅 프로젝트를 범위 지정 프로젝트라고 합니다.

기본적으로 각 프로젝트는 자신만을 포함하는 측정항목 범위를 호스팅하므로 프로젝트는 자기 자신의 범위 지정 프로젝트입니다. 따라서 로그 기반 측정항목을 포함한 측정항목은 해당 클라우드 프로젝트에만 표시됩니다.

범위 지정 프로젝트에 대한 다중 프로젝트 측정항목 범위를 만들 수도 있습니다. 다중 프로젝트 측정항목 범위를 사용하면 범위 지정 프로젝트가 측정항목 범위에 속한 모든 프로젝트의 측정항목을 볼 수 있습니다. 다중 프로젝트 측정항목 범위의 개별 프로젝트에 표시되는 내용은 이러한 프로젝트 각각에서 호스팅하는 측정항목 범위에 따라 결정됩니다. 두 프로젝트가 다중 프로젝트 측정항목 범위에 속하더라도 각 프로젝트가 다른 프로젝트의 측정항목 또는 구성 데이터에 액세스하지 못할 수 있습니다.

단일 프로젝트가 여러 측정항목 범위에 나타날 수도 있습니다. 이러한 프로젝트의 측정항목은 각 측정항목 범위의 범위 지정 프로젝트에 표시됩니다.

로그 기반 측정항목을 포함한 측정항목은 특정 프로젝트 내에 정의됩니다. 프로젝트가 여러 측정항목 범위에 표시되면 측정항목이 정의된 프로젝트가 아닌 다른 프로젝트에 표시됩니다.

멀티 프로젝트 측정항목 범위를 포함한 측정항목 범위와 범위 지정 프로젝트에 대한 자세한 내용은 다음을 참조하세요.

가격 책정

모든 사용자 정의 로그 기반 측정항목은 Cloud Monitoring 커스텀 측정항목의 클래스로서 요금이 부과됩니다. 가격 책정 정보는 Cloud Logging 가격 책정: 로그 기반 측정항목을 참조하세요.

할당량

사용자 정의 로그 기반 측정항목과 관련된 할당량 및 한도에 대해서는 할당량 및 한도를 참조하세요.

문제 해결

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