> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skyfree.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Instance Performance

> See API latency for your instance broken down by country.

<Info>
  **Included with every self-managed instance.** It requires the `instance:view` permission.
</Info>

## What is this?

**Instance Performance** shows API latency for your instance broken down by country, so you can see how responsive your instance is for users in different regions and spot geographic performance problems.

<img src="https://mintcdn.com/mail2skyfreegmailcom/RbQ-QWSO7Z1yojdz/images/instance-performance-table.png?fit=max&auto=format&n=RbQ-QWSO7Z1yojdz&q=85&s=8609b8c6f50aaee261f0746b974e55e1" alt="Instance Performance page showing the stat tiles and the country-level latency table" width="1282" height="953" data-path="images/instance-performance-table.png" />

## What can I do here?

* View summary tiles: **Total Users**, **Best P95** (best 95th-percentile latency among countries), and **Worst P95**
* Search countries by name or country code (for example, "Malaysia" or "MY")
* See, per country: user count, request count, average latency, P50 (median) latency, P95 latency, sample size, and an assessment (**Normal**, **Elevated**, or **Severe**)
* Refresh the data on demand (it also auto-refreshes every 30 seconds)

## How to use it

### Check latency by country

1. Open **Instance Performance**. The table lists countries sorted with the worst-performing (highest P95) first.
2. Use the search box to jump to a specific country by name or code.
3. Read the **Assessment** column: **Normal** (P95 under 1200ms), **Elevated** (1200–2500ms), or **Severe** (2500ms and above).

<img src="https://mintcdn.com/mail2skyfreegmailcom/RbQ-QWSO7Z1yojdz/images/instance-performance-assessment-pill.png?fit=max&auto=format&n=RbQ-QWSO7Z1yojdz&q=85&s=d4b8e8702e5d356975369c171ce78ffd" alt="Close-up of a country row showing its P50/P95 latency values and the Normal/Elevated/Severe assessment pill" width="1138" height="101" data-path="images/instance-performance-assessment-pill.png" />

### Refresh the data

1. Click **Refresh** in the toolbar to pull the latest latency samples immediately, instead of waiting for the automatic 30-second refresh.

\[NEEDS VERIFICATION] The underlying latency samples reflect API request performance measured by the instance; the exact sampling window and data retention period are not shown in the UI.
