sleuren

Server monitoring agent


Keywords
sleuren, monitoring, agent, hacktoberfest, python, server-monitoring, systemd, website-monitoring
License
MIT
Install
pip install sleuren==1.0.8

Documentation

Agent

Server Monitoring (sleuren.com) is a web service that monitors and displays statistics of your server performance.

Agent is OS agnostic software compatible with Python 2.7, 3.5, and 3.6. It's been optimized to have low CPU consumption and comes with an extendable set of useful plugins.

Build Status

Documentation

You can find the full documentation at docs.sleuren.com.

Automatic Installation (All Linux Distributions)

You can install the default configuration of Sleuren on all Linux distributions with just one click.

  1. Connect to your server via SSH.

  2. Find your TOKEN. To do so, go to the project installation page.

  3. Run the following command:

wget -q -N https://sleuren.com/sleuren.sh && bash sleuren.sh TOKEN

Manual Installation

To customize installation options, install sleuren agent manually.

  1. Connect to your server via SSH.

  2. Run the following command, which differs depending on your server platform:

    • Debian GNU/Linux:

      apt-get install python3-devel python3-setuptools python3-pip
      pip3 install sleuren
      wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini
    • Fedora/CentOS version 6 or earlier (python 2.7):

      yum install python-devel python-setuptools gcc
      easy_install sleuren netifaces psutil
      wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini
    • Fedora/CentOS version 7 and later (python 3):

      yum install python36-devel python36 gcc
      pip3 install sleuren
      wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini
  3. Find your TOKEN. To do so, go to the project installation page.

  4. Run the following command (TOKEN is the one you got during the previous step):

    sleuren hello TOKEN /etc/sleuren-token.ini
  5. Create a systemd service at /etc/systemd/system/sleuren.service by adding the following:

    [Unit]
    Description=Sleuren agent
    [Service]
    ExecStart=/usr/local/bin/sleuren
    User=sleuren
    [Install]
    WantedBy=multi-user.target
  6. Run the following command:

    chmod 644 /etc/systemd/system/sleuren.service
    systemctl daemon-reload
    systemctl enable sleuren
    systemctl start sleuren