Alert2 UI

This repository contains a Lovelace card to display and interact with Alert2 alerts. It also enhances the information shown in the "more-info" dialog when viewing Alert2 entities in entity cards. We recommend first installing Alert2.

Install

HACS install (recommended)

1. If HACS is not installed, follow HACS installation and configuration instructions at https://hacs.xyz/.

2. Click the button below

   

   or visit the HACS pane and add https://github.com/redstone99/hass-alert2-ui.git as a custom repository of type "Dashboard" by following these instructions.

3. The UI should now show the "Alert2 UI" doc page in HACS. Click the "Download" button (bottom right of screen) to download the UI module.

   If for some reason adding the repository did not take you to the "Alert2 UI" doc page, you may need to click again on the HACS pane, search for "Alert2 UI" and click on it to get to the page.

4. Click "Reload" when it prompts you to reload your browser.

Manual install

1. Download the Source code (zip) link from the repository release section under "Assets" and unzip it.

   We do not recommend downloading directly from the main branch.

2. Create the directory www in your Home Assistant configuration directory if it doesn't already exist.

   Your configuration directory is the directory with configuration.yaml. It is commonly /config, or may be something like ~/.home-assistant/ for Linux installations.

3. Copy alert2.js from unzipped file into the directory www in your config.

   Your config directory should look similar to this after copying:

    <config dir>/configuration.yaml
    <config dir>/www/alert2.js
    <config dir>/custom_components/alert2/__init__.py
    <config dir>/custom_components/alert2/sensor.py
     ... etc...
   

Setup

The install process above downloaded a js module, alert2.js.
Next:

1. If you installed Alert2 UI through HACS and configure dashboards via the UI (i.e., Lovelace in storage mode), then alert2.js should be loaded into HA automatically.

   Otherwise:

   If you configure dashboards via yaml (Lovelace in yaml mode), you need to add an entry for alert2.js in the resources subsection of the lovelace section of your configuration.yaml. If you installed via HACS, this will look like (in bold):

   lovelace:
      mode: yaml
      resources:
        - url: /hacsfiles/hass-alert2-ui/alert2.js
          type: module
        ...

   or if you installed manually directly into the www directory, it will look like:

   lovelace:
      mode: yaml
      resources:
        - url: /local/alert2.js
          type: module
        ...

   Lastly, if you installed Alert2 UI manually and configure dashboards via the UI, then enable "Advanced mode" in your user profile, then click on Settings -> Dashboards -> Resources. "Resources" may appear only in the triple vertical dots on the upper right of the dashboards page. Click on "Add Resource" to add alert2.js.

2. alert2.js defines a custom UI card called custom:alert2-overview. If you configure dashboards via the UI, start editing a dashboard, then click on "Add Card" (or the "+" icon), then manually add a card of type custom:alert2-overview.

   If you're using yaml to specify a dashboard, you can add the Alert2 overview card to your dashboard by adding it to the list of cards in a view, like (in bold):

   views:
    - title: Monitoring
      name: Example
      cards:
      - type: "custom:alert2-overview"
      - type: entities
        ...

3. Restart HomeAssistant and reload the UI

Usage

The alert2-overview Lovelace card lists recently active Alert2 alerts, as well as snoozed or disabled alerts. A slider at the top of the card controls the time window covered. Each line shows the status of the alert, including when it last fired, how many times it fired since the last notification, and whether it has been ack'ed, snoozed or disabled. Each alert will show an "ACK" button if it hasn't been acked already. The button "ACK ALL" will ack all alerts, not just the ones displayed.

Note - alert2-overview will show currently firing old Alert-1 alerts, but it will not show recent activity for the old alerts.

Detailed alert info

If you click on a specific alert listed in the alert overview, a dialog pops up with detailed info on the alert and notification controls. Example:

The first line is a repeat of the alert status.

The second "Previous Firings" section lists each firing over the previous 24 hours. The time when the alert turned on or off is listed as well as the message template text rendered when the alert fired. The "PREV DAY" button lets you look at firings one day earlier and "RESET" returns the listing to the firings over the past 24 hours. You may see events listed that have time unknown. This are extra events inserted due to either HomeAssistant restarting or the first time an alert is created (TODO - filter these spurious events out).

The "Notifications" section lets you snooze or disable notifications. Select an option and click "Update".

Other ways to view alerts

You may also add alert2 entities to entities cards and other cards that support entities. If you click on an alert shown in such a situation, you'll see a popup (called a "more-info dialog") similar to the one shown above. However, since Alert2 isn't integrated into the core HomeAssistant, that dialog will include some extra default sections like "history", but will also include the sections described above.