Alerts

Each time you create a new group, Airlock creates a default alert rule. Alerts are generated based upon a group’s alert rules. By default, all group members receive alert notifications via email, and all integrations specified in the Actions section in this post receive alert notifications.

Alerts can also be configured per-group and are based on the rules defined for that group. To modify the rules visit your Group Settings > Alerts > Rules > “New Alert Rules” or “Edit Rule”. In Rules, you’ll see a list of all active rules and can add alert rules or modify existing rules.

You can also configure various personal notifications from your personal notifications settings and any specific group’s settings in the group alerts page.

Conditions

Rules provide several conditions that you’re able to configure. These are relatively self-explanatory and range from simple state changes to more complex filters on attributes. Every time an event is received, Airlock evaluates the alert conditions.

For example, you can send a notification when a new issue happens at most every 30 minutes.

List of Conditions
  • An event is seen
  • An issue is first seen
  • An issue changes state from resolved to unresolved
  • An issue changes state from ignored to unresolved
  • An event’s tags match {key} {match} {value}
    • key: any tag
    • match: equals, does not equal, starts with, ends with, contains, does not contain, is set, or is not set
    • value: any key’s value
  • An issue is seen more than {value} times in {interval}
    • value: a positive integer
    • interval: one minute, one hour, one day, one week, or 30 days
  • An issue is seen by more than {value} users in {interval}
    • value: a positive integer
    • interval: one minute, one hour, one day, one week, or 30 days
  • An event’s {attribute} value {match} {value}
    • attribute: message, platform, environment,type, exception.type, exception.value, user.id, user.email, user.username, user.ip_address, http.method, http.url, stacktrace.code, stacktrace.module, or stacktrace.filename
    • match: equals, does not equal, starts with, ends with, contains, does not contain, is set, or is not set
    • value: any attribute’s value
  • An event’s level is {match} {level}
    • match: equal to, less than or equal to, greater than or equal to
    • level: fatal, error, warning, info, debug, or sample

Actions

Actions are located in group Settings > Alerts > Rules > “New Alert Rules” or “Edit Rule”.

Action Types

Currently, there are three types of actions you can take:

  • Send a notification (for all legacy integrations)
    • Per-group Integrations are considered to be legacy integrations
  • Send a notification via {service}
    • service is one of mail and any configured per-group integration
Frequency
  • Perform these actions at most once every {interval} for an issue
    • interval: 5 minutes, 10 minutes, 30 minutes, 60 minutes, 3 hours, 12 hours, 24 hours, one week, or 30 days
    • Frequency configuration can get complicated. For example, if an issue changes state from resolved to unresolved, and then this issue is resolved, unresolved, and resolved again within 5 minutes, but your frequency threshold is 30 minutes, you’ll only get one notification

Environment

  • All Environments
  • any one of your defined (and not hidden) environments

Digests

Airlock will automatically digest alerts sent by some services to avoid flooding your inbox with individual issue notifications. To control how frequently notifications are delivered, use the sliders.

Notification Management

You can also configure various personal notifications from your personal notifications settings and any specific group’s settings in the group alerts page.

Default Group Alerts

If you have set any specific group alert to default, that means you’ve configured the notification to the Default group Alert, which is a switch you can toggle on or off. This toggle switch controls all group alerts set to default.

You can find the Default Group Alerts switch in User Settings > Account > Notifications > Fine tune alerts by group.

Per-Group Alerts

Your per-group alerts have the fine-tuning options of Default, On, or Off.

Issue Owners

The Issue Owners page is located in Group Settings > Issue Owners. If an issue owner is specified, the email notification will go to the issue owner. If no issue owner is specified, all group members are notified.

For more details, see full documentation on Issue Owners.

FAQs

  • Can I copy an alert rule to another group?
    • Unfortunately, this is not an option.
  • Can I set different default alert rules?
    • Unfortunately, this is not an option.
  • Are there issue-level filters?
    • No, all filters are event-based. For example, there aren’t configurations for alerting only if an issue is X days old, or assigned to Y, or alerted-on-before, etc.
  • What is the difference between Delete, Delete & Discard, and Ignore?
    • Delete - when you delete an issue with notifications, notifications will continue if the issue is triggered again
    • Delete & Discard - when you delete and discard, all notifications will stop
    • Ignore - while an issue is ignored, all notifications will stop. If it becomes unignored, notifications will continue. For example, if you have chosen “ignore for 30 minutes,” you won’t be notified for 30 minutes.