Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 72 additions & 0 deletions docs/user/staking/ethereum/lsd-pools/lido/performance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Validator performance monitoring

The **Performance** tab allows you to monitor the performance of your Lido validators associated with your Node Operator.

## Understanding Lido CSM Reports

Before diving into the details, it's essential to understand what a **Lido CSM report** is. These reports contain performance data for all validators in the CSM and are distributed via IPFS hashes by the Lido team.

- On **Mainnet**, reports are distributed every **28 days**.
- On **Holesky**, reports are distributed every **7 days**.

## Lido Report Cards

At the top of the **Performance** tab, you'll find two key information cards:

![Performance cards](/img/lido-csm-performance-cards.png)

1. **Next Lido Report**: Displays the time remaining until the next report is distributed by the Lido CSM team.

2. **Pending Data**: As mentioned earlier, reports are distributed by the Lido team via IPFS. The Lido CSM package backend scans for these IPFS hashes and attempts to resolve their content to process the report data.

- This card shows the **number of reports left to be processed** by the backend. If `reports > 0`, the data in the table and chart below is not fully updated, and some reports are missing.
- The backend processes pending hashes **every 3 hours**. If `reports > 0` for an extended period, the IPFS gateway may not be able to find the remaining hashes.

:::tip
To resolve this issue, navigate to the **Config** tab of the Lido CSM package and change the `IPFS_URL` to another gateway that may successfully locate the hashes.
:::

## Range Selector

![Range Selector](/img/lido-csm-performance-range-selector.png)

The **Range Selector** controls all the data displayed in the Performance tab. It acts as a filter for the chart and table below.

### Available Ranges:

- **Last month**
- **Last year**
- **Ever** (From the first report that included a validator associated with your Node Operator)

:::info
On **Holesky**, an additional **week** range is available since reports are distributed weekly.
:::

## Node Operator Efficiency vs. Lido Average Efficiency

![Performance Chart](/img/lido-csm-performance-chart.png)

This chart compares the efficiency of your validators with the **Lido threshold** for the selected range.

- Includes a **slider** to adjust the number of frames displayed.

:::info
A frame represents the period between Lido CSM reports
:::

- Allows toggling validator visibility by clicking on the validator index in the legend next to the chart.

## Summary Table

![Performance Tbale](/img/lido-csm-performance-table.png)

This table provides an overview of the **attestations** assigned and included for each validator within the selected range.

### Efficiency Calculation:

- The **efficiency column** is based on your validator's **attestation rate**.
- If `attestation rate for selected range > Lido average threshold for selected range`, the efficiency is displayed in **green**. Otherwise, it appears in **red**.

:::caution
Even if efficiency is red, you may still receive rewards for the current report, and vice versa, since this data is based on past reports and can fluctuate significantly between frames.
:::
5 changes: 5 additions & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -175,6 +175,11 @@ const sidebars = {
label: "I am already a Node Operator",
id: "user/staking/ethereum/lsd-pools/lido/already-node-operator",
},
{
type: "doc",
label: "Validators performance",
id: "user/staking/ethereum/lsd-pools/lido/performance",
},
{
type: "doc",
label: "Notifications & Warnings",
Expand Down
Binary file added static/img/lido-csm-performance-cards.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/lido-csm-performance-chart.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/lido-csm-performance-table.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.