Module 3: Monitoring Miners

Now that your Pickaxe is installed and your miners are discovered, you're ready to monitor your mining operation in real-time. Foreman provides multiple views and tools to track performance, diagnose issues, and maintain your fleet. This guide will walk you through the essential monitoring interfaces and show you how to customize your monitoring experience.

What You'll Accomplish

By the end of this guide, you will:

Master the Dashboard – Create a customized command center with the metrics that matter most to your operation.
Use the Pickaxe Page – Monitor site-level and per-miner telemetry collected by your local agent.
Navigate the Miner Page – Access detailed diagnostics and controls for individual miners.
Perform basic miner controls – Execute remote commands and bulk operations across your fleet.

Understanding Foreman's Monitoring Architecture

Before diving into specific pages, it's helpful to understand how Foreman organizes monitoring data:

Dashboard Page: Your customizable overview combining data from all sources.
Pickaxe Page: Site-specific view showing data collected by your local Pickaxe agent.
Miner Page: Individual miner details with diagnostic tools and remote controls.

Each view serves a different purpose in your monitoring workflow. Let's explore each one.

Step 1: The Dashboard – Your 360° Command Center

The Dashboard is your primary monitoring interface – the first place you'll look when checking on your operation. Unlike fixed layouts, Foreman's Dashboard is fully customizable, allowing you to surface exactly the data you need at a glance. Whether you prioritize hashrate stability, temperature monitoring, or profitability metrics, you can configure your Dashboard to match your operational priorities.

Accessing the Dashboard

Navigate to Dashboard from the left-hand menu.
Upon first login, you'll see a default layout with standard widgets.

Key Metrics Available on the Dashboard

Your Dashboard can display over 20 different data visualizations, including:

Performance Metrics

Hash Rate: Total fleet hashrate and trends over time.
- Why it matters: Your primary indicator of mining productivity.
- What to watch for: Sudden drops may indicate offline miners or performance issues.

Pool Statistics

Pool Connection Status: Which pools your miners are connected to.
Share Acceptance Rates: Percentage of valid shares submitted.
- Why it matters: Low acceptance rates may indicate network issues or misconfigured miners.

Fleet Health

Miner Status: Count of online, offline, and error-state miners.
Miner Types: Distribution of hardware models in your fleet.
- Why it matters: Helps you track firmware consistency and identify underperforming models.

Environmental & Efficiency

[INSERT TEMPERATURE METRICS IF AVAILABLE]
[INSERT POWER CONSUMPTION METRICS IF AVAILABLE]
[INSERT EFFICIENCY METRICS IF AVAILABLE]

Financial

[INSERT PROFITABILITY METRICS IF AVAILABLE]
[INSERT REVENUE METRICS IF AVAILABLE]

Customizing Your Dashboard with Page Builder

The Page Builder allows you to add, remove, and arrange widgets to create your ideal monitoring layout.

How to Access Page Builder

From the Dashboard page, look for Page Builder in the bottom left of the screen.
Click Page Builder to enter edit mode.

Adding Widgets

In Page Builder mode, select from the dropdown to add a new block.
Browse available widgets from the 20+ visualization options
Select a widget to add it to your Dashboard.
Adjust the tile on your dashboard by changing its location, size, and format of the data presented *when applicable.

Dashboard Best Practices

Place your most critical widgets (fleet hashrate, online/offline status) at the top for immediate visibility.
Remove widgets that are not relevant to you, streamlining for efficiency.

Step 2: The Pickaxe Page – Site-Level Telemetry

While the Dashboard provides a fleet-wide overview, the Pickaxe Page shows you the real-time data being collected by your on-site Pickaxe agent. This view is essential for:

Verifying Pickaxe health and responsiveness.
Viewing site-specific performance when you have multiple locations.
Drilling down from site-level to individual miner data.
Troubleshooting data collection issues.

The Pickaxe Page shows you exactly what your local agent is seeing, making it invaluable for diagnosing and monitoring problems.

Accessing the Pickaxe Page

Navigate to Pickaxe from the left-hand menu.
If you have multiple Pickaxe agents, select the one you want to view.

Understanding the Pickaxe Page Layout

Site-Level Metrics

The Pickaxe Page displays aggregated telemetry for all miners monitored by the selected Pickaxe agent:

Status: Icon indicates current status, Green for no issues, Yellow for some issues, and Red for an offline Pickaxe.
Miner Count: Total miners, broken down by status, online vs offline.

Using View Miners to Drill Down

The Pickaxe Page provides a quick pathway to examine the specific miners monitored by each Pickaxe agent.

Accessing View Miners

On the Pickaxe Page, locate the Pickaxe tile for the agent you want to investigate.
Click the gear icon in the top right corner of that specific Pickaxe tile.
Select View Miners from the dropdown menu.
You'll be redirected to the Miners page, automatically filtered to show only miners linked to the selected Pickaxe.

Why this is useful:

Isolate site-specific issues: Quickly view all miners at a particular location without seeing your entire fleet.
Verify Pickaxe coverage: Confirm which miners are being monitored by which agent.
Streamline troubleshooting: When a Pickaxe shows degraded health, immediately see which miners might be affected.

What happens when you View Miners:

The Miners page opens with a filter applied, showing only miners associated with the selected Pickaxe.
All standard Miner page functionality (sorting, individual miner details, bulk operations) remains available.

Recommended to check here first:

Monitoring your monitoring system is critical – if Pickaxe is struggling, your data may be incomplete or delayed.

Step 3: The Miner Page – Individual Miner Control & Diagnostics

While the Dashboard and Pickaxe Page provide an overview and site-level monitoring, the Miner Page is where you go for detailed diagnostics and control of individual ASICs. This is your primary interface for:

Investigating specific miner performance issues.
Executing remote commands (reboots, pool changes, firmware updates).
Viewing detailed telemetry (chip-level temperatures, individual hashboard performance).
Performing bulk operations across multiple miners.

Accessing the Miner Page

Navigate to Miners from the left-hand navigation menu.
You'll see a list or grid view of all miners in your fleet.

Understanding the Miner List View

What Each Row Represents

Each row in the Miner Page represents one physical ASIC. By default, you'll see key metrics at a glance:

Typical Columns:

Miner Name/Identifier: Unique identifier
Client: Corresponding Client
Status: Okay, Disabled, Fail, Pending, Warn, etc.
Hashrate: Current mining performance
Max Temp: Shown value if one has been set
Max Fan: Shown value if one has been set
Last Update: Date and timestamp
Uptime: Total Uptime
State: Deployed, In Repair, In Storage, etc.
Location: Sitemap or Offline Location, if value has been set
Warranty Expiration Date: Shown value if one has been set

Sorting and Searching

Finding problem miners: Filter by status = "Fail" or "Warn".
Checking a specific model: Filter by miner type to compare performance across similar hardware.
Temperature monitoring: Sort by temperature (high to low) to identify hot-running miners.

Opening the Miner Detail Panel

The Miner Detail Panel provides comprehensive diagnostics and controls for a single miner.

How to Open the Detail Panel

From the Miner Page list view, navigate to the far right column and click Actions to open that miner's dropdown menu
Select Details

What's in the Miner Detail Page

Overview Section:

The top section includes the Name, type, and current status of the Miner.
- The IP, Serial, and Location are also part of this tile.

Performance Metrics:

Real-time Hashrate: Current output and recent trends.
- Hashboard Performance: Individual performance of each hashboard/blade.
  - Why it matters: Unbalanced hashboards may indicate failing chips or power issues.
Highest Temp: Graph showing the current and highest temperature.
Max Fan: Graph showing the current and highest fan speed.
Share Dist: Graph showing the pool statistics for this miner.

Pickaxe Command History (3 days):

The table renders the Pickaxe commands sent to the Miner over the past three days.

Tickets:

The table renders any open Tickets involving the Miner, with the ability to Open Ticket.

Activity:

Think of this section as the history of the miner, including updates to it's location on the site map, if the miner was pulled, etc.

Performing Basic Miner Controls

The Miner Detail Panel allows you to execute remote commands on individual miners.

Available Commands

Common remote operations include:

Restart Miner:

What it does: Reboots the miner's control board and restarts the mining process.
When to use: Recovering from temporary errors, applying configuration changes, or after a miner becomes unresponsive.

Change Pool Settings

Adjust Fan Speed

Update Firmware

Step 4: Bulk Edit Features – Managing Multiple Miners at Scale

In production mining operations, you'll rarely want to perform actions one miner at a time. Bulk operations allow you to:

Update firmware across your entire fleet without manual intervention at each miner.
Restart multiple miners simultaneously to quickly recover from issues.
Change pool configurations across sites or miner groups.
Standardize settings across similar hardware.

Bulk operations save enormous amounts of time and reduce the risk of inconsistent configurations.

Accessing Bulk Edit

From the Miner Page, select the Bulk Edit Miners button to open a column
Click the checkbox next to miners you're looking to edit, then click the Edit (#) button to open the modal.

Common Bulk Operations

Bulk Reboot (Remote)

Use case: Recovering from a widespread issue (network outage, pool problem) or applying configuration changes fleet-wide

Change Pools (Remote)

Use case: Bulk reassign a pool to many miners in a single command.

Bringing It All Together: A Monitoring Workflow

Here's how experienced operators use Foreman's monitoring tools in daily operations:

Morning Check (5 minutes)

Dashboard: Glance at overnight performance
- Check fleet hashrate vs. expected
- Verify all miners online
- Review any alerts
If issues are detected: Drill down in the Pickaxe and/or Miner page.

Deep Dive Investigation (when needed)

Dashboard: Identify which site or miner group has issues.
Pickaxe Page: Verify the local agent is healthy and collecting data properly.
Miner Page: Investigate specific problem miners, review diagnostics.
Action: Execute remote commands or schedule maintenance.

Weekly Maintenance

Miner Page: Sort by temperature to identify hot-running units.
Bulk Operations: Update firmware or restart miners as needed.
Dashboard: Review performance trends over the week.

What's Next?

You now have a complete understanding of Foreman's monitoring capabilities. With these tools, you can maintain visibility into your fleet, quickly diagnose issues, and execute remote operations at scale.

Next Steps:

Managing User Permissions– Configure users so your organization uses Foreman effectively based on roles and permissions.
Advanced Pickaxe Configurations – Optimize your Pickaxe settings for larger fleets or complex network environments

Welcome To The Foreman Knowledge Base

Search