Skip to content

httpdss/collectd-web

Collectd-web: A User-Friendly Interface for Collectd

Contributor Covenant

Collectd-web provides a sleek, intuitive, and customizable web interface for Collectd – the robust resource monitoring tool. Originally, Collectd’s bundled frontend was designed only for testing, leaving its full potential untapped. Collectd-web bridges that gap by offering an efficient, user-centered experience for monitoring system statistics.

πŸ“Š Table of Contents

πŸš€ Features

  • Intuitive Dashboard: Easily visualize system statistics with a responsive design.
  • Customizable Interface: Adjust the display to highlight the data that matters to you.
  • Quick Deployment: Launch the built-in, standalone web server with minimal setup.
  • Efficient Monitoring: Optimized for performance and usability in monitoring diverse systems.

Collectd-web UI

πŸ›  Installation

Prerequisites

Before installing Collectd-web, please ensure:

  • Directory Structure: Organize your files so that each host’s data resides in its own sub-directory named after the host. For example:

    /etc/collectd/collectd-web/localhost/
  • Python 3.6+ Requirement: The standalone web server requires Python version 3.6 or higher.

Configuration

After setting up your directories, create a configuration file to define your data directory. For example, create /etc/collectd/collection.conf with the following content:

datadir: "/etc/collectd/collectd-web/"

Debian-based Installation

To install collectd-web, you need to download the latest .deb package from the GitHub Releases page.

Steps

  1. Find the Latest Release Navigate to the collectd-web Releases page.

  2. Download the .deb File You can manually download the latest .deb file from the release assets or use the following command to fetch it automatically:

    wget $(curl -s https://api.github.com/repos/httpdss/collectd-web/releases/latest | grep "browser_download_url.*\.deb" | cut -d '"' -f 4)
  3. Install the Package Once downloaded, install it using:

    sudo dpkg -i collectd-web*.deb
  4. Resolve Dependencies (if needed) If there are missing dependencies, run:

    sudo apt-get install -f
  5. Start the Service Finally, start the service:

    sudo service collectd-web start

🌐 Usage

Standalone Server

To start the Collectd-web standalone server, simply run:

sudo service collectd-web start

Once running, open your web browser and navigate to the provided address (typically http://localhost:8888) to begin monitoring your systems.

Nginx Configuration

Check the Nginx configuration for setting up Collectd-web with Nginx.

Apache Configuration

Add these lines to your apache vhost configuration:

    Alias /collectd-web/collectd-web /path/to/vhost/httdocs/collectd-web
    <Directory /path/to/vhost/httdocs/collectd-web/cgi-bin>
      Options +ExecCGI +FollowSymLinks
      AddHandler cgi-script .cgi .pl
    </Directory>

πŸ”— Links

πŸ“„ License

Collectd-web is licensed under the Apache 2.0 License. For full license details, please refer to the LICENSE file.

πŸ’° Funding

If you find Collectd-web useful, please consider supporting its development. Donations can be made via PayPal. Your support is greatly appreciated!

πŸ“ Contributing

We welcome contributions from the community. For details on how to get involved, please see our CONTRIBUTING.md.