이 문서에서는 버킷 범위 로그 기반 측정항목의 특성을 요약하고 프로젝트 범위 로그 기반 측정항목과 어떻게 다른지 설명합니다.
버킷 범위 로그 기반 측정항목의 특성
버킷 범위 로그 기반 측정항목은 특정 로그 버킷으로 라우팅된 로그 항목을 평가하는 사용자 정의 로그 기반 측정항목입니다. 버킷 범위 로그 기반 측정항목을 사용하면 다음과 같은 경우에 로그에서 데이터를 추출하는 로그 기반 측정항목을 만들 수 있습니다.
- 한 프로젝트에서 다른 프로젝트의 버킷으로 라우팅된 로그입니다.
- 집계 싱크를 통해 버킷으로 라우팅되는 로그입니다.
프로젝트 범위 로그 기반 측정항목과 마찬가지로, 버킷 범위 로그 기반 측정항목은 폴더 또는 조직 수준이 아닌 Google Cloud 프로젝트 내에서 정의됩니다. 로그 항목이 버킷으로 라우팅된 폴더 또는 조직을 추적하려면 로그 기반 측정항목에 라벨을 정의하여 해당 정보를 기록하면 됩니다.
- 로그 기반 측정항목에 대한 일반 정보는 로그 기반 측정항목 개요를 참조하세요.
- 라우팅 및 싱크에 대해서는 라우팅 및 스토리지 개요를 참조하세요.
버킷 범위 로그 기반 측정항목은 프로젝트 범위 로그 기반 측정항목과 몇 가지 차이점이 있습니다.
프로젝트 및 측정항목 범위
버킷 범위 로그 기반 측정항목은 소스 버킷이 포함된 동일한 프로젝트에서 정의됩니다. 기본적으로 버킷 범위 로그 기반 측정항목을 정의하는 프로젝트만 로그 버킷의 측정항목 데이터를 볼 수 있습니다. 하지만 프로젝트가 다른 프로젝트의 측정항목 범위에 표시되는 경우 해당 프로젝트도 측정항목을 볼 수 있습니다.
로그를 버킷에 라우팅하는 Google Cloud 프로젝트는 다른 프로젝트의 측정항목 범위에 속할 필요가 없습니다.
로그 기반 측정항목 및 측정항목 범위에 대한 자세한 내용은 측정항목 범위의 가시성을 참조하세요.
버킷에 로그가 수신되면 버킷의 프로젝트가 측정항목 범위에 포함된 모든 프로젝트에 파생된 라우팅된 로그 측정항목 데이터가 표시됩니다. 프로젝트 라우팅 로그가 다른 프로젝트의 측정항목 범위에 속하지 않는 경우 라우팅 프로젝트의 다른 정보가 표시되지 않습니다.
버킷 범위 로그 기반 측정항목을 사용할 때는 다음 사항이 적용됩니다.
- 대상 버킷이 있는 프로젝트에 로그 기반 측정항목을 정의합니다.
- 버킷 범위 로그 기반 측정항목은 로그가 버킷과 동일한 프로젝트든 다른 프로젝트에서 제공되었는지에 관계없이 버킷으로 라우팅된 모든 로그 항목을 평가합니다.
- 측정항목 데이터는 측정항목 범위에 버킷이 있는 프로젝트를 포함하는 다른 모든 프로젝트에 표시됩니다.
- 프로젝트 라우팅 로그는 다른 프로젝트의 측정항목 범위에 속할 필요가 없습니다.
모니터링 리소스 유형: logging_bucket
버킷 범위 로그 기반 측정항목은 Cloud Monitoring에 시계열 데이터를 쓸 때 모니터링 리소스 유형 logging_bucket을 사용합니다. logging_bucket 리소스 유형에는 다음 라벨이 포함됩니다.
project_id: Google Cloud 프로젝트의 식별자이며my-test-project와 같은 문자열입니다.bucket_id: 로그 기반 측정항목과 연결된 로그 버킷의 이름이며my-test-bucket과 같은 문자열입니다.location: 로그 버킷의 위치입니다.monitored_resource_type: 이 로그 항목을 생성한 모니터링 리소스의 유형입니다. 값은 로그 항목의resource필드에 포함된MonitoredResource구조체의type필드에서 가져옵니다.source_resource_container: 로그 항목이 전송된 프로젝트, 폴더, 조직의 식별자이며 다음 형식 중 하나의 문자열입니다.projects/PROJECT_IDorganizations/ORGANIZATION_IDfolders/FOLDER_ID