Component Installation

Nightingale requires MySQL and Redis as dependencies, both of which are open-source software. Please install them on your own. Here's a script to install these two components. You can refer to it:：

# install mysql
yum -y install mariadb*
systemctl enable mariadb
systemctl restart mariadb
mysql -e "SET PASSWORD FOR 'root'@'localhost' = PASSWORD('1234');"

# install redis
yum install -y redis
systemctl enable redis
systemctl restart redis

In the above example, the root password for MySQL is set to 1234. We recommend keeping this password unchanged to avoid the hassle of modifying the configuration file later.

Installing Nightingale

mkdir -p /opt/n9e && cd /opt/n9e

# Go to https://github.com/ccfos/nightingale/releases to find the latest version of the package. The package address in the document may not be the latest.
tarball=n9e-v6.0.0-beta.0-linux-amd64.tar.gz
urlpath=https://download.flashcat.cloud/${tarball}
wget $urlpath || exit 1

tar zxvf ${tarball}

mysql -uroot -p1234 < n9e.sql

nohup ./n9e &> n9e.log &

# check logs
# check port

If the startup is successful, Nightingale will listen on port 17000 by default. The above example uses nohup for a simple demonstration. For production environments, we recommend using systemd to manage it. Tutorial on using nohup and systemd

The configuration file etc/config.toml contains the MySQL connection address configuration. If the database connection fails, you can check the username and password.

After the Nightingale server is deployed, you can experience the related functions by visiting 17000 in your browser. The default username is root and the password is root.2020. Nightingale v6 supports three types of data sources: Prometheus-like, Elasticsearch, and Jaeger. You can click on the "System Information - Data Source" menu to configure the corresponding data source and view metrics, logging, and tracing data in the Nightingale platform.

Important Note

This is currently a beta version and is evolving rapidly. This version is only released for you to explore the related functions. Please do not directly upgrade v5 to v6. We will write an upgrade tool and notify everyone when it is stable. Also, please do not use the Pushgateway logic yet. We want to optimize this area further. You can start testing alarms and viewing graphics using v6 by integrating with existing data sources. However, the object list-related features cannot be tested for now.