Create your own issues by combining miner stats, error codes and system issues into one condition that fits how your site works, and group related issues together. Custom issues appear on the Issues page next to system issues, and you can filter by them and use them in triggers.
Before You Start
- You need the Issue Manager permission.
- Create custom issues from the group owner client (or a standalone client). They apply to all of its sub-clients.
Open Manage Issues
- Click Issues in the left-hand menu.
- Click Manage Issues in the upper-right corner.
The Manage Issues table lists every issue with its Name, Description and Type (System, Group or Custom). Each row's menu (⋮) has Edit, Deactivate / Activate, and Delete. Click Back to return to the Issues page.
Create an Issue Group (Optional)
Groups keep related issues together, for example all hashboard problems.
- On the Manage Issues page, click Add Issue Group.
- Enter a Name (required) and a description (optional), then save.
Create a Custom Issue
- On the Manage Issues page, click Add Custom Issue.
- Under Issue Details, enter:
- Issue Name (required) and a Description.
- Set Miner Status: whether matching miners should show as Failing or Warning.
- Issue Group, if you created one.
- The Active toggle, to turn the issue on.
- In the Logic Builder, choose your first parameter, then add more conditions as needed. All conditions must be true (AND) for the issue to apply. Start typing to search the parameter list.
- Check the Logic Structure summary, which describes in plain text what Foreman will check, then click Save.
Parameters you can use
- Miner details: Client Name, Manufacturer, Miner Type, Miner Name, Serial, Miner IP, Pickaxe, Power Mode, List Of Pool Names
- Stats: Hash Rate, Max Temp, Max Fan, Min Fan, Count Of Fans, Boards, Chip Errors, Query Time MS, Miner Wattage (Basic, PDU and Range), Miner Rebooted
- Error Codes reported by the miner, for example Antminer, Whatsminer, Auradine or LuxOS codes
- System issues: for example Zero Hash Rate, Hash Rate Too Low, Missing Hash Board, Missing Fan, Temp Sensor Too High, No Shares Being Submitted, Invalid Pool Configuration
- LuxOS settings: for example Luxos Profile, Luxos Tuning Enabled and the ATM settings
Example: to flag hashboard failures on Antminers, combine Manufacturer = Antminer with the Error Codes that mean a bad hashboard, set the status to Failing, and name the issue "Bad Hashboard."
Turn Off a System Issue
If a custom issue covers the same problem as a system issue, deactivate the system issue to avoid duplicate warnings. Open its menu (⋮) on the Manage Issues page and choose Deactivate. Miner Not Updating can't be deactivated.
Use Custom Issues
- Filter by them: open the global filter and choose Custom Issues, then pick an issue or an issue group. The filter applies across Foreman.
- Trigger on them: when you build a trigger, custom issues appear under Custom Issues in What to Check For. Issue groups can't be used as trigger conditions. See Quick Guide: Alerts & Triggers.
Things to Know
- Delete is only available for custom issues and for groups that contain no issues. System issues can be deactivated but not deleted.
- An issue that a trigger uses can't be deactivated or deleted until you remove it from the trigger.
Related Articles
Last verified: November 19, 2026