The Triggers feature allows you to automate responses to miner performance issues and receive proactive alerts—eliminating the need for constant monitoring. With the updated experience, you can now also create tickets directly from a trigger and duplicate existing triggers with just a few clicks, making setup and troubleshooting faster than ever.

Looking for the Classic View? View the article here. 

Note: If you don’t see the option to Add Trigger, it’s likely due to your current permission level. Please contact your organization’s Foreman administrator to request the necessary access.

Trigger Components

Triggers are highly customizable items that are composed of different pieces. In the next section, we'll cover how to create one, this section will focus on what the different pieces are and why they're important.

• Miners to Check
  • This defines which miners the Trigger will apply to. You can target all miners, specific miners, or miner groups. For more advanced setups, use AND/OR logic to combine multiple conditions—giving you flexible, granular control over which devices are monitored.
• What to Check For
  • Here you specify the conditions that will activate the Trigger. These can include events like a hash rate drop, hardware error, or missed update. You can stack multiple checks, adjust time intervals, and fine-tune the criteria to match your operational priorities.
• What to Do
  • This defines the action that should be taken when the Trigger conditions are met. You can choose from a variety of responses, such as sending an alert, adjusting overclock or power mode settings, rebooting or restarting miners, or running a custom script. These automated actions help you respond quickly to issues and keep operations running smoothly.

Add Trigger

To add a new trigger, follow the below steps:

1. Click Add Trigger from the top right of the page to open the modal
2. Name your trigger (required)
3. Miners to Check (required)
   
   1. First box (single select)
      1. Any - any miner that meets the next box's criteria
      2. All - all miners that meet the next box's criteria
      3. A Count Of - opens a new field where you'll indicate the numerical number of miners
      4. A Percentage Of - opens a new field where you'll indicate the percentage of miners
   2. Second box (single select)
      
      1. Miner(s) - includes all miners 
      2. Miner(s) Matching - includes all miners meeting specific criteria *see note below
      3. Miner(s) Excluding - includes all miners except those meeting specific criteria *see note below
         - Note: A new field will appear allowing you to choose how you’d like to categorize your miners. Based on your selection, a second field will populate where you can select one or more values within that category.
   3. Add Condition (optional)
   1. 1. Clicking this button allows a second layer of specification choosing either AND/OR and repeating the same steps as above
4. What to Check For (required)
   1. First box (single select)
      1. Trips a(n) - the trigger will activate when the selected condition occurs
      2. Doesn't Trips a(n) - the trigger will activate when the selected condition fails to occur (only available for certain conditions
   2. Second box (single select)
      1. Miner Health Trigger - checks for any miner reporting a general health issue
      2. Miner Hash Rate Trigger - activates based on a miner’s hash rate falling below a defined threshold
      3. Miner Fan Speed Trigger - tiggers when fan speed exceeds or drops below a set range
      4. No Submitted Shares Trigger - detects when a miner stops submitting valid shares
      5. Not Updating Trigger - flags when a miner hasn’t sent data for a defined period
      6. Miner Rebooted Trigger - triggers when a miner unexpectedly reboots
      7. Miner Hardware Errors Trigger - activates if a miner reports hardware errors
      8. Missing Hash Board Trigger - detects when one or more hash boards are not recognized
      9. Missing Fan Trigger - flags when one or more fans are not detected by the system
      10. Time Interval Trigger - triggers every X minutes from midnight in UTC; not available with Doesn’t Trip a(n)
      11. Minute Of Hour Trigger - triggers at a specific minute within each hour (e.g., at :15 past); not available with Doesn’t Trip a(n)
      12. Minute of Day Trigger - this will trigger X minutes after midnight in UTC; not available with Doesn’t Trip a(n)
      13. Pickaxe Offline Trigger - fires when a Pickaxe agent goes offline
      14. Zero Hash Rate Trigger - detects when a miner reports a hash rate of zero
      15. No Pools Configured - triggers when a miner has no mining pools set
      16. Invalid Pools Configured - activates when a miner has incorrect or unreachable pool settings
      17. Remote File Contains - fires if a specific string or pattern is found in a remote log or file
   3. Remaining fields (single select)
      1. Depending on your prior selection of condition, you may see an additional box appear asking if you want to be triggered on Failure or Warning
      2. Depending on your prior selection of condition, you may see an additional box appear asking how many intervals this condition should happen prior to action being taken (intervals are approximately 1 minute long)
   4. Add Condition (optional)
      1. Clicking this button allows a second layer of specification choosing either AND/OR and repeating the same steps as above
5. What to Do (required)
   1. First box (single or multi-select)
      1. Send Alert - sends a notification to alert you or your team when the trigger conditions are met. Great for staying informed without constant monitoring.
         Note: Upon selection, further options will appear which are also single or multi-select
      2. Change Client - reassign miners when trigger conditions are met to a different client
         
      3. Change Overclock - automatically adjusts the overclock profile on affected miners. Useful for scaling performance up or down in response to changing conditions.
         Note: Upon selection, further options will appear to indicate the Frequency and Voltage
      4. Change Pools - switches the active mining pool configuration. Ideal for redirecting hash power or responding to pool-level issues.
         Note: Upon selection, additional fields will appear where you will add in the URL, username, and password of your pool before saving
      5. Change Power Mode - modifies the power mode of the miner (e.g., low power or performance mode). Helps manage energy consumption during peak hours or throttling scenarios.
         Note: Upon selection, more fields will open up allowing you to choose your power mode options with an optional amount of minutes to pass before changing
      6. Create Ticket (NEW) - allows you to automatically generate a ticket when a trigger condition is met. This helps streamline issue tracking and ensures that operational problems are documented and addressed without manual input.
         Note: Upon selection, additional options will appear allowing you to choose who to assign the ticket to, set its priority, and specify where the alert should be sent.
         
      7. Factory Reset - resets the miner to its default settings. Should be used with caution—typically for recovering misconfigured or unstable devices.
         Note: Upon selection, additional fields will appear where you will add in the URL, username, and password of your pool before saving
         
      8. Fan Adjustments - changes fan speed settings. Useful for managing cooling in response to temperature changes or hardware performance.
         Note: Upon selection, you'll be able to choose between Manual (then select the specific fan speed) or Auto (based on compatibility list)
      9. Set Power Target - sets a specific power usage target for the miner. Great for maintaining consistent energy usage within infrastructure or contract limits.
         Note: Upon selection, you'll be able to set the Power Target in watts
      10. Reboot Miners - performs a full power cycle of the miner. Useful for recovering unresponsive devices.
      11. Restart Miners - restarts the mining process without a full reboot. Typically quicker than a full reboot and helpful for resetting software-level issues.
      12. Run Script - more details can be found in this article.

Managing Triggers

Once a trigger is created, you can then click into the three ellipses menu and take one of the following actions:

• View details - click into "Quick View" to see specifics of the trigger
  
  
• Change status - by default, new triggers are set to active. You can toggle this setting to deactivate or reactivate the trigger at any time
  
  
• Edit - you may edit any of the details of your trigger, then click Edit to save from the modal
  
  
  
• Duplicate (NEW) - quickly create a copy of an existing trigger to reuse or customize as needed
  
  
• Delete - to delete your trigger, select the "Delete" option, which will open a confirmation modal to complete the process
  

Trigger Data Table

The Trigger Data Table lists all active and inactive triggers. By clicking the expand button on the left side of a row, you can view the history for that specific trigger. If history is available, you’ll see details including the trigger time, what occurred, the miners involved, conditions that were met, and the actions that were executed.

Ready to upgrade?

We're rolling out the new Triggers UI. If you're ready to enable the new interface for your operation, reach out to us and we’ll get you set up.