events

Description

List the relevant miner events currently happening. This command may return one or more events (see details below), which most often than not represent an abnormal occurrence on the miner or one of its components.

More than one event can happen for a single component, but if the same event happens more than once, the timestamp is from the first occurrence. Once the underlying cause of the event is solved, the event disappears from the list.

Command

$ echo '{"command": "events"}' | nc $MINER_IP 4028 | jq

Currently, the following events are available:

Example

$ echo '{"command": "events"}' | nc $MINER_IP 4028 | jq
{
  "EVENTS": [
    {
      "Code": "SHUTDOWN_USER",
      "CreatedAt": "2018-03-09T12:51:53+00:00",
      "Description": "Board shutdown due to user request.",
      "DocUrl": "https://docs.luxor.tech/firmware/introduction-to-firmware",
      "ID": 2,
      "Target": "BOARD"
    }
  ],
  "STATUS": [
    {
      "Code": 357,
      "Description": "LUXminer 2025.2.17.181707-ac0bd418",
      "Msg": "Miner Events",
      "STATUS": "S",
      "When": 1520599918
    }
  ],
  "id": 1
}

Note that the meaning of the ID field depends on the value of the Target field. In the example above, this means that the shutdown event is happening to the third board (board 2). Currently, the targets BOARD, FAN and MINER can be returned; of those, only the MINER target does not have an ID because it is used to signal machine-wide occurrences.

Field details