Metrics Reference

This document lists all Prometheus metrics exported by Curio. All metrics use the curio_ namespace prefix.

Note: This file is auto-generated from source code. Run make docsgen-metrics to update.

Task Metrics (HarmonyTask)

Metric	Type	Description
curio_harmonytask_active_tasks	gauge/counter	Current number of active tasks.
curio_harmonytask_added_tasks	gauge/counter	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	gauge/counter	Total number of poller iterations.
curio_harmonytask_ram_usage	gauge	Percentage of RAM in use.
curio_harmonytask_task_duration_seconds	histogram	The histogram of task durations in seconds.
curio_harmonytask_tasks_completed	gauge/counter	Total number of tasks completed successfully.
curio_harmonytask_tasks_failed	gauge/counter	Total number of tasks that failed.
curio_harmonytask_tasks_started	gauge/counter	Total number of tasks started.
curio_harmonytask_uptime	gauge/counter	Total uptime of the node in seconds.

Wallet Exporter Metrics (Optional)

Metric	Type	Description
curio_wallet_balance_nfil	gauge/counter	Balance in NanoFIL
curio_wallet_gas_paid_nfil	gauge/counter	Gas paid NanoFIL
curio_wallet_gas_units_requested	gauge/counter	Gas units requested
curio_wallet_gas_units_used	gauge/counter	Gas units used
curio_wallet_message_land_duration_seconds	histogram	The histogram of message land durations in seconds.
curio_wallet_message_landed	gauge/counter	Message landed
curio_wallet_message_sent	gauge/counter	Message sent
curio_wallet_power	gauge/counter	Power in Bytes
curio_wallet_sent_nfil	gauge/counter	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	countervec	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	histogramvec	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	histogramvec	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	histogramvec	call	Duration of proofsvc clientctl operations
curio_psvc_l1ops_duration_seconds	histogramvec	call	Duration of L1 operations
curio_psvc_provictl_duration_seconds	histogramvec	call	Duration of proofsvc provider control operations

Sealing Metrics

Metric	Type	Description
curio_seal_commit_submitted_total	gauge/counter	Commit messages submitted.
curio_seal_finalize_completed_total	gauge/counter	Finalizations completed.
curio_seal_movestorage_completed_total	gauge/counter	Move storage operations completed.
curio_seal_porep_completed_total	gauge/counter	PoRep computations completed.
curio_seal_precommit_submitted_total	gauge/counter	Precommit messages submitted.
curio_seal_sdr_completed_total	gauge/counter	SDR computations completed.
curio_seal_synth_completed_total	gauge/counter	Synthetic proofs completed.
curio_seal_treed_completed_total	gauge/counter	Tree D computations completed.
curio_seal_treerc_completed_total	gauge/counter	Tree R/C computations completed.
curio_sealsupra_nvme_available_spare	gauge/counter	NVMe Available Spare
curio_sealsupra_nvme_bytes_read	gauge/counter	NVMe Bytes Read
curio_sealsupra_nvme_bytes_written	gauge/counter	NVMe Bytes Written
curio_sealsupra_nvme_critical_warning	gauge/counter	NVMe Critical Warning Flags
curio_sealsupra_nvme_error_log_entries	gauge/counter	NVMe Error Log Entries
curio_sealsupra_nvme_media_errors	gauge/counter	NVMe Media Errors
curio_sealsupra_nvme_percentage_used	gauge/counter	NVMe Percentage Used
curio_sealsupra_nvme_power_cycles	gauge/counter	NVMe Power Cycles
curio_sealsupra_nvme_power_on_hours	gauge	NVMe Power On Hours
curio_sealsupra_nvme_read_io	gauge/counter	NVMe Read IOs
curio_sealsupra_nvme_temperature_celsius	gauge	NVMe Temperature in Celsius
curio_sealsupra_nvme_unsafe_shutdowns	gauge/counter	NVMe Unsafe Shutdowns
curio_sealsupra_nvme_write_io	gauge/counter	NVMe Write IOs
curio_sealsupra_phase_avg_duration	gauge	Average duration of each phase in seconds
curio_sealsupra_phase_duration_so_far	gauge	Duration of the phase so far in seconds
curio_sealsupra_phase_lock_count	gauge/counter	Number of active locks in each phase
curio_sealsupra_phase_waiting_count	gauge/counter	Number of goroutines waiting for a phase lock

Snap Pipeline Metrics

Metric	Type	Description
curio_snap_encode_completed_total	gauge/counter	Snap encodes completed.
curio_snap_movestorage_completed_total	gauge/counter	Snap move storage operations completed.
curio_snap_prove_completed_total	gauge/counter	Snap proves completed.
curio_snap_submit_completed_total	gauge/counter	Snap submissions completed.

Mining Metrics

Metric	Type	Description
curio_mining_blocks_included_total	gauge/counter	Blocks included in the chain.
curio_mining_blocks_submitted_total	gauge/counter	Blocks submitted to the network.
curio_mining_compute_time_seconds	histogram	Histogram of winning post compute times in seconds.
curio_mining_wins_total	gauge/counter	Blocks won (election success).

Storage Metrics

Metric	Type	Description
curio_slotmgr_slot_errors	gauge/counter	Total number of slot errors (e.g., failed to put).
curio_slotmgr_slot_in_use	gauge/counter	Slot actively in use (batch sealing). 1=in use, 0=not in use
curio_slotmgr_slot_sector_count	gauge/counter	Number of sectors in the slot
curio_slotmgr_slots_acquired	gauge/counter	Total number of slots acquired.
curio_slotmgr_slots_available	gauge/counter	Number of available slots.
curio_slotmgr_slots_released	gauge/counter	Total number of slots released.
curio_stor_available_bytes	gauge/counter	Available storage capacity in bytes
curio_stor_capacity_bytes	gauge/counter	Total storage capacity in bytes
curio_stor_find_sector_cache_hits	gauge/counter	Number of findSectorCache hits
curio_stor_find_sector_cache_misses	gauge/counter	Number of findSectorCache misses
curio_stor_find_sector_uncached	gauge/counter	Number of findSector uncached calls
curio_stor_generate_single_vanilla_proof_calls	gauge/counter	Number of calls to GenerateSingleVanillaProof
curio_stor_generate_single_vanilla_proof_duration_seconds	gauge/counter	Duration of GenerateSingleVanillaProof in seconds
curio_stor_generate_single_vanilla_proof_errors	gauge/counter	Number of errors in GenerateSingleVanillaProof
curio_stor_used_bytes	gauge/counter	Used storage capacity in bytes

Cache Metrics

Metric	Type	Description
curio_cachedreader_cache_evictions	gauge/counter	Number of cache evictions.
curio_cachedreader_cache_hits	gauge/counter	Number of cache hits.
curio_cachedreader_cache_misses	gauge/counter	Number of cache misses.
curio_cachedreader_cache_refs	gauge/counter	Number of active references to cached readers.
curio_cachedreader_cache_size	gauge/counter	Current number of entries in cache.
curio_cachedreader_reader_errors	gauge/counter	Total number of piece reader errors.
curio_cachedreader_reader_successes	gauge/counter	Total number of successful piece reader creations.

Network Metrics

Metric	Type	Description
curio_dealdata_data_read	gauge/counter	Number of bytes read from data URLs
curio_robusthttp_active_transfers	gauge/counter	Current number of active robusthttp transfers
curio_robusthttp_bytes_read	gauge/counter	Total bytes delivered by robusthttp readers
curio_robusthttp_read_errors	gauge/counter	Total number of robusthttp read/request errors (non-EOF)
curio_robusthttp_read_failures	gauge/counter	Number of robusthttp requests that failed after retries
curio_robusthttp_requests_started	gauge/counter	Number of robusthttp logical requests started
curio_robusthttp_retries	gauge/counter	Total number of robusthttp retries across requests

FFI Metrics

Metric	Type	Description
curio_cuffi_snap_enc_active	gauge/counter	Number of tasks in each phase

HTTP/Retrieval Metrics

Metric	Type	Description
curio_http/active_requests	gauge/counter	Number of active/in-flight HTTP requests
curio_http/blockstore_cache_hits	gauge/counter	Counter of blockstore cache hits
curio_http/blockstore_cache_misses	gauge/counter	Counter of blockstore cache misses
curio_http/piece_by_cid_200_response_count	gauge/counter	Counter of /piece/ 200 responses
curio_http/piece_by_cid_400_response_count	gauge/counter	Counter of /piece/ 400 responses
curio_http/piece_by_cid_404_response_count	gauge/counter	Counter of /piece/ 404 responses
curio_http/piece_by_cid_500_response_count	gauge/counter	Counter of /piece/ 500 responses
curio_http/piece_by_cid_request_count	gauge/counter	Counter of /piece/ requests
curio_http/piece_by_cid_request_duration_ms	gauge	Time spent retrieving a piece by cid
curio_http/rbls_bytes_sent_count	gauge/counter	Counter of the number of bytes sent by bitswap since startup
curio_http/rbls_get_fail_response_count	gauge/counter	Counter of failed RemoteBlockstore Get responses
curio_http/rbls_get_request_count	gauge/counter	Counter of RemoteBlockstore Get requests
curio_http/rbls_get_success_response_count	gauge/counter	Counter of successful RemoteBlockstore Get responses
curio_http/rbls_getsize_fail_response_count	gauge/counter	Counter of failed RemoteBlockstore GetSize responses
curio_http/rbls_getsize_request_count	gauge/counter	Counter of RemoteBlockstore GetSize requests
curio_http/rbls_getsize_success_response_count	gauge/counter	Counter of successful RemoteBlockstore GetSize responses
curio_http/rbls_has_fail_response_count	gauge/counter	Counter of failed RemoteBlockstore Has responses
curio_http/rbls_has_request_count	gauge/counter	Counter of RemoteBlockstore Has requests
curio_http/rbls_has_success_response_count	gauge/counter	Counter of successful RemoteBlockstore Has responses
curio_http/request_count	gauge/counter	Counter of HTTP requests
curio_http/response_bytes_count	gauge/counter	Sum of HTTP response content-length
curio_http/response_status_count	gauge/counter	Counter of HTTP response status codes
curio_pdp/piece_by_cid_200_response_count	gauge/counter	Counter of /piece/ 200 responses for PDP
curio_pdp/piece_by_cid_request_count	gauge/counter	Counter of /piece/ requests for PDP
curio_pdp/piece_by_cid_request_duration_ms	gauge	Time spent retrieving a piece by cid for PDP
curio_pdp/piece_bytes_served_count	gauge/counter	Counter of the number of bytes served by PDP since startup
curio_retrieval_info	gauge/counter	Arbitrary counter to tag node info to

GC Metrics

Metric	Type	Description
curio_gc_sectors_marked_total	gauge/counter	Sectors marked for GC.

---

Generated from source files. See Prometheus Metrics for setup instructions.