사용량 모니터링

이 페이지에서는 Cloud Monitoring을 사용하여 Earth Engine 컴퓨팅 및 스토리지 사용량을 모니터링하는 차트를 만드는 방법을 설명합니다.

Cloud 콘솔에서 Earth Engine 사용량을 모니터링하는 다른 방법도 있습니다. 이 방법은 문서의 주제가 아니지만 다음을 포함합니다.

  • 트래픽 (요청 수), 오류, 지연 시간 (API 메서드, 응답 코드 또는 사용자 인증 정보별)을 비롯한 기본 측정항목을 보여주는 API 및 서비스 > 측정항목 페이지
  • 저장된 확장 소재의 크기(바이트)와 확장 소재의 읽기 요청 수를 보여주는 API 및 서비스 > 할당량 및 시스템 한도 페이지
  • API에 액세스하는 데 사용된 사용자 인증 정보 (예: 서비스 계정)를 보여주는 API 및 서비스 > 사용자 인증 정보 페이지

Cloud Monitoring에서 소비량 보기

측정항목 탐색기에서 측정항목 차트 표시

  1. Cloud 콘솔에서 모니터링 > 측정항목 탐색기 페이지로 이동합니다.

    측정항목 탐색기로 이동

  2. 페이지 상단에서 프로젝트 이름을 선택합니다(아직 선택하지 않은 경우).

  3. 측정항목 선택을 클릭하여 차트에 추가할 측정항목을 선택합니다.

    • Earth Engine 측정항목은 Earth Engine Cloud Project 리소스에 있습니다.
    • 기본적으로 지난 1시간 동안 활성 상태였던 리소스 및 측정항목만 표시됩니다. 기간을 조정하거나 '활성' 필터를 선택 해제하여 더 많은 측정항목을 확인합니다.
  4. 측정항목을 선택한 후 적용을 클릭합니다.

  5. 상단 창에서 드롭다운 필터를 구성하여 데이터를 시각화하는 방법을 설정합니다.

    • 기본적으로 탐색기에는 컴퓨팅 측정항목의 비율 집계가 표시됩니다. 다른 정렬기를 선택하고 명시적인 단위를 표시하는 방법에 관한 자세한 내용은 단위 및 정렬기 섹션을 참고하세요.
    • 예를 들어 지난주에 workload_tag (워크로드 태그 섹션 참고)당 사용된 총 완료된 일괄 컴퓨팅을 보려면 다음 설정을 선택할 수 있습니다. 여기서 각 데이터 포인트는 완료된 각 일괄 작업에서 사용된 총 EECU-시간을 나타냅니다.

      측정항목 탐색기 구성 예시

Cloud Monitoring 문서에서 Cloud Monitoring 사용에 관한 자세한 가이드를 확인하세요. 특히 차트에 표시할 측정항목 선택 페이지에서는 쿼리를 작성하는 다양한 방법에 관한 자세한 개요를 제공하고 필터링 및 집계 페이지에서는 시계열 구성에 관한 자세한 정보를 제공합니다.

사용 가능한 측정항목

측정항목 설명 사용 가능한 라벨
완료된 EECU 초 성공한 요청의 Earth Engine 컴퓨팅 사용량( EECU-초)입니다. 사용량은 요청이 완료될 때 보고되며 실패한 요청에 대해서는 보고되지 않습니다. compute_type: 요청의 처리 환경에 따라 컴퓨팅 유형입니다. [online, batch, highvolume] 중 하나입니다.

client_type: 클라이언트 유형(알려진 경우)입니다(예: ee-js/latest 또는 python/v0.1.300). 일괄 컴퓨팅에 클라이언트 유형이 설정되지 않았습니다.

workload_tag: 워크로드 태그(클라이언트에서 제공된 경우)입니다(예: my-export1). 이 라벨을 설정하는 방법은 워크로드 태그 섹션을 참고하세요.
진행 중인 EECU 초 모든 요청의 Earth Engine 컴퓨팅 사용량(단위: EECU-초)입니다. 요청이 실행될 때 주기적으로 사용량이 보고됩니다. compute_type: 요청의 처리 환경에 따라 컴퓨팅 유형입니다. [online, batch, highvolume] 중 하나입니다.

client_type: 클라이언트 유형(알려진 경우)입니다(예: ee-js/latest 또는 python/v0.1.300). 일괄 컴퓨팅에 클라이언트 유형이 설정되지 않았습니다.

workload_tag: 워크로드 태그(클라이언트에서 제공된 경우)입니다(예: my-export1). 이 라벨을 설정하는 방법은 워크로드 태그 섹션을 참고하세요.
사용된 바이트 수 사용된 Earth Engine 애셋 저장소의 바이트 수입니다. 30분마다 샘플링됩니다. 해당 사항 없음

Cloud Monitoring에서 사용 가능한 전체 측정항목 목록은 Google Cloud 측정항목을 참고하세요.

단위 및 정렬기

기본적으로 컴퓨팅 측정항목은 최소 간격 (기본값: 1분) 동안 초당 사용된 평균 EECU-초의 단위 없는 비율로 표시됩니다.

명시적 단위로 사용되는 원시 EECU 시간을 보려면 쿼리의 집계 필드를 클릭하고 표시되는 메뉴에서 '정렬 도구 구성'을 선택합니다. 이렇게 하면 집계 작업이 그룹화정렬 함수라는 두 가지 새 작업으로 대체됩니다. '그룹화: Sum' 및 '정렬 함수: Sum'를 선택하면 각 데이터 포인트에서 사용되는 총 EECU 시간을 나타내는 명시적 단위가 있는 그래프가 생성됩니다. 가능한 정렬기 목록은 정렬기 참조를 참고하세요.

워크로드 태그

워크로드 태그는 Earth Engine 내에서 특정 계산을 모니터링하기 위한 라벨입니다. setDefaultWorkloadTag를 사용하여 스크립트의 모든 계산을 기본 워크로드 태그에 바인딩합니다. 단, 기본 워크로드 태그가 ee.data.setWorkloadTag로 명시적으로 설정된 경우에는 기본값이 재정의됩니다. 이러한 메서드는 특정 계산 및 내보내기 작업에 workload_tag 라벨을 설정합니다.

그런 다음 측정항목 탐색기에서 Earth Engine Cloud Project > Project > Used EECUs 측정항목을 사용하고 workload_tag로 그룹화하거나 필터링하여 태그된 계산을 모니터링하고 추적할 수 있습니다.

예를 들어 이미지 계산 또는 내보내기에 사용되는 EECU를 모니터링하려면 다음 단계를 따르세요.

코드 편집기 (JavaScript)

// Set a default workload tag.
ee.data.setDefaultWorkloadTag('landsat-compositing')
var composite = ee.ImageCollection('LANDSAT/LC08/C02/T1_L2')
                     .filterDate('2020-01-01', '2021-01-01')
                     .median();

// Set a workload tag for export.
ee.data.setWorkloadTag('export-jobs');
Export.image.toAsset(composite);
ee.data.resetWorkloadTag(); // Reset to landsat-compositing

ee.data.resetWorkloadTag(true); // Reset back to empty

Python 설정

Python API 및 대화형 개발을 위한 geemap 사용에 관한 자세한 내용은 Python 환경 페이지를 참고하세요.

import ee
import geemap.core as geemap

Colab (Python)

# Authenticate, then initialize with your Cloud Project.
ee.Initialize(project='your-project')

# Set a default workload tag.
ee.data.setDefaultWorkloadTag('landsat-compositing')
composite = (
    ee.ImageCollection('LANDSAT/LC08/C02/T1_L2')
    .filterDate('2020-01-01', '2021-01-01')
    .median()
)

# Set a workload tag for export.
ee.data.setWorkloadTag('export-jobs')
ee.batch.Export.image.toAsset(composite).start()
ee.data.resetWorkloadTag()  # Reset to landsat-compositing

ee.data.resetWorkloadTag(True)  # Reset back to empty

# Alternatively, use a workload tag with the `with` context manager.
with ee.data.workloadTagContext('export-jobs'):
  ee.batch.Export.image.toAsset(composite).start()

이 예시에서 모든 계산은 landsat-compositing 태그 (기본값으로 설정됨)로 주석 처리되며, 내보내기는 실행하기 전에 ee.data.setWorkloadTag가 호출되므로 자체 워크로드 태그를 가져옵니다. ee.data.resetWorkloadTag를 사용하여 기본 태그로 다시 설정하거나 기본 태그를 빈 문자열로 다시 설정합니다.