Iceberg-HT1 Usage Collector

This script collects usage information from an iceberg-ht1 installation.

Description

The ht-usage.py script gathers statistics from an iceberg-ht1 instance and compiles them into a single output file. This information includes the summary.json file produced by iceberg-ht1 and the MAC addresses of the system for identification purposes.

Requirements

• Python 3.6 or higher.
• The ip command must be available in the system's PATH.

Usage

To run the script, you need to provide the path to the iceberg-ht1 storage directory.

./ht-usage.py -s /path/to/storage/directory

Arguments

• -s, --storage-directory: (Required) The path to the iceberg-ht1 storage directory. This directory should contain the stats/summary.json file.
• -v, --version: Show program's version number and exit.

Output

The script will create a file in the current directory with the following name format:

ht-usage-YYYYMMDD-HHMMSS

This file will contain:

• The timestamp of when the script was run.
• The MAC addresses of the machine.
• The contents of the summary.json file.

Sample Output

Timestamp: 2026-03-04 12:16:39
eth0: c6:f3:1a:0d:b3:d3
Path: /tmp/storage/stats/summary.json
Usage: {"timeStamp":1747307554772,"tableUpdates":8,"dataFilesCommitted":4,"dataBytesCommitted":950120}