This Repo contains some scripts for monitoring an icecast server in zabbix.

This Repo has been downloaded from https://github.com/hairmare/zabbix-icecast

Dependencies

You will need to satisfy the following deps on the monitored System:

• xsltproc from libxslt
• wget

For Ubuntu do the following:

sudo apt-get install xsltproc wget

Installation

• Copy the scripts dir to /usr/local/scripts/zabbix and give executions right on icestats.sh to zabbix user Example: chown zabbix:zabbix icestats.sh; chmod u+x icestats.sh

• Change configuration in icestats.conf.example to suit your needs and rename the file to icestats.conf

• Add UserParameters from userparameters.txt to your zabbix_agentd.conf

• Restart zabbix agent

Configuration

You may import Template_App_Icecast.xml as a starting point. The Template contains monitoring for the streams this was written for.

You can use the following keys for monitoring.

• icecast.global.clients
• icecast.global.client_connections
• icecast.global.sources
• icecast.source.listeners[*]
• icecast.source.peak_listeners[*]
• icecast.source.slow_listeners[*]

In the icecast.source.* items the first parameter ($1) is the name of an icecast mountpoint

License

zabbix-icecast - a template for Zabbix to gather statistics for an icecast2 server

Copyright (C) 2010-2026 by the Contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Contributors

• Lucas Bickel Radio RaBe
• Marcel Hecko for SHMU FM
• Lukáš Viktora
• Julian Popp for funklust

Ideas

• Replace wget with curl and check HTTP response
• Itemization of stream endpoints
• Maybe transfer from XML to JSON stats