Installation¶

Packages¶

Packages are available on packages.icinga.com.

Depending on your distribution and version you need to run one of the following commands:

Debian¶

apt update
apt -y install apt-transport-https wget

wget -O icinga-archive-keyring.deb "https://packages.icinga.com/icinga-archive-keyring_latest+debian$(
 . /etc/os-release; echo "$VERSION_ID"
).deb"

apt install ./icinga-archive-keyring.deb

DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \
 echo "deb [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/debian icinga-${DIST} main" > \
 /etc/apt/sources.list.d/${DIST}-icinga.list

apt-get update
apt-get install icingabeat

Ubuntu¶

apt update
apt -y install apt-transport-https wget

wget -O icinga-archive-keyring.deb "https://packages.icinga.com/icinga-archive-keyring_latest+ubuntu$(
 . /etc/os-release; echo "$VERSION_ID"
).deb"

apt install ./icinga-archive-keyring.deb

. /etc/os-release; if [ ! -z ${UBUNTU_CODENAME+x} ]; then DIST="${UBUNTU_CODENAME}"; else DIST="$(lsb_release -c| awk '{print $2}')"; fi; \
 echo "deb [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/ubuntu icinga-${DIST} main" > \
 /etc/apt/sources.list.d/${DIST}-icinga.list

apt-get update
apt-get install icingabeat

CentOS¶

yum install epel-release
rpm --import https://packages.icinga.com/icinga.key
yum install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm

yum install icingabeat

RHEL¶

yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
rpm --import https://packages.icinga.com/icinga.key
yum install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm

yum install icingabeat

SLES¶

rpm --import https://packages.icinga.com/icinga.key
zypper ar https://packages.icinga.com/SUSE/ICINGA-release.repo
zypper ref

zypper install icingabeat

Run¶

Make sure you have configured Icingabeat properly before starting it. Use one of the following commands to start Icingabeat:

service icingabeat start or
systemctl start icingabeat or
/etc/init.d/icingabeat start

Dashboards¶

We have dashboards prepared that you can use when getting started with Icingabeat. They are meant to give you some inspiration before you start exploring the data by yourself.

Starting with icingabeat v7.17.4 you have to download and import the dashboards manually.

Download and upack dashboards.zip from the latest release page.

Use Kibana’s Import functionality to upload the *.ndjson files which will import a bunch of saved objects, including dashboards and single visualizations.

Manual Installation¶

Download and install a package or tarball from the latest release page.

Development¶

Please follow README.md for instructions about how to build icingabeat.