# 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.* --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.curiostorage.org/configuration/metrics-reference.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.