Skip to content

Latest commit

 

History

History
143 lines (88 loc) · 3.73 KB

guide_statping.rst

File metadata and controls

143 lines (88 loc) · 3.73 KB
Raw
.. author:: Moanos <https://hyteck.de/about/>

.. tag:: monitoring
.. tag:: web
.. tag:: self-hosting
.. tag:: prometheus
.. tag:: lang-go
.. tag:: audience-admins

Logo

_static/images/statping.png

Statping

.. tag_list::

Statping-ng is an updated drop-in for statping. It is a lightweight and easy to install monitoring tool written in Go. It is published under the GNU General Public License v3.0.

Note

For this guide you should be familiar with the basic concepts of

Prerequisites

Create a directory for the configuration.

[isabell@stardust ~]$ mkdir ~/statping

Create a database

[isabell@stardust ~]$ mysql -e "CREATE DATABASE ${USER}_statping"

Installation

Now let's get started with installing Statping-ng.

Start with cloning the Statping-ng binaries from Github and be sure to replace the version v0.90.80 with the current release number!:

[isabell@stardust ~]$ cd statping
[isabell@stardust statping]$ curl -sL https://github.com/statping-ng/statping-ng/releases/download/v0.90.80/statping-linux-amd64.tar.gz | tar xz
[isabell@stardust statping]$ ls
statping

Setup daemon

Create ~/etc/services.d/statping.ini with the following content:

[program:statping]
directory=%(ENV_HOME)s/statping/
command=%(ENV_HOME)s/statping/statping
autostart=yes
autorestart=yes

Configure web server

Note

Statping-ng is running on port 8080.

Configuration

You can now access Statping-ng via your browser by visiting <username>.uber.space or any domain you set up.

./_static/images/statping_config.png

Configuration site of statping.

Select the Database Connection :manual:`MYSQL <database-mysql>` and type in your your username and password. The database runs on localhost, the port is 3306.

Also add a Project Name and add your domain <username>.uber.space or any other domain you want to use to reach statping.

Add your E-Mail Address and set a password, then you are good to go. No worries if it takes up to one minute to process your request after clicking :guilabel:`Save Settings`.

Customization

To configure your dashboard, manage alerts and much more visit yourdomain.tld/dashboard. Log in with the admin account you created. For help an this you should have a look at the Statping Wiki.

Updates

Note

Check the update feed regularly to stay informed about the newest version.

If there is a new version available, you can get the binary with the same command. First you stop the server, then get the new binary. Make sure to replace the version number v0.80.70 with the latest version number you got from the release feed. Now start the service again and check if everything works fine!

[isabell@stardust ~]$ cd ~/statping/
[isabell@stardust statping]$ supervisorctl stop statping
[isabell@stardust statping]$ curl -sL https://github.com/statping-ng/statping-ng/releases/download/v0.80.70/statping-linux-x64.tar.gz | tar xz
[isabell@stardust statping]$ supervisorctl start statping

Tested with Statping-ng v0.80.70 and Uberspace 7.2.4.0

.. author_list::