> For the complete documentation index, see [llms.txt](https://docs.curiostorage.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.curiostorage.org/configuration/metrics-reference.md). # Metrics Reference This document lists Prometheus metrics exported by Curio using the exact metric names exposed on the scrape endpoint. > **Note**: This file is auto-generated from source code. Run `make docsgen-metrics` to update. ## Node Metrics | Metric | Type | Labels | Description | | ----------------- | ----- | ----------------- | --------------------------------------------------- | | `curio_node_info` | gauge | `node`, `version` | Curio node identity and version. Value is always 1. | ## Task Metrics (HarmonyTask) | Metric | Type | Labels | Description | | ----------------------------------------------- | --------- | --------------------- | ------------------------------------------------------------------------------------------------------ | | `curio_harmonytask_active_tasks` | gauge | `task_name` | Current number of active tasks. | | `curio_harmonytask_added_tasks` | counter | `task_name` | Total number of tasks added. | | `curio_harmonytask_cpu_usage` | gauge | — | Percentage of CPU in use. | | `curio_harmonytask_gpu_usage` | gauge | — | Percentage of GPU in use. | | `curio_harmonytask_poller_iterations` | counter | — | Total number of poller iterations. | | `curio_harmonytask_ram_usage` | gauge | — | Percentage of RAM in use. | | `curio_harmonytask_task_duration_seconds` | histogram | `task_name` | The histogram of task durations in seconds. | | `curio_harmonytask_task_scheduled_wait_seconds` | histogram | `task_name` | The histogram of task wait times from posting or previous attempt completion to work start in seconds. | | `curio_harmonytask_tasks_completed` | counter | `task_name` | Total number of tasks completed successfully. | | `curio_harmonytask_tasks_failed` | counter | `task_name` | Total number of tasks that failed. | | `curio_harmonytask_tasks_started` | counter | `task_name`, `source` | Total number of tasks started. | | `curio_harmonytask_uptime` | gauge | `version` | Total uptime of the node in seconds. | ## Wallet Exporter Metrics (Optional) | Metric | Type | Labels | Description | | -------------------------------------------- | --------- | -------------------------------------------------------------------------- | --------------------------------------------------- | | `curio_wallet_balance_nfil` | gauge | `address`, `type`, `name` | Balance in NanoFIL | | `curio_wallet_gas_paid_nfil` | counter | `from`, `from_name`, `to`, `to_name`, `method`, `send_reason`, `exit_code` | Gas paid NanoFIL | | `curio_wallet_gas_units_requested` | counter | `from`, `from_name`, `to`, `to_name`, `method`, `send_reason` | Gas units requested | | `curio_wallet_gas_units_used` | counter | `from`, `from_name`, `to`, `to_name`, `method`, `send_reason`, `exit_code` | Gas units used | | `curio_wallet_message_land_duration_seconds` | histogram | — | The histogram of message land durations in seconds. | | `curio_wallet_message_landed` | counter | `from`, `from_name`, `to`, `to_name`, `method`, `send_reason`, `exit_code` | Message landed | | `curio_wallet_message_sent` | counter | `from`, `from_name`, `to`, `to_name`, `method`, `send_reason` | Message sent | | `curio_wallet_power` | gauge | `address`, `type` | Power in Bytes | | `curio_wallet_sent_nfil` | counter | `from`, `from_name`, `to`, `to_name`, `method`, `send_reason`, `exit_code` | Sent NanoFIL | ## Proof Share Metrics | Metric | Type | Labels | Description | | -------------------------------------------------- | --------- | ------ | ------------------------------------------------------------ | | `curio_psvc_proofshare_adder_commits_total` | counter | — | Total number of successful task additions scheduled by Adder | | `curio_psvc_proofshare_adder_hold_decisions_total` | counter | `hold` | Total number of hold decisions made by Adder | | `curio_psvc_proofshare_create_asks_seconds` | histogram | — | Duration of create asks inner loop | | `curio_psvc_proofshare_duration_seconds` | histogram | `call` | Duration of proofshare client\_common operations | | `curio_psvc_proofshare_need_asks` | gauge | — | Number of asks still needed in current Do loop iteration | | `curio_psvc_proofshare_newly_added_total` | counter | — | Total number of new work requests inserted locally | | `curio_psvc_proofshare_queue_count` | gauge | — | Current proofshare request queue count | | `curio_psvc_proofshare_retry_count` | histogram | `call` | Retry count per call in proofshare client\_common operations | | `curio_psvc_proofshare_to_request_remaining` | gauge | — | Remaining requests to fulfill for high-water mark | ## Proof Service Metrics | Metric | Type | Labels | Description | | --------------------------------------- | --------- | ------ | ------------------------------------------------ | | `curio_psvc_clientctl_duration_seconds` | histogram | `call` | Duration of proofsvc clientctl operations | | `curio_psvc_l1ops_duration_seconds` | histogram | `call` | Duration of L1 operations | | `curio_psvc_provictl_duration_seconds` | histogram | `call` | Duration of proofsvc provider control operations | ## Sealing Metrics | Metric | Type | Labels | Description | | ---------------------------------------- | ------- | ------- | ---------------------------------- | | `curio_seal_commit_submitted_total` | counter | `miner` | Commit messages submitted. | | `curio_seal_finalize_completed_total` | counter | `miner` | Finalizations completed. | | `curio_seal_movestorage_completed_total` | counter | `miner` | Move storage operations completed. | | `curio_seal_porep_completed_total` | counter | `miner` | PoRep computations completed. | | `curio_seal_precommit_submitted_total` | counter | `miner` | Precommit messages submitted. | | `curio_seal_sdr_completed_total` | counter | `miner` | SDR computations completed. | | `curio_seal_synth_completed_total` | counter | `miner` | Synthetic proofs completed. | | `curio_seal_treed_completed_total` | counter | `miner` | Tree D computations completed. | | `curio_seal_treerc_completed_total` | counter | `miner` | Tree R/C computations completed. | ## Snap Pipeline Metrics | Metric | Type | Labels | Description | | ---------------------------------------- | ------- | ------- | --------------------------------------- | | `curio_snap_encode_completed_total` | counter | `miner` | Snap encodes completed. | | `curio_snap_movestorage_completed_total` | counter | `miner` | Snap move storage operations completed. | | `curio_snap_prove_completed_total` | counter | `miner` | Snap proves completed. | | `curio_snap_submit_completed_total` | counter | `miner` | Snap submissions completed. | ## Mining Metrics | Metric | Type | Labels | Description | | ------------------------------------- | --------- | ------- | --------------------------------------------------- | | `curio_mining_blocks_included_total` | counter | `miner` | Blocks included in the chain. | | `curio_mining_blocks_submitted_total` | counter | `miner` | Blocks submitted to the network. | | `curio_mining_compute_time_seconds` | histogram | — | Histogram of winning post compute times in seconds. | | `curio_mining_wins_total` | counter | `miner` | Blocks won (election success). | ## Storage Metrics | Metric | Type | Labels | Description | | ---------------------------------------------------------------- | --------- | --------------------------------- | ------------------------------------------------------ | | `curio_stor_available_bytes` | gauge | `id`, `can_seal`, `can_store` | Available storage capacity in bytes | | `curio_stor_capacity_bytes` | gauge | `id`, `can_seal`, `can_store` | Total storage capacity in bytes | | `curio_stor_find_sector_cache_hits` | counter | — | Number of findSectorCache hits | | `curio_stor_find_sector_cache_misses` | counter | — | Number of findSectorCache misses | | `curio_stor_find_sector_uncached` | counter | — | Number of findSector uncached calls | | `curio_stor_generate_single_vanilla_proof_calls` | counter | `update`, `cache_id`, `sealed_id` | Number of calls to GenerateSingleVanillaProof | | `curio_stor_generate_single_vanilla_proof_duration_milliseconds` | histogram | `update`, `cache_id`, `sealed_id` | Duration of GenerateSingleVanillaProof in milliseconds | | `curio_stor_generate_single_vanilla_proof_errors` | counter | `update`, `cache_id`, `sealed_id` | Number of errors in GenerateSingleVanillaProof | | `curio_stor_used_bytes` | gauge | `id`, `can_seal`, `can_store` | Used storage capacity in bytes | ## Cache Metrics | Metric | Type | Labels | Description | | ------------------------------------- | ------- | ---------------------- | -------------------------------------------------- | | `curio_cachedreader_cache_evictions` | counter | `cache_type`, `reason` | Number of cache evictions. | | `curio_cachedreader_cache_hits` | counter | `cache_type` | Number of cache hits. | | `curio_cachedreader_cache_misses` | counter | `cache_type` | Number of cache misses. | | `curio_cachedreader_cache_refs` | gauge | — | Number of active references to cached readers. | | `curio_cachedreader_cache_size` | gauge | `cache_type` | Current number of entries in cache. | | `curio_cachedreader_reader_errors` | counter | `reason` | Total number of piece reader errors. | | `curio_cachedreader_reader_successes` | counter | — | Total number of successful piece reader creations. | ## Network Metrics | Metric | Type | Labels | Description | | ----------------------------------- | ------- | ------ | -------------------------------------------------------- | | `curio_dealdata_data_read` | gauge | `kind` | Number of bytes read from data URLs | | `curio_robusthttp_active_transfers` | gauge | — | Current number of active robusthttp transfers | | `curio_robusthttp_bytes_read` | counter | — | Total bytes delivered by robusthttp readers | | `curio_robusthttp_read_errors` | counter | — | Total number of robusthttp read/request errors (non-EOF) | | `curio_robusthttp_read_failures` | counter | — | Number of robusthttp requests that failed after retries | | `curio_robusthttp_requests_started` | counter | — | Number of robusthttp logical requests started | | `curio_robusthttp_retries` | counter | — | Total number of robusthttp retries across requests | ## FFI Metrics | Metric | Type | Labels | Description | | ----------------------------- | ----- | ------- | ----------------------------- | | `curio_cuffi_snap_enc_active` | gauge | `phase` | Number of tasks in each phase | ## HTTP/Retrieval Metrics | Metric | Type | Labels | Description | | ------------------------------------------------- | --------- | ------------------------------- | ------------------------------------------------------------------------------------------------------ | | `curio_dagstore_pr_at_cache_fill_count` | counter | `network` | PieceReader ReadAt full cache fill count | | `curio_dagstore_pr_at_hit_bytes` | counter | `network` | PieceReader ReadAt bytes from cache | | `curio_dagstore_pr_at_hit_count` | counter | `network` | PieceReader ReadAt from cache hits | | `curio_dagstore_pr_at_read_bytes` | counter | `pr_size`, `network` | PieceReader ReadAt bytes read from source | | `curio_dagstore_pr_at_read_count` | counter | `pr_size`, `network` | PieceReader ReadAt reads from source | | `curio_dagstore_pr_discard_count` | counter | `network` | PieceReader discard count | | `curio_dagstore_pr_discarded_bytes` | counter | `network` | PieceReader discarded bytes | | `curio_dagstore_pr_init_count` | counter | `network` | PieceReader init count | | `curio_dagstore_pr_requested_bytes` | counter | `pr_type`, `network` | PieceReader requested bytes | | `curio_dagstore_pr_seek_back_bytes` | counter | `network` | PieceReader seek back bytes | | `curio_dagstore_pr_seek_back_count` | counter | `network` | PieceReader seek back count | | `curio_dagstore_pr_seek_forward_bytes` | counter | `network` | PieceReader seek forward bytes | | `curio_dagstore_pr_seek_forward_count` | counter | `network` | PieceReader seek forward count | | `curio_http_active_requests` | gauge | `path`, `method` | Number of active/in-flight HTTP requests | | `curio_http_blockstore_cache_hits` | counter | — | Counter of blockstore cache hits | | `curio_http_blockstore_cache_misses` | counter | — | Counter of blockstore cache misses | | `curio_http_piece_by_cid_200_response_count` | counter | — | Counter of /piece/ 200 responses | | `curio_http_piece_by_cid_400_response_count` | counter | — | Counter of /piece/ 400 responses | | `curio_http_piece_by_cid_404_response_count` | counter | — | Counter of /piece/ 404 responses | | `curio_http_piece_by_cid_500_response_count` | counter | — | Counter of /piece/ 500 responses | | `curio_http_piece_by_cid_request_count` | counter | — | Counter of /piece/ requests | | `curio_http_piece_by_cid_request_duration_ms` | histogram | — | Time spent retrieving a piece by cid | | `curio_http_rbls_bytes_sent_count` | counter | — | Counter of the number of bytes sent by bitswap since startup | | `curio_http_rbls_get_fail_response_count` | counter | — | Counter of failed RemoteBlockstore Get responses | | `curio_http_rbls_get_request_count` | counter | — | Counter of RemoteBlockstore Get requests | | `curio_http_rbls_get_success_response_count` | counter | — | Counter of successful RemoteBlockstore Get responses | | `curio_http_rbls_getsize_fail_response_count` | counter | — | Counter of failed RemoteBlockstore GetSize responses | | `curio_http_rbls_getsize_request_count` | counter | — | Counter of RemoteBlockstore GetSize requests | | `curio_http_rbls_getsize_success_response_count` | counter | — | Counter of successful RemoteBlockstore GetSize responses | | `curio_http_rbls_has_fail_response_count` | counter | — | Counter of failed RemoteBlockstore Has responses | | `curio_http_rbls_has_request_count` | counter | — | Counter of RemoteBlockstore Has requests | | `curio_http_rbls_has_success_response_count` | counter | — | Counter of successful RemoteBlockstore Has responses | | `curio_http_request_count` | counter | `path`, `method` | Counter of HTTP requests | | `curio_http_response_bytes_count` | counter | `status_code`, `path` | Sum of HTTP response content-length | | `curio_http_response_status_count` | counter | `status_code`, `path`, `method` | Counter of HTTP response status codes | | `curio_ipni_announce_attempts_total` | counter | `provider`, `result` | Total number of IPNI direct announce attempts. | | `curio_ipni_announce_http_roundtrip_milliseconds` | histogram | `provider`, `status` | Duration of outbound IPNI announce HTTP round trips in milliseconds. | | `curio_ipni_entry_cache_hit_wait_milliseconds` | histogram | `request`, `origin`, `state` | Duration callers wait after hitting the IPNI entry cache. | | `curio_ipni_entry_cache_hits_total` | counter | `request`, `origin`, `state` | Total number of IPNI entry cache hits by request type, cache origin, and readiness state. | | `curio_ipni_entry_cache_lookups_total` | counter | `request`, `result` | Total number of IPNI entry cache lookups. | | `curio_ipni_entry_reconstruction_milliseconds` | histogram | `request`, `source`, `result` | Duration of IPNI entry reconstruction after cache miss. | | `curio_ipni_entry_requests_total` | counter | `request` | Total number of IPNI entry requests handled by the serve chunker. | | `curio_ipni_entry_speculative_unused_total` | counter | — | Total number of speculative IPNI entry cache fills evicted without being consumed by a demand request. | | `curio_ipni_provider_http_request_milliseconds` | histogram | `provider`, `content`, `status` | Duration of inbound IPNI provider HTTP requests in milliseconds. | | `curio_ipni_provider_http_requests_total` | counter | `provider`, `content`, `status` | Total number of inbound IPNI provider HTTP requests. | | `curio_pdp_piece_by_cid_200_response_count` | counter | — | Counter of /piece/ 200 responses for PDP | | `curio_pdp_piece_by_cid_request_count` | counter | — | Counter of /piece/ requests for PDP | | `curio_pdp_piece_by_cid_request_duration_ms` | histogram | — | Time spent retrieving a piece by cid for PDP | | `curio_pdp_piece_bytes_served_count` | counter | — | Counter of the number of bytes served by PDP since startup | ## GC Metrics | Metric | Type | Labels | Description | | ------------------------------- | ------- | ------------------- | ---------------------- | | `curio_gc_sectors_marked_total` | counter | `miner`, `filetype` | Sectors marked for GC. | ## Batching Metrics | Metric | Type | Labels | Description | | ------------------------------------------ | ------- | ------------- | ------------------------------------------------------------ | | `curio_sealsupra_nvme_available_spare` | gauge | `nvme_device` | NVMe Available Spare | | `curio_sealsupra_nvme_bytes_read` | counter | `nvme_device` | NVMe Bytes Read | | `curio_sealsupra_nvme_bytes_written` | counter | `nvme_device` | NVMe Bytes Written | | `curio_sealsupra_nvme_critical_warning` | gauge | `nvme_device` | NVMe Critical Warning Flags | | `curio_sealsupra_nvme_error_log_entries` | gauge | `nvme_device` | NVMe Error Log Entries | | `curio_sealsupra_nvme_media_errors` | gauge | `nvme_device` | NVMe Media Errors | | `curio_sealsupra_nvme_percentage_used` | gauge | `nvme_device` | NVMe Percentage Used | | `curio_sealsupra_nvme_power_cycles` | gauge | `nvme_device` | NVMe Power Cycles | | `curio_sealsupra_nvme_power_on_hours` | gauge | `nvme_device` | NVMe Power On Hours | | `curio_sealsupra_nvme_read_io` | counter | `nvme_device` | NVMe Read IOs | | `curio_sealsupra_nvme_temperature_celsius` | gauge | `nvme_device` | NVMe Temperature in Celsius | | `curio_sealsupra_nvme_unsafe_shutdowns` | gauge | `nvme_device` | NVMe Unsafe Shutdowns | | `curio_sealsupra_nvme_write_io` | counter | `nvme_device` | NVMe Write IOs | | `curio_sealsupra_phase_avg_duration` | gauge | `phase` | Average duration of each phase in seconds | | `curio_sealsupra_phase_duration_so_far` | gauge | `phase` | Duration of the phase so far in seconds | | `curio_sealsupra_phase_lock_count` | gauge | `phase` | Number of active locks in each phase | | `curio_sealsupra_phase_waiting_count` | gauge | `phase` | Number of goroutines waiting for a phase lock | | `curio_slotmgr_slot_errors` | counter | — | Total number of slot errors (e.g., failed to put). | | `curio_slotmgr_slot_in_use` | gauge | `slot_offset` | Slot actively in use (batch sealing). 1=in use, 0=not in use | | `curio_slotmgr_slot_sector_count` | gauge | `slot_offset` | Number of sectors in the slot | | `curio_slotmgr_slots_acquired` | counter | — | Total number of slots acquired. | | `curio_slotmgr_slots_available` | gauge | — | Number of available slots. | | `curio_slotmgr_slots_released` | counter | — | Total number of slots released. | *** *Generated from source files. See* [*Prometheus Metrics*](/configuration/prometheus-metrics.md) *for setup instructions.*