Statistics: Overview
-
RavenDB reports runtime statistics and metrics for the server and for individual databases.
-
You can view this data in Studio, or retrieve it in JSON format from dedicated endpoints.
-
RavenDB can also be monitored via protocols like SNMP and OTLP (used by OpenTelemetry), as well as monitoring tools like Prometheus.
-
In this article:
Server statistics
You can view server statistics in Studio, or retrieve them from the dedicated endpoints listed below.
Server statistics via Studio
Find server statistics in the following Studio views:
- Cluster Dashboard: live per-node CPU, memory, traffic, indexing, and storage metrics.
- Cluster View: cluster-wide stats, including assigned and licensed cores, election term, and per-node state and memory.
- IO Stats: live charts of the server's disk writes, flushes, and syncs.
Metrics
Get server metrics using the {serverUrl}/admin/metrics endpoint.
A document containing the following metrics is retrieved:
- Requests
- RequestsPerSec
- ConcurrentRequestsCount
- AverageDuration
- Docs
- PutsPerSec
- BytesPutsPerSec
- Attachments
- PutsPerSec
- BytesPutsPerSec
- Counters
- PutsPerSec
- BytesPutsPerSec
- TimeSeries
- PutsPerSec
- BytesPutsPerSec
- MapIndexes
- IndexedPerSec
- MapReduceIndexes
- MappedPerSec
- ReducedPerSec
The rate fields (those ending in PerSec) are meters, each with the following format.
ConcurrentRequestsCount and AverageDuration are plain numeric values.
{
"Current": 0.0,
"Count": 131,
"MeanRate": 1.8,
"OneMinuteRate": 0.2,
"FiveMinuteRate": 0.4,
"FifteenMinuteRate": 0.1
}
Memory stats
Get server memory statistics using the {serverUrl}/admin/debug/memory/stats endpoint.
A document is retrieved with the server's overall memory usage, per-thread allocations, and memory-mapped files grouped by directory.
{
"@metadata": {
"DateTime": "2026-07-20T09:43:40.5522757Z",
"WebUrl": "http://127.0.0.1:8080",
"NodeTag": "A"
},
"MemoryInformation": {
"PhysicalMemory": "31.435 GBytes",
"WorkingSet": "571.27 MBytes",
"SharedClean": "188.93 MBytes",
"ManagedAllocations": "196.68 MBytes",
"ManagedHeapsAfterLastGC": {
"TotalSize": "245.96 MBytes",
"Gen0": { "Size": "157.88 MBytes", "Fragmentation": "125.79 MBytes" },
"Gen1": { "Size": "0 Bytes", "Fragmentation": "0 Bytes" },
"Gen2": { "Size": "0 Bytes", "Fragmentation": "0 Bytes" },
"LOH": { "Size": "87.43 MBytes", "Fragmentation": "19.38 MBytes" },
"POH": { "Size": "142.77 KBytes", "Fragmentation": "0 Bytes" }
},
"UnmanagedAllocations": "11.71 MBytes",
"LuceneManagedAllocationsForTermCache": "0 Bytes",
"LuceneUnmanagedAllocationsForTermCache": "0 Bytes",
"LuceneUnmanagedAllocationsForSorting": "0 Bytes",
"EncryptionBuffersInUse": "0 Bytes",
"EncryptionBuffersPool": "0 Bytes",
"EncryptionLockedMemory": "0 Bytes",
"MemoryMapped": "346.31 MBytes",
"IsHighDirty": false,
"DirtyMemory": "40 KBytes",
"AvailableMemory": "11.092 GBytes",
"AvailableMemoryForProcessing": "11.277 GBytes"
},
"Threads": [
{
"Name": ".NET TP Worker",
"Allocations": 5939200,
"HumaneAllocations": "5.66 MBytes",
"Ids": [
{ "Id": 27012, "ManagedThreadId": 33, "Allocations": 2531328, "HumaneAllocations": "2.41 MBytes" },
{ "Id": 30196, "ManagedThreadId": 81, "Allocations": 1196032, "HumaneAllocations": "1.14 MBytes" }
]
},
{
"Name": "Consensus Leader - A in term 5",
"Allocations": 458752,
"HumaneAllocations": "448 KBytes",
"Id": 25804,
"ManagedThreadId": 26
}
...
],
"Mappings": [
{
"Directory": "\\Databases\\sampleDB",
"TotalDirectorySize": 134217728,
"HumaneTotalDirectorySize": "128 MBytes",
"Details": {
"Raven.voron": {
"FileSize": 134217728,
"HumaneFileSize": "128 MBytes",
"TotalMapped": 134217728,
"HumaneTotalMapped": "128 MBytes",
"Mappings": [ { "Size": 134217728, "Count": 1 } ]
}
}
}
...
]
}
CPU stats
Get server CPU stats using the {serverUrl}/admin/debug/cpu/stats endpoint.
A document is retrieved with the process CPU times and the current thread-pool thread counts.
{
"@metadata": {
"DateTime": "2026-07-20T09:44:04.9416220Z",
"WebUrl": "http://127.0.0.1:8080",
"NodeTag": "A"
},
"CpuStats": [
{
"ProcessName": "Raven.Server",
"ProcessorAffinity": 16777215,
"PrivilegedProcessorTime": "00:00:02.2343750",
"TotalProcessorTime": "00:00:08.9531250",
"UserProcessorTime": "00:00:06.7187500"
}
],
"ThreadPoolStats": [
{
"AvailableThreadPoolWorkerThreads": 32765,
"AvailableThreadPoolCompletionPortThreads": 1000,
"MinThreadPoolWorkerThreads": 48,
"MinThreadPoolCompletionPortThreads": 2,
"MaxThreadPoolWorkerThreads": 32767,
"MaxThreadPoolCompletionPortThreads": 1000
}
]
}
Database statistics
You can view database statistics in Studio, or retrieve them from the dedicated endpoints listed below or via the client API.
Database statistics via Studio
Several Studio views show database statistics:
- Stats view: the counts of the database's documents and document extensions, per-node details like the database ID and the size on disk, and the indexing counters of each index.
- Database List View: general database stats, including size, document and index counts, and status.
- Indexing Performance: per-index statistics, including map and reduce attempts, success counts, and rates.
- Storage Report: the database's disk space usage, broken down by component.
- IO Stats: live charts of the database's disk writes, flushes, and syncs.
Database statistics via a dedicated endpoint
Get database statistics using the {serverUrl}/databases/{databaseName}/stats endpoint.
A document is retrieved with counts of the database's documents, indexes, and extensions, its per-index status, and its size on disk.
{
"@metadata": {
"DateTime": "2026-07-20T09:46:46.6064918Z",
"WebUrl": "http://127.0.0.1:8080",
"NodeTag": "A"
},
"CountOfIndexes": 7,
"CountOfDocuments": 1059,
"CountOfRevisionDocuments": 5475,
"CountOfTombstones": 0,
"CountOfDocumentsConflicts": 0,
"CountOfConflicts": 0,
"CountOfAttachments": 17,
"CountOfCounterEntries": 77,
"CountOfTimeSeriesSegments": 864,
"Indexes": [
{
"IsStale": false,
"State": "Normal",
"LastIndexingTime": "2026-07-20T09:42:03.7518904Z",
"Name": "Product/Rating",
"LockMode": "Unlock",
"Priority": "Normal",
"Type": "MapReduce",
"SourceType": "Counters"
},
{
"IsStale": false,
"State": "Normal",
"LastIndexingTime": "2026-07-20T09:42:03.6013188Z",
"Name": "Orders/ByCompany",
"LockMode": "Unlock",
"Priority": "Normal",
"Type": "MapReduce",
"SourceType": "Documents"
}
...
],
"CountOfUniqueAttachments": 17,
"DatabaseChangeVector": "A:8882-M/x0ucHwgEGGxAfWlnYPNw",
"DatabaseId": "M/x0ucHwgEGGxAfWlnYPNw",
"NumberOfTransactionMergerQueueOperations": 0,
"Is64Bit": true,
"Pager": "Voron.Platform.Win32.WindowsMemoryMapPager",
"LastDocEtag": 8878,
"LastDatabaseEtag": 8882,
"LastIndexingTime": "2026-07-20T09:42:03.8632713Z",
"SizeOnDisk": {
"HumaneSize": "285.94 MBytes",
"SizeInBytes": 299827200
},
"TempBuffersSizeOnDisk": {
"HumaneSize": "1.69 MBytes",
"SizeInBytes": 1769472
}
}
Database metrics
Get the database metrics using the {serverUrl}/databases/{databaseName}/metrics endpoint.
A document containing the following database metrics is retrieved:
- Requests
- RequestsPerSec
- ConcurrentRequestsCount
- AverageDuration
- Docs
- PutsPerSec
- BytesPutsPerSec
- Attachments
- PutsPerSec
- BytesPutsPerSec
- Counters
- PutsPerSec
- BytesPutsPerSec
- TimeSeries
- PutsPerSec
- BytesPutsPerSec
- MapIndexes
- IndexedPerSec
- MapReduceIndexes
- MappedPerSec
- ReducedPerSec
The rate fields (those ending in PerSec) are meters, each with the following format.
ConcurrentRequestsCount and AverageDuration are plain numeric values.
{
"Current": 0.0,
"Count": 32,
"MeanRate": 0.1,
"OneMinuteRate": 0.0,
"FiveMinuteRate": 0.1,
"FifteenMinuteRate": 0.0
}