# Analytics

Stook Analytics provides detailed visibility into how your [Stook Object Storage](https://clients.medianova.com/products/object-storage-stook/stook-cloud-object-storage) buckets are used, accessed, and performing over time.

It aggregates request-level data generated by Stook API operations and presents them as charts, KPIs, and raw logs to help you monitor traffic, performance, and reliability.

You can access Stook Analytics from the [Medianova Control Panel](https://cloud.medianova.com) or programmatically via the [Stook Analytics API](https://clients.medianova.com/api-documentation/analytics/stook-analytics).

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2Ft3p5QykDADExLjJyB5Zd%2Fcloud.medianova.com_analytics_stook.png?alt=media&#x26;token=f7c8bef9-4b48-4204-a451-bd8d7ef8633a" alt=""><figcaption><p>Stook Analytics</p></figcaption></figure>

{% hint style="success" %}
The [Stook Buckets](https://clients.medianova.com/products/object-storage-stook/connect-stook-bucket-to-cdn) page includes a built-in analytics preview that shows a high-level view of usage and request activity.\
Select **View more data** to open the full Stook Analytics view with advanced filtering and detailed metrics.
{% endhint %}

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FggUX5YOjahzFQHyHKMOG%2Fstook-buckets.png?alt=media&#x26;token=610e5876-cf51-441e-9213-51943b435cfd" alt="" width="563"><figcaption><p>Analytics preview displayed on the Stook Buckets page</p></figcaption></figure>

## Filters and Time Range

Use filters to narrow down analytics data and focus on specific buckets, operations, or traffic characteristics.

{% hint style="info" %}
Analytics queries support a maximum time range of **90 days per request**.\
For longer analysis periods, split your queries into multiple date ranges.
{% endhint %}

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FWcIvX6wi2ZebRMmZlEP5%2Fimage%20(5).png?alt=media&#x26;token=af20c26e-cfcf-4e99-93a5-a2806cf734cf" alt="" width="563"><figcaption><p>Use filters and metric selectors to refine analytics data by bucket, operation, and time range.</p></figcaption></figure>

You can filter analytics data by:

* **Bucket** – View metrics for one or more Stook Buckets
* **Metric type** – Switch between Requests, Bytes, Throughput, IO Rate, and Average Response Time
* **API operation** – Filter by Stook API actions such as `GetObject`, `PutObject`, or `ListObjectsV2`
* **Status code and response type** – Analyze successful and failed requests
* **Geography and endpoint** – Inspect traffic by country or request host

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FIqMTrSZD1W9PgnEq33tM%2Fimage%20(6).png?alt=media&#x26;token=481bce09-404d-4746-83e1-733c31a31296" alt="" width="563"><figcaption><p>Add filter options for advanced traffic analysis</p></figcaption></figure>

Select a custom **time range** to analyze historical data.\
All charts and tables update automatically based on the selected period.

{% hint style="info" %}
FTP uploads are not included in Stook Analytics.
{% endhint %}

## Data retention policy

{% hint style="info" %}
Stook Analytics retains historical analytics data for **up to 6 months**.

Charts, tables, and raw logs may return partial or empty results when querying dates outside the retention period.
{% endhint %}

## Key Metrics Overview

At the top of the Analytics page, Stook Analytics provides a summary of key metrics for the selected scope and time range.

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FuI1pdCjmWzG6uthvumv2%2Fimage%20(12).png?alt=media&#x26;token=30e84d49-f036-478b-980a-c52f83ae64db" alt=""><figcaption><p>Key metrics and request distributions provide a high-level overview of usage, performance, and reliability.</p></figcaption></figure>

These metrics include:

* **Total Requests** – Total number of API requests processed
* **Total Bytes** – Total amount of data transferred
* **Average Response Time** – Average request processing duration
* **Total Stored Data** – Current storage usage across selected buckets
* **Success Rate** – Percentage of successful requests
* **Failure Rate** – Percentage of failed requests
* **Upload and Download Requests** – Number of upload and download operations

This overview helps you quickly assess usage, performance, and reliability.

{% hint style="info" %}
For detailed explanations of each metric and how they are calculated, see the [Metrics](https://clients.medianova.com/products/object-storage-stook/analytics/metrics) page.
{% endhint %}

### Traffic and Request Analytics

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FllnRi9jh9sQobLWRoN88%2Fimage%20(11).png?alt=media&#x26;token=60e2df6e-663e-40ef-82ba-c2a4d5bf807c" alt=""><figcaption><p>Request volume visualized over time, by bucket, and by endpoint.</p></figcaption></figure>

#### Requests over time

Visualize how request volume changes over time to identify traffic patterns, peaks, or unexpected drops.

#### Requests per bucket

Break down request volume by bucket to understand how traffic is distributed across your Stook Buckets.

#### Requests per endpoint

Analyze request volume per endpoint to identify the most frequently accessed hosts.

### Distribution Insights

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2Fg4i2oadfe52fStKxRfP9%2Fimagevvv.png?alt=media&#x26;token=16b0d6f6-8894-4796-a09f-682f6fede7bc" alt=""><figcaption><p>Distribution of requests by API operation and geographic location.</p></figcaption></figure>

#### Requests per method

View the distribution of Stook API operations, including:

* `GetObject`
* `PutObject`
* `ListObjectsV2`
* `DeleteObject`
* `HeadObject`

This view helps you understand how applications interact with your stored objects.

#### Requests per country

Analyze the geographic distribution of requests based on country codes.

### Error Analysis

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FvyNTJJWTwHwegjnLQdYm%2Fimage%20(8).png?alt=media&#x26;token=c479ab09-96f3-4510-80c8-11af56ccf637" alt=""><figcaption><p>Client-side and server-side error ratios visualized over time and across buckets.</p></figcaption></figure>

#### Error ratio

Track client-side (4xx) and server-side (5xx) error ratios over time.

#### Failure rate per bucket

Compare failure rates across buckets to identify configuration issues or abnormal request patterns.

### Bucket Details

The **Bucket Details** table provides a bucket-level summary, including:

* Request count
* IO rate
* Total bytes transferred
* Throughput
* Success rate
* 4xx and 5xx ratios

This table enables quick comparison of performance and reliability across buckets.

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2F6cQ88Xt0mrGJTyZSyUbC%2Fimage%20rrrr.png?alt=media&#x26;token=b72c242c-8875-48d5-964f-ca8a49ef8ecb" alt=""><figcaption><p>Bucket-level summary of request volume, throughput, and error ratios.</p></figcaption></figure>

### Raw Logs

The **Raw Logs** section lists individual request records for detailed inspection and troubleshooting.

{% hint style="info" %}
Raw log queries follow the same **time range** and **data retention** limits as other analytics views.
{% endhint %}

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2F26fhga9zTfuEEimGuaHA%2Fimage%20(10).png?alt=media&#x26;token=d2f1517c-6fc4-4c77-9e14-bee6c1788adc" alt=""><figcaption><p>Detailed request logs for inspection and troubleshooting.</p></figcaption></figure>

Each log entry includes:

* Timestamp
* Bucket name
* API operation
* Status code
* Request host and path

You can open a log entry to view full request details, performance metrics, and client information.

## FAQ

**Why can I only query up to 90 days of data at once?**

To ensure consistent performance and predictable response times, Stook Analytics limits each analytics query to a maximum of **90 days**.\
If you need to analyze a longer period, split your request into multiple date ranges and combine the results.

**How long is analytics data retained?**

Stook Analytics retains historical analytics data for **up to 6 months**.\
Queries outside this retention window may return partial or empty results, depending on data availability.

**Are all Stook operations included in analytics and raw logs?**

Stook Analytics includes request-level data generated by [Stook API](https://clients.medianova.com/api-documentation/object-storage-stook) operations such as object access, uploads, downloads, and metadata requests.\
**FTP uploads are not included** in analytics metrics or raw logs.

## API Access

For automation, integration, or custom monitoring workflows, Stook Analytics data can be retrieved programmatically.

[See the Stook Analytics API Reference](https://clients.medianova.com/api-documentation/analytics/stook-analytics)