# 83. Query: Collect Platform Context

At a large number (hundreds or thousands) of processed datasets (like "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc) there is always a demand to understand the status of the processing of every dataset and collect the processing summary. These details are provided using `getPlatformContext` query. 

The common cases: 

* Trace the processing progress
* Collect processing summary and statistics
* Observe errors and warnings during processing for further deeper investigation of affected datasets

{% code overflow="wrap" lineNumbers="true" %}

```graphql
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
     optional
   }
 }
}
```

{% endcode %}

Supported input filters:

* `dateFrom` as datetime in ISO 8601 format (ex: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` as datetime in ISO 8601 format (ex: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` as array of the operation identificators (`Strings`)
* `statuses` as array contained values from `ContextEventStatus` enum with all processing statuses including intermediate, recommended to use the key ones `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` as array had  values of `TreeNodeEntity` enum with all GeoPard entities
* `subFieldUuids` as array with UUIDs linked to the selected entities in `subFieldTypes`&#x20;
* `userUuids` as array of "User" UUIDs to search

{% hint style="info" %}
At least one of the following filters must be initialized: `userUuids`, `fieldUuids`, `subFieldUuids`, or `operationIds`.
{% endhint %}

{% hint style="info" %}
If `dateFrom` and `dateTo` are not specified, the default query duration is set to 12 hours. The maximum recommended time span for data retrieval is 24 hours.
{% endhint %}

{% hint style="info" %}
There is a limit of max 10,000 rows delivered.
{% endhint %}

{% hint style="info" %}
To observe all available latest values of enums (like: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`),  it is recommended to use [Altair](/geopard-tutorials/api-docs/getting-started-with-the-geopard-api.md).
{% endhint %}

The output object includes the following attributes:

* `fieldUuid` represents the UUID of the associated Field
* `subFieldUuid` denotes the UUID of the linked processed dataset (like "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc)
* `subFieldType` as enum linked to the `TreeNodeEntity`
* `operationId` as string that holds the identifier of the operation, it remains consistent across all related processing chains, it's advisable to group by this identifier to trace all processing stages
* `status` as enum linked to `ContextEventStatus`
* `executionDate` as string in the ISO 8601 format that indicates the moment of execution
* `messageKey` as enum linked to `ContextMessageKey` that describes the outcome of the execution
* `optional` as string that provides a technical description (if relevant), it is primarily used for debugging and bug reporting


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/api-docs/geopard-api-requests-overview/83.-query-collect-platform-context.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.