Icecast 2 Server Statistics




Overview

HTML interface, XSLT generated

Advanced machine readable data, XSLT generated

Available raw data

This section contains information about the raw server statistics data available inside icecast. An example stats XML tree will be shown and each element will be described. The following example stats tree will be used (it should not be considered complete nor authoritative):

<?xml version="1.0"?>	
<icestats>
	<admin>icemaster@example.org</admin>
	<client_connections>13</client_connections>
	<clients>2</clients>
	<connections>14</connections>
	<file_connections>1</file_connections>
	<host>stream.example.org</host>
	<listener_connections>7</listener_connections>
	<listeners>1</listeners>
	<location>Earth</location>
	<server_id>Icecast 2.4.0</server_id>
	<server_start>Tue, 01 Apr 2014 23:42:05 +0000</server_start>
	<source_client_connections>1</source_client_connections>
	<source_relay_connections>0</source_relay_connections>
	<source_total_connections>1</source_total_connections>
	<sources>1</sources>
	<stats>0</stats>
	<stats_connections>0</stats_connections>
	<source mount="/test.ogg">
		<artist>Test artist</artist>
		<audio_bitrate>32000</audio_bitrate>
		<audio_channels>2</audio_channels>
		<audio_info>samplerate=32000;channels=2;quality=-1;ice-channels=1</audio_info>
		<ice-bitrate>32</ice-bitrate>
		<listener_peak>2</listener_peak>
		<listeners>0</listeners>
		<listenurl>http://stream.example.org:8000/test.ogg</listenurl>
		<max_listeners>unlimited</max_listeners>
		<public>0</public>
		<quality>-1.00</quality>
		<samplerate>32000</samplerate>
		<server_description>A stream for testing ogg/vorbis.</server_description>
		<server_name>TestStream</server_name>
		<server_type>application/ogg</server_type>
		<slow_listeners>1</slow_listeners>
		<source_ip>203.0.113.42</source_ip>
		<stream_start>Wed, 02 Apr 2014 13:37:42 +0000</stream_start>
		<subtype>Vorbis</subtype>
		<title>Test title</title>
		<total_bytes_read>448632</total_bytes_read>
		<total_bytes_sent>207463</total_bytes_sent>
		<user_agent>IceS 2.0.1</user_agent>
	</source>
</icestats>

General Statistics

admin

As set in the server config, this should contain contact details for getting in touch with the server administrator. Usually this will be an email address, but as this can be an arbitrary string it could also be a phone number.

client-connections

Client connections are basically anything that is not a source connection. These include listeners (not concurrent, but cumulative), any admin function accesses, and any static content (file serving) accesses.

clients

connections

The total of all inbound TCP connections since start-up.

file_connections

host

As set in the server config,

listener_connections

listeners

location

As set in the server config,

server_id

Defaults to the version string of the currently running Icecast server. While not recommended it can be overriden in the server config.

server_start

source_client_connections

Source client connections are the number of times (cumulative since start-up, not just currently connected) a source client has connected to icecast.

source_relay_connections

source_total_connections

sources

The total of currently connected sources (mountpoints).

stats

The total of currently connected STATS clients.

stats_connections

Number of times (cumulative since start-up, not just currently connected) a stats client has connected to icecast.

Source-specific Statistics

artist

Artist of the current song (metadata set by source client).

title

Title of the current song (metadata set by source client).

audio_bitrate

(metadata set by source client).

audio_channels

(metadata set by source client).

audio-info

Information about the bitrate/samplerate/quality of the stream (metadata set by source client). Also used for YP entries.

ice-bitrate

samplerate

Information about the bitrate/samplerate/quality of the stream (metadata set by source client).

listener_peak

listeners

The number of currently connected listeners.

listenurl

max_listeners

public

Flag that indicates whether this mount is to be listed on a YP (set by source client, can be overriden by server config).

quality

(metadata set by source client).

samplerate

(metadata set by source client).

server_description

(metadata set by source client).

server_name

(metadata set by source client).

server_type

slow_listeners

source_ip

stream_start

subtype

total_bytes_read

total_bytes_sent

user_agent

HTTP user agent string as sent by the source client.


Additional data can be accessed through the admin interface, as every page of the admin interface has an XML equivalent.