vpsinfo 0.1.0

A CLI tool for monitoring VPS information using SolusVM API

VPSinfo

A command-line tool for monitoring VPS information using the SolusVM API. Supports concurrent monitoring of multiple VPS instances with bandwidth usage and system status information.

Features

• Monitor bandwidth usage (used, total, percentage)
• Monitor memory usage (used, total, percentage)
• Monitor disk usage (used, total, percentage)
• Concurrent monitoring of multiple VPS instances
• Human-readable data formatting
• Simple JSON configuration
• Verbose mode for debugging

Installation

pip install vpsinfo

Configuration

Create a configuration file at ~/.vpsinfo.json:

[
    {
        "name": "my-vps-1",
        "url": "https://your-solusvm-url:5656",
        "key": "your-api-key",
        "hash": "your-api-hash"
    }
]

Each VPS entry requires:

• name: A friendly name for the VPS
• url: SolusVM API URL (usually ends with :5656)
• key: API key from SolusVM control panel
• hash: API hash from SolusVM control panel

Usage

Monitor all VPS metrics (bandwidth, memory, disk):

vpsinfo

Enable verbose output for debugging:

vpsinfo -v

or

vpsinfo --verbose

Example Output

╒══════════════╤══════════╤══════════╤═══════════╤═══════╤══════════╤═══════════╤═══════╤══════════╤═══════════╤═══════╕
│ VPS Name     │ Status   │ BW Used  │ BW Total  │ BW %  │ Mem Used │ Mem Total │ Mem % │ Disk Used│ Disk Total│ Disk %│
╞══════════════╪══════════╪══════════╪═══════════╪═══════╪══════════╪═══════════╪═══════╪══════════╪═══════════╪═══════╡
│ my-vps-1     │ Success  │ 1.25 GiB │ 500.0 GiB │ 0.3%  │ 512.0MiB │ 1.0 GiB   │ 50.0% │ 10.0 GiB │ 50.0 GiB  │ 20.0%│
╘══════════════╧══════════╧══════════╧═══════════╧═══════╧══════════╧═══════════╧═══════╧══════════╧═══════════╧═══════╛

When an error occurs:

╒══════════════╤═════════════════════════╤══════════╤═══════════╤═══════╤══════════╤═══════════╤═══════╤══════════╤═══════════╤═══════╕
│ VPS Name     │ Status                  │ BW Used  │ BW Total  │ BW %  │ Mem Used │ Mem Total │ Mem % │ Disk Used│ Disk Total│ Disk %│
╞══════════════╪═════════════════════════╪══════════╪═══════════╪═══════╪══════════╪═══════════╪═══════╪══════════╪═══════════╪═══════╡
│ my-vps-1     │ Error - Connection failed│ N/A      │ N/A       │ N/A   │ N/A      │ N/A       │ N/A   │ N/A      │ N/A       │ N/A   │
╘══════════════╧═════════════════════════╧══════════╧═══════════╧═══════╧══════════╧═══════════╧═══════╧══════════╧═══════════╧═══════╛

Error Handling

• If a VPS is unreachable or there are API errors, the status will show as "Error" with an error message
• All metrics will show as "N/A" when an error occurs
• Configuration file errors will be reported with clear error messages
• All errors are displayed in red for better visibility
• Use verbose mode (-v) to see detailed debug information

Requirements

• Python 3.7 or higher
• click
• tabulate
• requests