Skip to content

title: CloudSlash - Reports Reference description: One command, three formats. Markdown for docs, HTML for emails, JSON for everything else. Every report includes: | Section | Description | Discover waste, enfor

Reports

One command, three formats. Markdown for docs, HTML for emails, JSON for everything else.

Basic Usage

# Print Markdown to terminal
cs report

# Save as styled HTML report
cs report --format=html --output=report.html

# Machine-readable JSON
cs report --format=json --output=report.json

Report Contents

Every report includes:

Section Description
Executive Summary Total nodes, waste count, projected savings, drift, s.a.u blocked
Provider Breakdown Per-provider node count, waste, and cost
Top 10 Waste Items Highest-cost waste resources with CRN and reason
Cost Trend 30-day summary with data point sampling

HTML Reports

The HTML format uses a dark-themed design matching the CloudSlash brand: CSS grid cards, responsive layout, and Inter font. Open it in any browser:

cs report --format=html --output=monthly-report.html
open monthly-report.html

JSON Reports

Ideal for CI/CD integration, Slack bots, or custom dashboards:

cs report --format=json | jq '.projected_savings'

Scheduling Reports

Combine with cron for weekly executive digests:

# Every Monday at 9 AM
0 9 * * 1 cs report --format=html --output=/var/reports/cloudslash-$(date +\%Y\%m\%d).html

Data Sources

Reports pull data from three sources (in priority order):

  1. Live daemon: real-time waste ledger and drift data via HTTP API
  2. Snapshot: last saved graph for detailed node analysis
  3. Trend store: JSONL time-series for historical charts