로그 항목 데이터 모델

이 문서에서는 Cloud Logging에서 사용하는 데이터 모델을 설명합니다. 이 데이터 모델은 로그 데이터가 저장되는 형식을 지정합니다. 또한 로그 데이터를 쿼리할 수 있는 측정기준도 결정합니다.

데이터 모델

Cloud Logging에서 로그는 이름이 지정된 개별 항목의 모음입니다. 로그 이름으로 데이터를 쿼리할 수 있습니다. 로그는 LogEntry 구조를 따르는 항목으로 구성됩니다.

각 로그 항목은 상태를 기록하거나 가상 머신 인스턴스 만들기와 같은 특정 이벤트를 기술하며 최소한 다음 요소를 포함합니다.

  • 이벤트가 발생한 시점 또는 Cloud Logging에서 수신된 시점을 나타내는 타임스탬프
  • 로그 항목 소스에 관한 정보. 이 소스를 모니터링 리소스라고 합니다. 모니터링 리소스의 예시로는 개별 Compute Engine 인스턴스 및 Google Kubernetes Engine 컨테이너가 있습니다. 모니터링 리소스 유형의 전체 목록은 모니터링 리소스 및 서비스를 참조하세요.

  • 다음 중 하나여야 하는 페이로드:

    • textPayload: 이러한 페이로드는 단일 문자열 형식입니다.
    • jsonPayload: 이러한 페이로드는 정형화되어 있으므로 키-값 쌍으로 쿼리할 수 있습니다. 애플리케이션이 항상 정형 로그 데이터를 작성하는 것이 좋습니다.
    • protoPayload: 이러한 페이로드는 proto 파일 형식을 따르며 필드는 JSON 형식입니다.

  • 로그가 속한 로그의 이름. 로그 이름에는 로그 항목이 속한 리소스의 전체 경로와 식별자가 포함됩니다. 다음은 로그 이름의 예시입니다.

    • projects/my-project/logs/stdout
    • projects/my-project/compute.googleapis.com/activity

LogEntry 필드의 값이 일부 기준과 일치하는 로그 항목만 검색하는 쿼리를 작성할 수 있습니다. 예를 들어 severity 필드에 ERROR의 값이 있는 로그 항목만 표시할 수 있습니다.

로그 항목 유형

감사 로그 및 액세스 투명성은 규정 준수를 충족하는 데 필요한 정보를 제공합니다. 감사 로그는 Google Cloud 리소스 내 관리 활동과 액세스에 대한 정보를 제공합니다. 액세스 투명성 로그는 Google Cloud 콘텐츠에 액세스할 때 Google Cloud직원이 수행한 작업을 기록합니다. 지원되는 서비스 목록은 감사 로그가 있는Google Cloud 서비스 및 액세스 투명성 로그가 있는Google Cloud 서비스를 참조하세요.

다음 유형의 로그 항목은 로그가 발생한 Google Cloud 프로젝트, 결제 계정, 폴더 또는 조직의 _Required 로그 버킷에 저장됩니다.

  • 액세스 투명성 로그

Google Cloud 프로젝트, 결제 계정, 폴더 또는 조직에서 발생하는 다른 모든 로그 항목은 _Default 로그 버킷에 저장됩니다. 하지만 이 로그 버킷에 저장되는 로그 항목은 변경할 수 있습니다.

다음 단계