getorphanmetrics

Back to blockchain

New since v30.2

Summary

Return stale block metrics over a rolling event window.

Description

Return stale block metrics over a rolling event window. Note: "orphan" here means stale blocks, not orphan transactions.

Change Buckets

• New since v30.2

Arguments

• window (NUM): Rolling window size in events (1-10000)

Results

• value (OBJ): No description.
• window_blocks (NUM): requested window size
• window_total (NUM): total events available within the window
• window_stale (NUM): stale block events within the window
• orphan_rate (NUM): window_stale/window_total (0 if window_total is 0)
• lifetime_blocks_connected (NUM): lifetime count of connected blocks observed
• lifetime_stale_blocks (NUM): lifetime count of stale blocks observed
• lifetime_reorgs (NUM): lifetime count of reorganizations observed
• deepest_reorg (NUM): maximum observed reorganization depth
• last_stale_height (NUM): height of most recent stale block, or -1 if none
• last_stale_time (NUM_TIME): timestamp of most recent stale block (unix epoch), or 0 if none
• persistent_stale_tip_count (NUM): count of non-active chain tips known in block index
• alert (BOOL): true if stale rate is above the alert threshold

Examples

qbit-cli getorphanmetrics

qbit-cli getorphanmetrics 500

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getorphanmetrics", "params": [500]}' -H 'content-type: application/json' http://127.0.0.1:8352/