پایش مصرف

این صفحه نحوه ایجاد نمودار برای نظارت بر مصرف فضای ذخیره‌سازی و محاسبات Earth Engine بااستفاده از Cloud Monitoring را شرح می‌دهد.

روش‌های دیگری برای نظارت بر استفاده از Earth Engine ازطریق «کنسول Cloud» وجود دارد که تمرکز این سند نیستند اما شامل موارد زیر می‌شوند:

  • صفحه APIs & Services > Metrics که سنجه‌های پایه ازجمله ترافیک (تعداد درخواست‌ها)، خطاها، و تأخیر (براساس روش API، کد پاسخ، یا اطلاعات کاربری) را نشان می‌دهد.
  • صفحه میاناهای برنامه‌سازی کاربردی و سرویس‌ها > سهمیه‌ها و حدود سیستم، که مقدار دارایی‌های ذخیره‌شده را به بایت و تعداد درخواست‌های خواندن برای دارایی‌ها را نشان می‌دهد.
  • صفحه میاناهای برنامه‌سازی کاربردی و سرویس‌ها > اطلاعات کاربری، که نشان می‌دهد از کدام اطلاعات کاربری (مثلاً حساب‌های سرویس) برای دسترسی به میانای برنامه‌سازی کاربردی استفاده شده است.

مشاهده مصرف در Cloud Monitoring

سنجه‌های نمودار در «کاوشگر سنجه‌ها»

  1. به صفحه نظارت > کاوشگر سنجه‌ها در «کنسول Cloud» بروید.

    رفتن به «کاوشگر سنجه‌ها»

  2. اگر نام پروژه‌تان در بالای صفحه انتخاب نشده است، آن را انتخاب کنید.

  3. روی انتخاب سنجه کلیک کنید تا سنجه‌ای را برای افزودن به نمودار انتخاب کنید.

    • سنجه‌های Earth Engine تحت منبع پروژه ابری Earth Engine قرار دارند.
    • به‌طور پیش‌فرض، فقط منابع و سنجه‌هایی که در ساعت گذشته فعال بوده‌اند قابل‌مشاهده هستند. محدوده زمانی را تنظیم کنید یا علامت فیلتر «فعال» را بردارید تا سنجه‌های بیشتری ببینید.
  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. هر ۳۰ دقیقه نمونه‌برداری می‌شود. موجود نیست

برای مشاهده فهرست کامل سنجه‌های دردسترس در Cloud Monitoring، به سنجه‌های Google Cloud مراجعه کنید.

واحدها و ترازکننده‌ها

به‌طور پیش‌فرض، سنجه‌های محاسباتی به‌عنوان نرخ بدون واحد میانگین ثانیه‌های EECU استفاده‌شده در هر ثانیه در فاصله زمانی حداقل (به‌طور پیش‌فرض ۱ دقیقه) نمایش داده می‌شود.

برای دیدن زمان EECU خام استفاده‌شده با واحدهای صریح، روی فیلد انبوهش در پُرسمان خود کلیک کنید و «پیکربندی هم‌ترازکننده» را از منو حاصل انتخاب کنید. این کار عملیات تجمیع را با دو عملیات جدید جایگزین می‌کند: گروه‌بندی و تابع هم‌ترازی. انتخاب «گروه‌بندی: Sum» و «تابع هم‌ترازی: Sum» نموداری با واحدهای صریح می‌سازد، که نشان‌دهنده کل زمان EECU مورداستفاده در هر نقطه داده است. برای مشاهده فهرست «ترازکننده‌های» ممکن، به مرجع ترازکننده مراجعه کنید.

برچسب‌های بار کاری

برچسب‌های حجم کاری برچسب‌هایی برای نظارت بر محاسبات خاص در Earth Engine هستند. از setDefaultWorkloadTag برای مقید کردن همه محاسبات در دستورگان به برچسب حجم کاری پیش‌فرض استفاده کنید، مگراینکه برچسبی به‌طور صریح با ee.data.setWorkloadTag تنظیم شده باشد که دراین‌صورت، پیش‌فرض لغو می‌شود. این روش‌ها برچسب workload_tag را برای محاسبات خاص و تکالیف صادر کردن تنظیم می‌کنند.

سپس می‌توانید محاسبات برچسب‌گذاری‌شده را در کاوشگر سنجه‌ها بااستفاده از سنجه پروژه ابری Earth Engine > پروژه > EECUهای استفاده‌شده و گروه‌بندی یا فیلتر کردن براساس workload_tag پایش و ردیابی کنید.

برای مثال، برای نظارت بر EECUهای استفاده‌شده برای محاسبه تصویر و/یا صادر کردن:

ویرایشگر کد (جاوا اسکریپت)

// 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 Environment مراجعه کنید.

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 برای بازگرداندن به برچسب پیش‌فرض یا بازگرداندن برچسب پیش‌فرض به رشته خالی استفاده کنید.