Creating an Alert

Alert Types

There are three types of Alerts:

  • Project Alerts are alerts associated with a specific Project. They have some special Project-related features, let you group the Project’s alerts in one place, and get a summary of alert events in the Project Report.
  • Private Alerts are only visible to you, and only editable by you. This is where you can track things that are important to you personally.
  • Shared Alerts can be viewed and edited by anyone in your GitHub organization. (Project alerts are now recommended instead of Shared alerts, as they offer many benefits.)

Getting Started

First, choose the Alerts tab:

Screenshot of the Alerts tab in GitDailies

Next, choose the type of Alert that you wish to create:

Screenshot of the Alert Kind menu in GitDailies

Then, hit “New Alert”:

Screenshot of the New Alert button in GitDailies

This will launch the New Alert interface.

Alert Trigger

First, choose the Alert Trigger. (Can’t see a trigger that you need? Just let us know!).

Screenshot of Alert trigger menu in GitDailies

Alert Repositories

Next, choose the repo that the alert should monitor. A powerful feature of GitDailies is that one alert can monitor all repositories simultaneously.

You can do any of the following:

  • Choose a specific repository from the dropdown
  • Choose “All followed repositories” to monitor all repositories that your Organization follows with GitDailies
  • For Project Alerts, you can choose “All project repos” to monitor all repos that your Project tracks.
  • Choose “All followed repositories” or “All Project repos”, and choose a subset of repositories later on using repo topics or a regular expression in the Expression Builder.
Screenshot of Alert trigger menu in GitDailies

Alert Conditions

Next, choose any additional criteria for when the Alert should trigger, using the Expression Builder.

In this example, the Alert will trigger whenever a PR has been open for longer than 3 days, is not in “draft” state, has the label “security”, and belongs to repo that has the topic “web”.

Screenshot of the Alert Expression Builder in GitDailies

Choose Notifications

Alert notifications can be sent to any combination of Email, Slack, or Telegram.

Also, if you only want to receive a single daily summary of all the triggers for this Alert, just check Include the the alert in the team's daily alert summary. (Note that your Personal Alerts and the Team Alerts have separate daily summaries, so your personal Alert summary is private).

Project Alerts events are included in the Project Report (as well as sending realtime notifications, if chosen).

Screenshot of Alert notifications in GitDailies

Alert Name

GitDailies will try to pick a sensible name for your alert.

You can edit the name now, and change it later too.

Screenshot of Alert naming in GitDailies

Complete!

Click the “Create Alert” button, and the Alert will be set up for you.

Screenshot of completion of Alert creation

If you don’t yet have a daily alert summary set up, you will be automatically guided through that process next.