83. Query: Coletar Contexto da Plataforma

Com um grande número (centenas ou milhares) de conjuntos de dados processados (como "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc) sempre há demanda para entender o status do processamento de cada conjunto de dados e coletar o resumo do processamento. Esses detalhes são fornecidos usando getPlatformContext consulta.

Os casos comuns:

• Rastrear o progresso do processamento

• Coletar resumo e estatísticas do processamento

• Observar erros e avisos durante o processamento para investigação mais aprofundada dos conjuntos de dados afetados

query CollectPlatformContext {
 getPlatformContext(input: {
   userUuids: ["<placeholder_of_user_uuid>"],
   statuses: [Start, Done, Warning, Error, Ignored],
   dateFrom: "2023-05-25T12:49:00.000Z", 
   dateTo: "2023-05-30T06:35:00.000Z", 
 }) {
   events {
     fieldUuid
     subFieldUuid
     subFieldType
     operationId
     status 
     executionDate
     messageKey
     opcional
   }
 }
}

Filtros de entrada suportados:

• dateFrom como datetime em formato ISO 8601 (ex: "2023-05-25T12:49:00.000Z")

• dateTo como datetime em formato ISO 8601 (ex: "2023-05-30T06:35:00.000Z")

• operationIds como array dos identificadores da operação (Strings)

• statuses como array contendo valores de ContextEventStatus enum com todos os status de processamento incluindo intermediários, recomendado usar os principais [Start, Done, Warning, Error, Ignored]

• subFieldTypes como array contendo valores de TreeNodeEntity enum com todas as entidades do GeoPard

• subFieldUuids como array com UUIDs vinculados às entidades selecionadas em subFieldTypes

• userUuids como array de UUIDs de "User" para busca

Pelo menos um dos seguintes filtros deve ser inicializado: userUuids, fieldUuids, subFieldUuids, ou operationIds.

Se dateFrom e dateTo não forem especificados, a duração padrão da consulta é definida para 12 horas. O período máximo recomendado para recuperação de dados é de 24 horas.

Há um limite de no máximo 10.000 linhas entregues.

Para observar todos os valores mais recentes disponíveis de enums (como: TreeNodeEntity, ContextEventStatus, ContextMessageKey), é recomendado usar Altair.

O objeto de saída inclui os seguintes atributos:

• fieldUuid representa o UUID do Campo associado

• subFieldUuid denota o UUID do conjunto de dados processado vinculado (como "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc)

• subFieldType como enum vinculado a TreeNodeEntity

• operationId como string que contém o identificador da operação, permanece consistente em todas as cadeias de processamento relacionadas, é recomendável agrupar por esse identificador para rastrear todas as etapas do processamento

• status como enum vinculado a ContextEventStatus

• executionDate como string no formato ISO 8601 que indica o momento da execução

• messageKey como enum vinculado a ContextMessageKey que descreve o resultado da execução

• opcional como string que fornece uma descrição técnica (se relevante), é usada principalmente para depuração e relato de bugs