Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

resolv: buffer until blockhash known #4000

Merged
merged 1 commit into from
Jan 24, 2025
Merged

resolv: buffer until blockhash known #4000

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
5 changes: 4 additions & 1 deletion book/api/metrics-generated.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -141,14 +141,17 @@
| Metric | Type | Description |
|--------|------|-------------|
| resolv_​no_​bank_​drop | `counter` | Count of transactions dropped because the bank was not available |
| resolv_​stash_​operation_​inserted | `counter` | Count of operations that happened on the transaction stash (A transaction with an unknown blockhash was added to the stash) |
| resolv_​stash_​operation_​overrun | `counter` | Count of operations that happened on the transaction stash (A transaction with an unknown blockhash was dropped because the stash was full) |
| resolv_​stash_​operation_​published | `counter` | Count of operations that happened on the transaction stash (A transaction with an unknown blockhash was published as the blockhash became known) |
| resolv_​stash_​operation_​removed | `counter` | Count of operations that happened on the transaction stash (A transaction with an unknown blockhash was removed from the stash without publishing, due to a bad LUT resolved failure, or no bank. These errors are double counted with the respective metrics for those categories.) |
| resolv_​lut_​resolved_​invalid_​lookup_​index | `counter` | Count of address lookup tables resolved (The transaction referenced an index in a LUT that didn't exist) |
| resolv_​lut_​resolved_​account_​uninitialized | `counter` | Count of address lookup tables resolved (The account referenced as a LUT hasn't been initialized) |
| resolv_​lut_​resolved_​invalid_​account_​data | `counter` | Count of address lookup tables resolved (The account referenced as a LUT couldn't be parsed) |
| resolv_​lut_​resolved_​invalid_​account_​owner | `counter` | Count of address lookup tables resolved (The account referenced as a LUT wasn't owned by the ALUT program ID) |
| resolv_​lut_​resolved_​account_​not_​found | `counter` | Count of address lookup tables resolved (The account referenced as a LUT couldn't be found) |
| resolv_​lut_​resolved_​success | `counter` | Count of address lookup tables resolved (Resolved successfully) |
| resolv_​blockhash_​expired | `counter` | Count of transactions that failed to resolve because the blockhash was expired |
| resolv_​blockhash_​unknown | `counter` | Count of transactions with an unknown blockhash. These may be very recent, very old, nonces, or bogus. |

## Pack Tile
| Metric | Type | Description |
Expand Down
38 changes: 27 additions & 11 deletions book/api/websocket.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -484,7 +484,8 @@ tranasactions per second.
"next_leader_slot": 285228774,
"waterfall": {
"in": {
"retained": 2014,
"pack_retained": 2011,
"resolv_retained": 13,
"quic": 66767,
"udp": 1054,
"gossip": 517
Expand All @@ -501,7 +502,12 @@ tranasactions per second.
"verify_failed": 4092,
"verify_duplicate": 128,
"dedup_duplicate": 87,
"pack_invalid": 12,
"resolv_lut_failed": 4,
"resolv_expired": 0,
"resolv_ancient": 2,
"resolv_no_ledger": 0,
"resolv_retained": 0,
"pack_invalid": 6,
"pack_expired": 2,
"pack_retained": 1985,
"pack_overrun": 54,
Expand Down Expand Up @@ -973,7 +979,8 @@ are skipped on the currently active fork.
},
"waterfall": {
"in": {
"retained": 0,
"pack_retained": 0,
"resolv_retained": 0,
"quic": 28159,
"udp": 14323,
"gossip": 4659
Expand All @@ -990,7 +997,11 @@ are skipped on the currently active fork.
"verify_failed": 0,
"verify_duplicate": 114,
"dedup_duplicate": 19384,
"resolv_failed": 3,
"resolv_lut_failed": 3,
"resolv_expired": 0,
"resolv_ancient": 0,
"resolv_retained": 0,
"resolv_no_ledger": 0,
"pack_invalid": 0,
"pack_expired": 0,
"pack_retained": 2225,
Expand Down Expand Up @@ -1077,12 +1088,13 @@ are skipped on the currently active fork.
| out | `TxnWaterfallOut` | Transactions sent out of the waterfall |

**`TxnWaterfallIn`**
| Field | Type | Description |
|----------|----------|-------------|
| retained | `number` | Transactions were received during or prior to an earlier leader slot, but weren't executed and were retained inside the validator to potentially be included in a later slot |
| quic | `number` | A QUIC transaction was received. The stream does not have to successfully complete |
| udp | `number` | A non-QUIC UDP transaction was received |
| gossip | `number` | A gossipped vote transaction was received from a gossip peer |
| Field | Type | Description |
|-----------------|----------|-------------|
| pack_retained | `number` | Transactions were received during or prior to an earlier leader slot, but weren't executed because they weren't a high enough priority, and were retained inside the validator to potentially be included in a later slot |
| resolv_retained | `number` | Transactions were received during or prior to an earlier leader slot, but weren't executed because we did not know the blockhash they referenced. They were instead kept in a holding area in case we learn the blockhash later |
| quic | `number` | A QUIC transaction was received. The stream does not have to successfully complete |
| udp | `number` | A non-QUIC UDP transaction was received |
| gossip | `number` | A gossipped vote transaction was received from a gossip peer |

**`TxnWaterfallOut`**
| Field | Type | Description |
Expand All @@ -1098,7 +1110,11 @@ are skipped on the currently active fork.
| verify_failed | `number` | Transactions were dropped because signature verification failed |
| verify_duplicate | `number` | Transactions were dropped because the verify tiles determined that they had already been processed |
| dedup_duplicate | `number` | Transactions were dropped because the dedup tile determined that they had already been processed |
| resolv_failed | `number` | Transactions were dropped because they contained invalid address lookup tables (LUTs) |
| resolv_retained | `number` | Transactions were retained inside the validator memory because they referenced a blockhash we do not yet know. We might include the transactions in a future block, if we learn about the blockhash they reference |
| resolv_lut_failed | `number` | Transactions were dropped because they contained invalid address lookup tables (LUTs) |
| resolv_expired | `number` | Transactions were dropped because they contained a transaction that was already expired |
| resolv_no_ledger | `number` | Transactions were dropped because they contained a LUT but we didn't yet have a ledger to look them up in |
| resolv_ancient | `number` | Transactions were dropped because they referenced a blockhash we didn't recognize, and while waiting to see if the blockhash would arrive, the buffer became full |
| pack_invalid | `number` | Transactions were dropped because pack determined they would never execute. Reasons can include the transaction requested too many compute units, or was too large to fit in a block |
| pack_expired | `number` | Transactions were dropped because pack determined that their TTL expired |
| pack_retained | `number` | Transactions were retained inside the validator memory because they were not high enough priority to make it into a prior block we produced, but have not yet expired. We might include the transactions in a future block |
Expand Down
Loading
Loading