# Alarm Details

## Alarm Details <a href="#alarm_details" id="alarm_details"></a>

As described in the previous articles, the Current Alarms view and Alarms History view will allow you to navigate to an Alarm Details view. This view gives more exact details about a Motion Tile that satisfied alarm criteria at any given time.  This view is broken down into five windows:

1. Current State
2. Times
3. People
4. Live Data Stream
5. Logged Time Recording

### Current State <a href="#current_state" id="current_state"></a>

This shows the current state of the Motion Tile.  It is very important to note that the current state of the Motion Tile may not reflect the previous alarm state that the tile was in.  However, because the alarm has yet to be cleared, this til is still logged in the Current Alarms view.  Please view an example here to better understand a scenario that reflects this:

{% hint style="info" %}
*EXAMPLE: In this scenario, a user enabled a "High Critical" alarm condition for room temperature that exceeds 80 degrees Fahrenheit.  Let's assume that the room temperature at some point in time exceeded the 80 degree threshold (triggering the alarm) and the user has not cleared the alarm. Let's assume the room temperature dropped back down below this threshold to 75 degrees. At 75 degrees, the current state of the Motion Tile is not in an alarm state.  However, because the alarm was triggered AND was never cleared, it will remain logged in the "Current Alarms" view until cleared by the user.* &#x20;
{% endhint %}

| Details                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Screenshots                      |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| <p>In the screenshot to the right, we are looking at the current state of a Motion Tile that monitors relative humidity from a thermostat device <em>(red box)</em> <br><br>This tile is currently in a warning alarm state as reflected by the <strong>"GOLD"</strong> color of the tile<br><br>This Motion Tile has been "acknowledged" <em>(lime green box)</em> but it has <em><strong>not</strong></em> been "cleared".  <br><br>Therefore, it still appears in our "Current Alarms" view</p> | ![](/files/OeABnehMZgyAiaX9J0Zz) |

### Times <a href="#times" id="times"></a>

In this window, Motion logs the exact date/time of ***when***:

1. the alarm criteria was satisfied (when alarm was triggered)
2. the user acknowledged this alarm (if applicable)
3. the user cleared this alarm (if applicable)

| Details                                                                                                                                                                                                                                  | Screenshots                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| <p></p><p>In the screenshot to the right, the alarm started on 08/30/22 at 11:55AM. <br><br>The user acknowledged the alarm on 08/30/22 at 7:00pm.  <br><br>The user has yet to clear the alarm, as indicated by the "N/A" message. </p> | ![](/files/OroJhLaOEUo9R3ApJCR1) |

1. **Started:** The exact date/time that the alarm was triggered
2. **Acknowledged:** The exact date/time that the alarm was acknowledged
3. **Cleared:** The time date/time alarm was cleared *(Figure 10 demonstrates that the user has NOT cleared the alarm, thus why the alarm remains in the Current Alarms view)*

### People <a href="#people" id="people"></a>

This window gives you details of ***who*** took action on the alarm and when.&#x20;

| Details                                                                                                          | Screenshots                      |
| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| In the screenshot to the right, "Motion\_Admin" acknowledged the alarm, and this user has yet to clear the alarm | ![](/files/B490lvBwvrSjIL7fDiBC) |

1. **Acknowledged By:** A recorded log of which account user acknowledged the alarm (if any)
2. **Cleared By:** A recorded log of which account user cleared the alarm (if any)

### Live Data Stream <a href="#live_data_stream" id="live_data_stream"></a>

The live data stream window you the most recent values logged for this alarm data.&#x20;

| Details                                                                                                                                                                 | Screenshots                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Users will be able to see in real-time how the most recent point data is trending                                                                                       | ![](/files/S236Ch3RupDje0yUqJcQ) |
| Users can also click the "Show History" button on the top right-hand corner of the Live Data Stream section to view a historical data chart in different time intervals | ![](/files/BdyCtcjvN0kr0OHHoDXw) |

### Time Log <a href="#time_log" id="time_log"></a>

In the "Time Log" window, you will find a date/time log of all recorded alarm violations in list form

1. **Time Recorded:** Date/time of the alarm being triggered
2. **Alarmable Value:** The data output that satisfied the alarm condition
3. **Value UUID:** A unique ID is generated for every recorded value that satisfies an alarm condition.<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.motion.cloud/motion-platform-software/alarms/alarm-details.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
