Alpaca screenshot

Alpaca

Author Avatar Theme by Echoyuanliang
Updated: 14 May 2017
47 Stars

a simple linux dashboard

Categories

Overview

Alpaca is a Linux dashboard built using Vue 2.0, Python 2.7, and Flask. It is designed to collect, analyze, and display various information about the Linux operating system. The dashboard provides four key dimensions of information: basic information (IP, hostname, CPU configuration, disk partition information, etc.), system information (load, CPU idle rate, CPU time distribution, memory usage rate, process with high CPU/memory usage, IO read/write statistics, etc.), network information (traffic statistics and trends for each network interface, connection details and status statistics), and process information (details of specific processes including memory and CPU usage, creation time, status, IO information, subprocesses, network connections, open file descriptors, and started threads). Alpaca requires Linux operating system, Python 2.7, Node.js version 4.0.0 or above, and npm version 3.0.0 or above for installation and operation.

Features

  • Basic Information: Provides IP, hostname, CPU configuration, and disk partition information.
  • System Information: Displays load and trends, CPU idle rate, CPU time distribution, memory usage rate, memory usage distribution, processes with high CPU/memory usage, IO read/write statistics, and time consumption details.
  • Network Information: Shows traffic statistics and trends for each network interface, connection details, and status statistics.
  • Process Information: Presents detailed information about specific processes, including memory and CPU usage, creation time, status, IO information, subprocesses, network connections, open file descriptors, and started threads.

Installation

To install Alpaca, the following requirements must be met:

  • Linux operating system
  • Python 2.7
  • Node.js version 4.0.0 or above
  • npm version 3.0.0 or above

Follow the steps below for installation:

  1. Clone the code to the target machine.
  2. Navigate to the code directory.
  3. Run the alpaca management script, which provides operations like build (installing program dependencies, packaging frontend files), start, stop, restart, and status. If you have just cloned the code or made any modifications, make sure to rebuild it before starting.
  4. The application is configured to use gunicorn for hosting (can also be started using run.py). The gunicorn startup configuration file path is backend/gun.py, with default port set to 8080.
  5. The application configuration file path is backend/config.py.
  6. Alpaca uses Linux users (except root) and passwords to manage user login. To grant access to specific users, configure the AUTH_USER setting. If no users are configured or an empty array is provided, all users have login access. Additionally, Alpaca grants access only to whitelisted IPs. Configure the AUTH_IP setting. If no IPs are configured or an empty array is provided, all IPs have access.

Summary

Alpaca is a Linux dashboard that collects, analyzes, and displays information about the Linux operating system. It provides insights into basic information, system performance, network statistics, and process details. The installation process requires a Linux operating system, Python 2.7, Node.js, and npm. The application can be started using the alpaca management script or the run.py file. Login authentication is based on Linux users and passwords, with the option to configure specific users and whitelist IPs. Overall, Alpaca offers a comprehensive monitoring solution for Linux systems.