# API logs

Created: 02.08.2023&#x20;

Updated: 11.12.2023

Author: Anastasia N.

{% hint style="info" %}
To view API logs, you need to go to Settings → API logs.

![](/files/G80Ko0IFP3ToTW7kKp4m)
{% endhint %}

## **Logs Viewing Screen Structure**

<figure><img src="/files/TYV7gosSmynZ9aUZgZoK" alt=""><figcaption></figcaption></figure>

1. Search for a request by its content. Entities available for search are displayed in the dropdown menu:

&#x20;![](/files/8a6SiHLkcyXZXAjikHW7)

2. Data refresh button;
3. Bar chart showing the number of requests for the selected period. It displays the total number of requests for the period and count per day.
4. Select a time range for viewing logs.&#x20;

&#x20;  Available ranges:

* Today
* Yesterday
* Last 3 days
* Last 7 days
* Last 14 days
* Last 30 days
* Custom Range

You can also specify the start and end time of the selected period: ![](/files/ip8WR46YeqMwsNuCtq3v)

{% hint style="info" %}
As a custom range, you can select a period of up to 144 days
{% endhint %}

{% hint style="info" %}
Logs are shown according to the time-zone of your section.
{% endhint %}

5. Filter logs by request status.\
   Only the statuses corresponding to the requests within the chosen time range are available.
6. Filter logs by the endpoint to which the requests were sent.\
   Only the endpoints to which requests were sent within the chosen time range are available.
7. Filter logs by the types of events specified in the requests.\
   Selects only requests sent to the <mark style="color:red;">**`/ssapi/events`**</mark> endpoint. Only event types specified in the requests within the chosen time range are available.
8. Filter logs by the server-side request execution time.\
   You can specify minimum and/or maximum durations in milliseconds.
9. Select the columns displayed in the table.

Available parameters:

&#x20;![](/files/W9tmkEB57PeTsJbmqPKN)

| Parameter        | Value                                               |
| ---------------- | --------------------------------------------------- |
| Endpoint         | The endpoint to which the request was sent.         |
| User ID          | User ID assigned by Gravity Field (slid).           |
| SessionId        | Session ID assigned by Gravity Field.               |
| CustomSessionId  | Custom session identifier specified in the request. |
| Status           | Status (code) of the request: 200, 422, etc.        |
| Timestamp        | Timestamp of the request.                           |
| Request Duration | Request execution time on the server side.          |

10. View the request and response bodies.\
    To view, click on the row with the request information. The request body and response to the given request (if applicable for the opened request) will appear in a pull-out panel.

<div align="left"><figure><img src="/files/SBLdCHnsNt8cpqXqmuFx" alt="" width="375"><figcaption></figcaption></figure></div>


---

# 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://developer.gravityfield.ai/lang/en/platform-interface/api-logs.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.
