Skip to main content

JuiceFS Metrics

tip

Please see the "Monitoring" documentation to learn how to collect and display JuiceFS monitoring metrics.

Global labels

NameDescription
vol_nameVolume name
mpMount point path
info

When Prometheus scrapes a target, it attaches instance label automatically to the scraped time series which serve to identify the scraped target, and its format is <host>:<port>. Refer to official document for more information.

info

If the monitoring metrics are reported through Prometheus Pushgateway (for example, JuiceFS Hadoop Java SDK), the value of the mp label is sdk-<PID>, and the value of the instance label is the host name.

File system

Metrics

NameDescriptionUnit
juicefs_used_spaceTotal used spacebyte
juicefs_used_inodesTotal number of inodes

Operating system

Metrics

NameDescriptionUnit
juicefs_uptimeTotal running timesecond
juicefs_cpu_usageAccumulated CPU usagesecond
juicefs_memoryUsed memorybyte

Metadata engine

Metrics

NameDescriptionUnit
juicefs_transaction_durations_histogram_secondsTransactions latency distributionssecond
juicefs_transaction_restartNumber of times a transaction restarted

FUSE

Metrics

NameDescriptionUnit
juicefs_fuse_read_size_bytesSize distributions of read requestbyte
juicefs_fuse_written_size_bytesSize distributions of write requestbyte
juicefs_fuse_ops_durations_histogram_secondsOperations latency distributionssecond
juicefs_fuse_open_handlersNumber of open files and directories

SDK

Metrics

NameDescriptionUnit
juicefs_sdk_read_size_bytesSize distributions of read requestbyte
juicefs_sdk_written_size_bytesSize distributions of write requestbyte
juicefs_sdk_ops_durations_histogram_secondsOperations latency distributionssecond

Cache

Metrics

NameDescriptionUnit
juicefs_blockcache_blocksNumber of cached blocks
juicefs_blockcache_bytesSize of cached blocksbyte
juicefs_blockcache_hitsCount of cached block hits
juicefs_blockcache_missCount of cached block miss
juicefs_blockcache_writesCount of cached block writes
juicefs_blockcache_dropsCount of cached block drops
juicefs_blockcache_evictsCount of cached block evicts
juicefs_blockcache_hit_bytesSize of cached block hitsbyte
juicefs_blockcache_miss_bytesSize of cached block missbyte
juicefs_blockcache_write_bytesSize of cached block writesbyte
juicefs_blockcache_read_hist_secondsLatency distributions of read cached blocksecond
juicefs_blockcache_write_hist_secondsLatency distributions of write cached blocksecond

Object storage

Labels

NameDescription
methodMethod to request object storage (e.g. GET, PUT, HEAD, DELETE)

Metrics

NameDescriptionUnit
juicefs_object_request_durations_histogram_secondsObject storage request latency distributionssecond
juicefs_object_request_errorsCount of failed requests to object storage
juicefs_object_request_data_bytesSize of requests to object storagebyte

Internal

Metrics

NameDescriptionUnit
juicefs_compact_size_histogram_bytesSize distributions of compacted databyte