Anuncio: Todos los proyectos no comerciales registrados para usar Earth Engine antes del 15 de abril de 2025 deben verificar su elegibilidad no comercial para mantener el acceso a Earth Engine.

Se usó la API de Cloud Translation para traducir esta página.

Supervisa el uso

En esta página, se describe cómo crear gráficos para supervisar el procesamiento y el consumo de almacenamiento de Earth Engine con Cloud Monitoring.

Existen otras formas de supervisar el uso de Earth Engine desde la consola de Cloud, que no son el enfoque del documento, pero incluyen las siguientes:

La página APIs y servicios > Métricas, que muestra métricas básicas, como el tráfico (cantidad de solicitudes), los errores y la latencia (por método de API, código de respuesta o credenciales)
La página APIs y servicios > Cuotas y límites del sistema, que muestra la cantidad de recursos almacenados en bytes y la cantidad de solicitudes de lectura para los recursos
La página APIs y servicios > Credenciales, que muestra qué credenciales (p.ej., cuentas de servicio) se usaron para acceder a la API

Cómo ver el consumo en Cloud Monitoring

Crea gráficos de métricas en el Explorador de métricas

Ve a la página Monitoring > Metrics Explorer en la consola de Cloud.

Ir al Explorador de métricas
Selecciona el nombre de tu proyecto si aún no está seleccionado en la parte superior de la página.
- Nota: Debes tener los permisos de Identity and Access Management (IAM) adecuados para acceder a los datos de supervisión.
Haz clic en Seleccionar una métrica para elegir una métrica que quieras agregar al gráfico.
- Las métricas de Earth Engine se encuentran en el recurso Proyecto de Cloud de Earth Engine.
- De forma predeterminada, solo se muestran los recursos y las métricas que estuvieron activos durante la última hora. Para ver más métricas, ajusta el intervalo de tiempo o desmarca el filtro "Activo".
Una vez que hayas seleccionado una métrica, haz clic en Aplicar.
En el panel superior, configura los filtros desplegables para establecer cómo visualizar los datos.
- De forma predeterminada, el explorador mostrará una agregación de tasas para las métricas de procesamiento. Consulta la sección Unidades y Alineadores para obtener detalles sobre cómo elegir un Alineador diferente y mostrar unidades explícitas.
- Por ejemplo, para ver el procesamiento por lotes completado total que se usó por workload_tag (consulta la sección Etiquetas de carga de trabajo) durante la semana pasada, puedes elegir la siguiente configuración. Aquí, cada dato representa la cantidad total de horas de EECU que usó cada tarea de lote completada.

La documentación de Cloud Monitoring proporciona más guías sobre el uso de Cloud Monitoring. En particular, la página Selecciona las métricas para graficar proporciona una descripción general detallada de las diferentes formas de crear consultas, y la página Filtrado y agregación proporciona más información para configurar las series temporales.

Métricas disponibles

Métrica	Descripción	Etiquetas disponibles
EECU-segundos completados	Uso de procesamiento de Earth Engine de solicitudes correctas en segundos de EECU. El uso se informa cuando se completa una solicitud y no se informa para las solicitudes que fallan.	`compute_type`: Es el tipo de procesamiento, según el entorno de procesamiento de la solicitud. Es uno de los siguientes: [`online`, `batch`, `highvolume`]. `client_type`: Es el tipo de cliente (si se conoce), por ejemplo: `ee-js/latest` o `python/v0.1.300`. El tipo de cliente no está configurado para el procesamiento por lotes. `workload_tag`: Es la etiqueta de carga de trabajo (si se proporciona en el cliente), por ejemplo: `my-export1`. Consulta la sección Etiquetas de cargas de trabajo para saber cómo configurar esta etiqueta.
EECU-segundos en curso	Es el uso de procesamiento de Earth Engine de todas las solicitudes en EECU-segundos. El uso se informa periódicamente a medida que se ejecuta una solicitud.	`compute_type`: Es el tipo de procesamiento, según el entorno de procesamiento de la solicitud. Es uno de los siguientes: [`online`, `batch`, `highvolume`]. `client_type`: Es el tipo de cliente (si se conoce), por ejemplo: `ee-js/latest` o `python/v0.1.300`. El tipo de cliente no está configurado para el procesamiento por lotes. `workload_tag`: Es la etiqueta de carga de trabajo (si se proporciona en el cliente), por ejemplo: `my-export1`. Consulta la sección Etiquetas de cargas de trabajo para saber cómo configurar esta etiqueta.
Bytes usados	Es la cantidad de bytes de almacenamiento de recursos de Earth Engine que se usó. Se toman muestras cada 30 minutos.	N/A

Para obtener una lista completa de las métricas disponibles en Cloud Monitoring, consulta Métricas de Google Cloud.

Unidades y alineadores

De forma predeterminada, las métricas de procesamiento se mostrarán como una tasa sin unidades del promedio de EECU-segundos usados por segundo durante el intervalo mínimo (1 minuto predeterminado).

Para ver el tiempo de EECU sin procesar que se usa con unidades explícitas, haz clic en el campo Agregación en tu consulta y elige "Configurar alineador" en el menú resultante. Esto reemplaza la operación de agregación por dos operaciones nuevas: Agrupación y Función de alineación. Si eliges "Agrupación: Sum" y "Función de alineación: Sum", se creará un gráfico con unidades explícitas que representan el tiempo total de EECU que se usa en cada dato. Consulta la referencia de Aligner para obtener una lista de los posibles alineadores.

Etiquetas de cargas de trabajo

Las etiquetas de carga de trabajo son etiquetas para supervisar cálculos específicos en Earth Engine. Usa setDefaultWorkloadTag para vincular todos los cálculos de la secuencia de comandos a una etiqueta de carga de trabajo predeterminada, a menos que se establezca una de forma explícita con ee.data.setWorkloadTag, en cuyo caso se anula la predeterminada. Estos métodos establecen la etiqueta workload_tag para cálculos y tareas de exportación específicos.

Luego, puedes supervisar y hacer un seguimiento de los cálculos etiquetados en el Explorador de métricas con la métrica Proyecto de nube de Earth Engine > Proyecto > EECUs usadas y agrupar o filtrar por workload_tag.

Por ejemplo, para supervisar los EECU que se usan para el procesamiento o la exportación de una imagen, haz lo siguiente:

Editor de código (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

Configuración de Python

Consulta la página Entorno de Python para obtener información sobre la API de Python y el uso de geemap para el desarrollo interactivo.

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()

En este ejemplo, todos los cálculos se anotan con la etiqueta landsat-compositing (configurada de forma predeterminada), y la exportación obtiene su propia etiqueta de carga de trabajo, ya que se llama a ee.data.setWorkloadTag antes de ejecutarla. Usa ee.data.resetWorkloadTag para volver a establecer la etiqueta predeterminada o para establecerla en una cadena vacía.