نظارت بر استفاده

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

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

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

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

معیارهای نمودار در Metrics Explorer

1. به صفحه Monitoring > Metrics Explorer در Cloud Console بروید.

   به Metrics Explorer بروید

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

   • توجه: برای دسترسی به داده های نظارتی باید مجوزهای مدیریت هویت و دسترسی (IAM) مناسب را داشته باشید.

3. برای انتخاب معیاری برای افزودن به نمودار، روی Select a Metric کلیک کنید.

   • معیارهای Earth Engine تحت منبع پروژه Earth Engine Cloud هستند.
   • به‌طور پیش‌فرض، تنها منابع و معیارهایی که در ساعت گذشته فعال بوده‌اند قابل مشاهده هستند. محدوده زمانی را تنظیم کنید یا برای مشاهده معیارهای بیشتر، علامت فیلتر «فعال» را بردارید.

4. پس از انتخاب یک معیار، روی اعمال کلیک کنید.

5. در پنجره بالا، فیلترهای کشویی را برای تنظیم نحوه تجسم داده ها پیکربندی کنید.

   • به طور پیش‌فرض، کاوشگر یک تجمیع نرخ را برای معیارهای محاسباتی نشان می‌دهد. برای جزئیات بیشتر در مورد انتخاب یک Aligner مختلف و نشان دادن واحدهای صریح، به بخش Units and Aligners مراجعه کنید.
   • به عنوان مثال، برای مشاهده کل محاسبات دسته ای تکمیل شده استفاده شده در هر workload_tag ​​(به بخش برچسب های بار کاری مراجعه کنید) در هفته گذشته، می توانید تنظیمات زیر را انتخاب کنید. در اینجا، هر نقطه داده، مقدار کل EECU-ساعت هر کار دسته ای تکمیل شده را نشان می دهد.
     
     

مستندات Cloud Monitoring راهنماهای بیشتری در مورد استفاده از Cloud Monitoring ارائه می دهد. به طور خاص، صفحه انتخاب معیارها برای نمودار نمای کلی دقیقی از روش‌های مختلف ساخت پرس و جو ارائه می‌کند، و صفحه فیلتر کردن و تجمیع اطلاعات بیشتری در مورد پیکربندی سری‌های زمانی ارائه می‌دهد.

معیارهای موجود

معیارهای Earth Engine در پیش نمایش هستند و ممکن است تغییر کنند.

متریک	توضیحات	برچسب های موجود
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 دقیقه نمونه برداری می شود.	N/A

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

واحدها و ترازها

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

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

برچسب های حجم کار

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

سپس می توانید محاسبات برچسب گذاری شده را در Metrics Explorer با استفاده از متریک Earth Engine Cloud > Project > Used EECUs ، و گروه بندی یا فیلتر کردن بر اساس workload_tag ​​نظارت و ردیابی کنید.

توجه: نام ارسال شده به ee.data.setWorkloadTag باید کمتر از 64 کاراکتر باشد، با یک نویسه الفبایی ( [a-zA-Z0-9] ) با خط تیره ( - )، زیرخط ( _ )، و حروف عددی بین شروع و پایان یابد، و خالی نباشد.

به عنوان مثال، برای نظارت بر 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

راه اندازی پایتون

برای اطلاعات در مورد API پایتون و استفاده از geemap برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.

import ee
import geemap.core as geemap

کولب (پایتون)

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