Foreman can email reports on a schedule, or once on demand, so you can see your fleet's performance, power use, growth and operations without logging in. This article covers how to set up a report and what each report contains.
Set Up a Report
Go to Reports in the left-hand menu. The table lists your scheduled reports with their Recipient, Report and Frequency.
Schedule a recurring report
- Click Add Report.
- Choose who receives it: Myself, Another User or an External Email address.
- Choose a Report Type (see below).
- Choose a Send Frequency: Daily, Weekly or Monthly.
- For pool reports, choose the Pool and Pool Coins. To add some dashboard figures to the report for comparison, turn on Include Dashboard Stats.
- Save.
To change a scheduled report, open its menu in the table and choose Send Now, Edit or Delete.
Send a one-off report
- Click Ad Hoc Report.
- Choose the recipient and Report Type.
- Choose a Report Time Frame: Previous Day, Previous Week, Previous Month or Custom Time Frame (with a Report Start Date and Report End Date).
- Send. The report is emailed when it's ready.
Brand your reports
Click Customize Reports to add your logo (square images work best) and set the report's primary and secondary colors.
Note: some report types appear disabled until they're set up. For example, Pool Report needs a pool API key under Settings > Mining Pools > Mining Pool API Keys, and Site Report (Groups) needs your site map set up in Foreman.
Choose the Right Report
Pick a report by what you want to measure. If you're combining data from several reports, check each one's Miner uniqueness: some identify miners by MAC address, others by Miner ID.
Not sure which report fits? Submit a request below and we'll help you choose.
Performance and Power Reports
Power Report
What it's for: A daily power summary, with per-miner stats for the day and a client-level rollup. Calculates power cost using either real-time market pricing or the fixed Power Cost / kWh in Settings > Company. The email shows both Uptime and Hashing Uptime.
What it exports: Two CSVs: one at the miner level (one row per miner per day) and one at the client level (daily totals).
Where the data comes from: Per-miner stats averaged over 5-minute intervals, then aggregated to the day. Power values come from miner-reported wattage, PDU readings, or manufacturer specifications, whichever is available and configured.
Miner uniqueness: MAC address
Power Report (Hash Rate)
What it's for: A version of the Power Report for when power isn't measured directly. Power and cost are estimated by multiplying each miner's average hash rate by its manufacturer-listed efficiency.
What it exports: Same structure as the Power Report: miner-level and client-level CSVs.
Where the data comes from: The same 5-minute averaged miner stats as the Power Report, with power calculated from hash rate × manufacturer efficiency.
Miner uniqueness: MAC address
Client Stats (Five Minutes)
What it's for: A near-real-time view of fleet performance: per-miner stats averaged over 5-minute windows, then combined across all miners for the client.
What it exports: Client-level CSV with one row per 5-minute interval.
Where the data comes from: Per-miner 5-minute averaged stats, combined to the client level.
Miner uniqueness: MAC address
Hourly Client Stats
What it's for: Like Client Stats (Five Minutes), but smoothed to hourly rows, which is useful for trends. Because it averages already-averaged 5-minute data, results differ slightly from the five-minute report. This is expected.
What it exports: Client-level CSV with hourly rows.
Where the data comes from: Per-miner stats averaged over 5-minute windows, averaged again over the hour, then combined to the client level.
Miner uniqueness: MAC address
Hourly Miner Consumption
What it's for: A detailed per-miner, per-hour breakdown of hash rate, uptime and power draw.
What it exports: One row per miner per hour. The file can be very large for sites with many miners.
Where the data comes from: Per-miner hourly stats, including hash rate, uptime percentage and power draw.
Miner uniqueness: MAC address
Note: If you receive this report and aren't sure you still need it, contact support. A lighter report may cover what you need.
Growth Report
What it's for: Fleet growth over time: how many miners were online and how many were added each day, based on each miner's creation date.
What it exports: Daily CSV with total miner count, online count and new additions per day.
Where the data comes from: Miner creation dates and daily online/offline status.
Miner uniqueness: MAC address and Miner ID (both appear as separate columns)
Pool Report
What it's for: A pool-side view of performance, pulled directly from your mining pool's API, optionally alongside Foreman's own data for comparison. Needs a pool API key (see the note under Set Up a Report).
What it exports: Pool performance data, optionally combined with Foreman daily data.
Where the data comes from: Mining pool APIs. Foreman data, when included, uses 5-minute averaged per-miner stats aggregated to the day.
Miner uniqueness: Miner ID
Profit Report
What it's for: Daily profit calculations per client.
What it exports: Per-client daily profit summary.
Where the data comes from: Daily client data calculated from 5-minute snapshots.
Miner uniqueness: Miner ID
Site Report (Groups)
What it's for: Hourly stats for each container in your site map. Only useful if your site map is set up in Foreman. The email shows the most recent day, and the attached CSV has the full history.
What it exports: The latest day's stats in the email body, with full history in an attached CSV.
Where the data comes from: Snapshot data combined with per-miner 5-minute stats averaged to the hour.
Miner uniqueness: MAC address
Shift KPI
What it's for: Performance by shift or by employee. When you set up the report, choose Report By: Shift or Employee, and pick which shifts to include.
Assets, Inventory and Tickets Reports
These reports need the Assets & Inventory add-on.
Asset Report
What it's for: A daily snapshot of your assets and their details.
What it exports: Date, asset name, type, Asset ID, client, client ID, location and your asset custom fields.
Asset History Report
What it's for: Every change made to assets: what changed, who changed it, and when. Useful for audits.
What it exports: Date, asset, user, action and the details of what changed. Only days with changes are included, and each day is a separate file.
Inventory Report
What it's for: A daily snapshot of your inventory items, quantities and thresholds.
What it exports: Date, item name, type, quantity, notification threshold, client, location and your inventory custom fields.
Inventory History Report
What it's for: Every change made to inventory, including quantities used on tickets.
What it exports: Date, item, user, action and the details of what changed. Only days with changes are included.
Ticket Report
What it's for: Your tickets and their details.
Ticket History Report
What it's for: Every change made to tickets: what changed, who changed it, and when.
Related Articles
- Quick Guide: Power Report
- Quick Guide: Profit Report
- Quick Guide: Foreman's Definition Of Uptime
- Assets & Inventory, Module 6: Reporting and Exports
Have more questions? Submit a request below or reach out to the Customer Success team directly. We'd be happy to help!
Last verified: November 19, 2026