Notifications¶

Info

Notifications about ticket updates are available from LogMan.io v25.30.

LogMan.io Alerts can send notifications about updates of tickets.

Currently supported notification types:

email
slack
sms

Configuration¶

Note

Notifications are sent through ASAB Iris micro-service. Make sure it is properly configured first.

Enable Notifications¶

To enable a notification type, the corresponding section must be present in the configuration of LMIO Alerts in /Site/model.yaml.

/Site/model.yaml

services:
  lmio-alerts:
    asab:
      config:
        notification:email: {}  # Add this line to enable email notifications
        notification:slack: {}  # Add this line to enable slack notifications
        notification:sms: {}    # Add this line to enable sms notifications

Notification Period¶

Default notification period is 1 hour.

Notification period (in seconds) can be configured for each notification type in the model.yaml.

Send Slack Notifications Every Two Hours

/Site/model.yaml

services:
  lmio-alerts:
    asab:
      config:
        notification:slack:
          period: 7200

Pause Notifications¶

Each notification type can be paused at the tenant level.

Note

Default Library settings for notifications:

notifications are only sent during the standard working hours (16:00 UTC to 06:00 UTC)
notifications are paused at 16:00 UTC every Friday till Monday 06:00 UTC
accumulated updates are sent to email and slack when notifications resumed after a pause
accumulated updates are NOT sent by sms when notifications resumed after a pause

Please adjust the default settings if required.

The functionality is available through the settings stored in Library at /Alerts/Notifications/settings.yaml.

Notification Type Schedule

/Alerts/Notifications/settings.yaml

  ---
  define:
  type: alerts/notifications

  slack:  # (1)
  schedule:
      - at: 0 16 * * FRI # (2)
      duration: 42h # (3)
      action: discard # (4)

      # Send accumulated updates
      - at: 0 16 * * * # (5)
      duration: 14h # (6)
      action: delay # (7)

Notification type, i.e. slack, email, sms
Stop sending notifications every Friday at 4 p.m. UTC (a standard cron expression)
Pause notification for 42 hours. Start sending notifications Monday at 06:00 (UTC)
Do NOT send accumulated updates when notifications resumed
Stop sending notifications every day at 16:00 (UTC)
Pause notification for 14 hours. Start sending notifications at 06:00 (UTC)
Send accumulated updates when notifications resumed

Supported age postfixes:

y: year, respectively 365 days
M: month, respectively 31 days
w: week
d: day
h: hour
m: minute

For example: "3h" (three hours), "5M" (five months), "1y" (one year) and so on.

Email Notifications¶

Email: Responder Assigned¶

Responder is notified when assigned to the ticket.

Hint

If needed, enable and / or edit Library template Ticket Assignment.md at /Templates/Email/.

Email: Scheduled¶

Default generic values for to (recipient) and from (sender) parameters can be configured in the model.yaml.

/Site/model.yaml

    services:
      lmio-alerts:
        asab:
          config:
            notification:email:
              from: tester@teskalabs.com
              to: user@teskalabs.com

Parameter from is optional.

If you want to send notifications to a default destination email(s), please make sure that to parameter is configured properly.

If a ticket has a responder assigned, and to is configured => notifications sent both to responder and to the configured default email(s)
If a ticket has a responder assigned, and to is not configured => notifications sent to the responder only
If a ticket has no responder assigned, and to is configured => notifications sent to the configured default email(s)
If a ticket has no responder assigned, and to is not configured => notifications not sent

Hint

If needed, enable and / or edit Library template Ticket Updated.md at /Templates/Email/.

Slack Notifications¶

If tenant-specific token and channel is available for asab-iris, notifications will come to a designated channel.

Hint

If needed, enable and / or edit Library template Ticket Updated.md at /Templates/Slack/.

SMS Notifications¶

The default phone number can be configured in the model.yaml.

/Site/model.yaml

services:
  lmio-alerts:
    asab:
      config:
        notification:sms:
          phone: 700700700  # default phone number

Warning

In LogMan.io v25.30, several phone numbers in sms notifications are not supported. The phone number is used for notifications for all tenants.

If a ticket has a responder assigned, and default phone is configured => notifications sent to the responder
If a ticket has a responder assigned, and default phone is not configured => notifications sent to the responder
If a ticket has no responder assigned, and default phone is configured => notification sent to the default phone number
If a ticket has no responder assigned, and default phone is not configured => notifications not sent

Responders should have their phone number specified as part of their credentials profile.

Hint

If needed, enable and / or edit Library template Ticket Updated.md at /Templates/SMS/.