Skip to main content
Version: v2.10.2 (current)

Interface: NodeStats

Lavalink periodically sends detailed statistics about the node's performance and resource usage.
These stats are crucial for monitoring system load, audio frame issues, and overall node health.


NodeStats

Main structure containing node-wide statistics.

Property Type Description Optional
playersnumberNumber of connected players (active + idle).
playingPlayersnumberNumber of currently playing players.
uptimenumberNode uptime in milliseconds.
memoryMemoryStatsMemory usage statistics.
cpuCPUStatsCPU usage statistics.
frameStatsFrameStats | nullFrame loss and timing information (may be null if disabled).

MemoryStats

Breakdown of the node’s memory usage.

Property Type Description Optional
freenumberAmount of free memory (in bytes).
usednumberAmount of used memory (in bytes).
allocatednumberTotal memory allocated to the Lavalink process (in bytes).
reservablenumberMaximum memory that can be allocated (in bytes).

CPUStats

Stats related to CPU usage on the node.

Property Type Description Optional
coresnumberNumber of logical CPU cores available.
systemLoadnumberTotal system CPU load (0.0 to 1.0).
lavalinkLoadnumberLoad attributed specifically to the Lavalink process.

FrameStats

Audio frame performance and quality metrics.

Property Type Description Optional
sentnumberNumber of audio frames sent.
nullednumberNumber of audio frames that were replaced with silence.
deficitnumberNumber of audio frames that were lost or late.