Skip to main content

lucid perf

Periodically output performance metrics.

Usage

lucid perf [options]

Options

Option

Description

[--explain]

List and explain all available perf metrics.

[--seconds <seconds>]

Time interval in seconds at which to print the perf metrics. (default: 2)

[--no-timestamp]

Omit timestamps from the performance metrics output

[--default]

Show default list of metrics for each category.

[--extended]

Show extended list of metrics for each category.

[--all]

Show full list of all metrics for each selected category.

[--filter <groups>]

Show only metrics for the specified (comma separated) groups (see option descriptions for the available groups).

[--fail-on-error]

Fail on perf retrieval errors

[--time [<metrics>]]

Category `time`. Groups: time. Metrics: currentDateAndTimeUTC.

[--fs [<metrics>]]

Category `fs`. Groups: concurrency,iops,latency,notifications,size,throughput,total. Metrics: readBytes,writeBytes,reads,writes,opens,creates,dels,infos,moves,locks,other,ops,readFails,writeFails,openFails,createFails,delFails,infoFails,moveFails,lockFails,otherFails,opFails,readTime,writeTime,openTime,createTime,delTime,infoTime,moveTime,lockTime,otherTime,opTime,timedoutOps,readSize,writeSize,pendReads,pendWrites,pendOpens,pendCreates,pendDels,pendInfos,pendMoves,pendLocks,pendOther,pendOps,totalRead,totalWritten,notifActive,notifPending,notifProcessed,notifMetaPend,notifPathPend,notifPathDelPend,notifAttrPend,notifMeta,notifPath,notifPathDel,notifAttr.

[--encryptor [<metrics>]]

Category `encryptor`. Groups: concurrency,throughput,total. Metrics: encryptBytes,decryptBytes,prlEncrypts,prlDecrypts,decryptFails.

[--compressor [<metrics>]]

Category `compressor`. Groups: concurrency,ratio,throughput,time,total. Metrics: currentDateAndTimeUTC,comprRatio,comprReadBytes,uncomprReadBytes,comprWriteBytes,uncomprWritesBytes,prlDecompresses,prlCompresses,totalComprReadBytes,totalUncomprReadBytes,totalComprWriteBytes,totalUncomprWriteBytes.

[--prefetcher [<metrics>]]

Category `prefetcher`. Groups: concurrency,efficiency,iops,throughput. Metrics: %covered,%accurate,prefetchBytes,totalPrefetchBytes,prodBytes,totalProdBytes,prefetches,prodPrefetches,pend,pendMem,pendOverlap,streams,maxIos,totalPrefetches.

[--cache [<metrics>]]

Category `cache`. Groups: concurrency,efficiency,iops,latency,pinning,size,throughput,utilization. Metrics: %hits,readBytes,hitBytes,missBytes,prefetchBytes,writeBytes,bckWriteBytes,reads,hits,misses,prefetches,writes,bckWrites,maxBckWrites,failedBckWrites,invalidateReqs,invalidatedRanges,readTime,hitTime,missTime,prefetchTime,writeTime,bckWriteTime,readSize,writeSize,pendReads,pendPrefetches,pendWrites,pendBckWrites,pendStoreReads,pendStoreWrites,bckWritesLimit,pendInvalidates,dirtyBytes,cachedBytes,%,persistedInvalidates,pagesPinned,pagesUnpinned,failedPagePins.

[--memcache [<metrics>]]

Category `memcache`. Groups: concurrency,hitBytes,iops,throughput. Metrics: hitBytes,missBytes,prefetchBytes,missBlocks,missAfterLock,hitAfterLock,pMissAfterLock,pHitAfterLock,hitBlocks,prefetchBlocks,memPuts,pendPrefetches,pendPrefetchesFO.

[--logstore [<metrics>]]

Category `logstore`. Groups: concurrency,efficiency,iops,latency,throughput. Metrics: %hits,dataReadBytes,layoutReadBytes,totalWriteBytes,layoutWriteBytes,writes,dataReads,layoutHits,layoutMisses,schedWrites,activeWrites,pendComplWrites,getDataTime,WriteTime,writeActiveTime,writePendingTime.

[--objectstore [<metrics>]]

Category `objectstore`. Groups: concurrency,iops,latency,throughput,total. Metrics: getBytes,putBytes,listEntries,schedGets,schedPuts,schedDels,schedLists,activeGets,activePuts,activeDels,activeLists,totalGetBytes,totalPutBytes,totalListEntries,gets,puts,dels,lists,getFails,putFails,delFails,listFails,getCanceled,putCanceled,getTime,putTime,delTime,listTime.

[--keystore [<metrics>]]

Category `keystore`. Groups: iops,latency. Metrics: commits,aborts,puts,dels,getiters,finds,getIterTime,commitTime.

[--versionedKeystore [<metrics>]]

Category `versionedKeystore`. Groups: concurrency,iops,latency. Metrics: commits,flushes,getiters,commitTime,getIterTime,flushTime,pendFlush.

[--synchronizer [<metrics>]]

Category `synchronizer`. Groups: iops,latency,throughput. Metrics: localFetches,remoteFetches,localApplies,remoteApplies,localFetchedKeys,remoteFetchedKeys,localAppliedKeys,remoteAppliedKeys,localFetchTime,remoteFetchTime,localApplyTime,remoteApplyTime.

[--preloader [<metrics>]]

Category `preloader`. Groups: concurrency,iops,throughput,total. Metrics: bytesFetched,fetches,files,dirs,totalBytes,totalFiles,totalDirs,pendFetches,activePreloaders.

[--metastore [<metrics>]]

Category `metastore`. Groups: concurrency,efficiency,iops,latency. Metrics: fetches/misses,prefetches,fetchedRanges,prefetchedRanges,fetchedKeys,prefetchedKeys,fetchedRangesTime,prefetchedRangesTime,hits,pushes,pulls,pushedKeys,pulledKeys,pushTime,pullTime,localUpdates,remoteUpdates,localUpdateKeys,remoteUpdateKeys,evictedKeys,evictedRanges,dbSize,cachedNotifies,allNotifies,GCCollectedKeys,GCProcessedKeys,GCCommits,BrokenSyncIndexKeys,exitAppLiveKeys,exitAppDeletedKeys,exitAppPuts,exitAppDels,exitIntPuts,exitIntDels,commits,flushes,getIters,commitTime,getIterTime,flushTime,pendFlush.

[--explain]

Description

List and explain all available perf metrics.

[--seconds <seconds>]

Description

Time interval in seconds at which to print the perf metrics. (default: 2)

[--no-timestamp]

Description

Omit timestamps from the performance metrics output

[--default]

Description

Show default list of metrics for each category.

[--extended]

Description

Show extended list of metrics for each category.

[--all]

Description

Show full list of all metrics for each selected category.

[--filter <groups>]

Description

Show only metrics for the specified (comma separated) groups (see option descriptions for the available groups).

[--fail-on-error]

Description

Fail on perf retrieval errors

[--time [<metrics>]]

Description

Category `time`. Groups: time. Metrics: currentDateAndTimeUTC.

[--fs [<metrics>]]

Description

Category `fs`. Groups: concurrency,iops,latency,notifications,size,throughput,total. Metrics: readBytes,writeBytes,reads,writes,opens,creates,dels,infos,moves,locks,other,ops,readFails,writeFails,openFails,createFails,delFails,infoFails,moveFails,lockFails,otherFails,opFails,readTime,writeTime,openTime,createTime,delTime,infoTime,moveTime,lockTime,otherTime,opTime,timedoutOps,readSize,writeSize,pendReads,pendWrites,pendOpens,pendCreates,pendDels,pendInfos,pendMoves,pendLocks,pendOther,pendOps,totalRead,totalWritten,notifActive,notifPending,notifProcessed,notifMetaPend,notifPathPend,notifPathDelPend,notifAttrPend,notifMeta,notifPath,notifPathDel,notifAttr.

[--encryptor [<metrics>]]

Description

Category `encryptor`. Groups: concurrency,throughput,total. Metrics: encryptBytes,decryptBytes,prlEncrypts,prlDecrypts,decryptFails.

[--compressor [<metrics>]]

Description

Category `compressor`. Groups: concurrency,ratio,throughput,time,total. Metrics: currentDateAndTimeUTC,comprRatio,comprReadBytes,uncomprReadBytes,comprWriteBytes,uncomprWritesBytes,prlDecompresses,prlCompresses,totalComprReadBytes,totalUncomprReadBytes,totalComprWriteBytes,totalUncomprWriteBytes.

[--prefetcher [<metrics>]]

Description

Category `prefetcher`. Groups: concurrency,efficiency,iops,throughput. Metrics: %covered,%accurate,prefetchBytes,totalPrefetchBytes,prodBytes,totalProdBytes,prefetches,prodPrefetches,pend,pendMem,pendOverlap,streams,maxIos,totalPrefetches.

[--cache [<metrics>]]

Description

Category `cache`. Groups: concurrency,efficiency,iops,latency,pinning,size,throughput,utilization. Metrics: %hits,readBytes,hitBytes,missBytes,prefetchBytes,writeBytes,bckWriteBytes,reads,hits,misses,prefetches,writes,bckWrites,maxBckWrites,failedBckWrites,invalidateReqs,invalidatedRanges,readTime,hitTime,missTime,prefetchTime,writeTime,bckWriteTime,readSize,writeSize,pendReads,pendPrefetches,pendWrites,pendBckWrites,pendStoreReads,pendStoreWrites,bckWritesLimit,pendInvalidates,dirtyBytes,cachedBytes,%,persistedInvalidates,pagesPinned,pagesUnpinned,failedPagePins.

[--memcache [<metrics>]]

Description

Category `memcache`. Groups: concurrency,hitBytes,iops,throughput. Metrics: hitBytes,missBytes,prefetchBytes,missBlocks,missAfterLock,hitAfterLock,pMissAfterLock,pHitAfterLock,hitBlocks,prefetchBlocks,memPuts,pendPrefetches,pendPrefetchesFO.

[--logstore [<metrics>]]

Description

Category `logstore`. Groups: concurrency,efficiency,iops,latency,throughput. Metrics: %hits,dataReadBytes,layoutReadBytes,totalWriteBytes,layoutWriteBytes,writes,dataReads,layoutHits,layoutMisses,schedWrites,activeWrites,pendComplWrites,getDataTime,WriteTime,writeActiveTime,writePendingTime.

[--objectstore [<metrics>]]

Description

Category `objectstore`. Groups: concurrency,iops,latency,throughput,total. Metrics: getBytes,putBytes,listEntries,schedGets,schedPuts,schedDels,schedLists,activeGets,activePuts,activeDels,activeLists,totalGetBytes,totalPutBytes,totalListEntries,gets,puts,dels,lists,getFails,putFails,delFails,listFails,getCanceled,putCanceled,getTime,putTime,delTime,listTime.

[--keystore [<metrics>]]

Description

Category `keystore`. Groups: iops,latency. Metrics: commits,aborts,puts,dels,getiters,finds,getIterTime,commitTime.

[--versionedKeystore [<metrics>]]

Description

Category `versionedKeystore`. Groups: concurrency,iops,latency. Metrics: commits,flushes,getiters,commitTime,getIterTime,flushTime,pendFlush.

[--synchronizer [<metrics>]]

Description

Category `synchronizer`. Groups: iops,latency,throughput. Metrics: localFetches,remoteFetches,localApplies,remoteApplies,localFetchedKeys,remoteFetchedKeys,localAppliedKeys,remoteAppliedKeys,localFetchTime,remoteFetchTime,localApplyTime,remoteApplyTime.

[--preloader [<metrics>]]

Description

Category `preloader`. Groups: concurrency,iops,throughput,total. Metrics: bytesFetched,fetches,files,dirs,totalBytes,totalFiles,totalDirs,pendFetches,activePreloaders.

[--metastore [<metrics>]]

Description

Category `metastore`. Groups: concurrency,efficiency,iops,latency. Metrics: fetches/misses,prefetches,fetchedRanges,prefetchedRanges,fetchedKeys,prefetchedKeys,fetchedRangesTime,prefetchedRangesTime,hits,pushes,pulls,pushedKeys,pulledKeys,pushTime,pullTime,localUpdates,remoteUpdates,localUpdateKeys,remoteUpdateKeys,evictedKeys,evictedRanges,dbSize,cachedNotifies,allNotifies,GCCollectedKeys,GCProcessedKeys,GCCommits,BrokenSyncIndexKeys,exitAppLiveKeys,exitAppDeletedKeys,exitAppPuts,exitAppDels,exitIntPuts,exitIntDels,commits,flushes,getIters,commitTime,getIterTime,flushTime,pendFlush.

This command also accepts the global options, passed before the command name.