GitLab has a notification system in place to notify a user of events that are important for the workflow.

Notification settings

You can find notification settings under the user profile.

Notification settings are divided into three groups:

  • Global settings
  • Group settings
  • Project settings

Each of these settings have levels of notification:

  • Watch: Receive notifications for any activity.
  • On Mention: Receive notifications when @mentioned in comments.
  • Participate: Receive notifications for threads you have participated in.
  • Disabled: Turns off notifications.
  • Custom: Receive notifications for custom selected events.
  • Global: For groups and projects, notifications as per global settings.

Global Settings

Global settings are at the bottom of the hierarchy. Any setting set here will be overridden by a setting at the group or a project level.

Group or Project settings can use global notification setting which will then use anything that is set at Global Settings.

Group Settings

Group settings are taking precedence over Global Settings but are on a level below Project or Subgroup settings:

Group < Subgroup < Project

This means that you can set a different level of notifications per group while still being able to have a finer level setting per project or subgroup. Organization like this is suitable for users that belong to different groups but don’t have the same need for being notified for every group they are member of. These settings can be configured on group page under the name of the group. It will be the dropdown with the bell icon. They can also be configured on the user profile notifications dropdown.

Project Settings

Project settings are at the top level and any setting placed at this level will take precedence of any other setting. This is suitable for users that have different needs for notifications per project basis. These settings can be configured on project page under the name of the project. It will be the dropdown with the bell icon. They can also be configured on the user profile notifications dropdown.

Notification events

Below is the table of events users can be notified of:

Event Sent to Settings level
New SSH key added User Security email, always sent.
New email added User Security email, always sent.
New user created User Sent on user creation, except for omniauth (LDAP)
User added to project User Sent when user is added to project
Project access level changed User Sent when user project access level is changed
User added to group User Sent when user is added to group
Group access level changed User Sent when user group access level is changed
Project moved Project members [1] [1] not disabled

Issue / Merge request events

In most of the below cases, the notification will be sent to:

  • Participants:

    • the author and assignee of the issue/merge request
    • authors of comments on the issue/merge request
    • anyone mentioned by @username in the issue/merge request title or description
    • anyone mentioned by @username in any of the comments on the issue/merge request …with notification level “Participating” or higher
  • Watchers: users with notification level “Watch”
  • Subscribers: anyone who manually subscribed to the issue/merge request
  • Custom: Users with notification level “custom” who turned on notifications for any of the events present in the table below
Event Sent to
New issue  
Close issue  
Reassign issue The above, plus the old assignee
Reopen issue  
Due issue Participants and Custom notification level with this event selected
Change milestone issue Subscribers, participants mentioned, and Custom notification level with this event selected
Remove milestone issue Subscribers, participants mentioned, and Custom notification level with this event selected
New merge request  
Push to merge request Participants and Custom notification level with this event selected
Reassign merge request The above, plus the old assignee
Close merge request  
Reopen merge request  
Merge merge request  
Change milestone merge request Subscribers, participants mentioned, and Custom notification level with this event selected
Remove milestone merge request Subscribers, participants mentioned, and Custom notification level with this event selected
New comment The above, plus anyone mentioned by @username in the comment, with notification level “Mention” or higher
Failed pipeline The author of the pipeline
Successful pipeline The author of the pipeline, if they have the custom notification setting for successful pipelines set
New epic  

In addition, if the title or description of an Issue or Merge Request is changed, notifications will be sent to any new mentions by @username as if they had been mentioned in the original text.

You won’t receive notifications for Issues, Merge Requests or Milestones created by yourself (except when an issue is due). You will only receive automatic notifications when somebody else comments or adds changes to the ones that you’ve created or mentions you.

If an open merge request becomes unmergeable due to conflict, its author will be notified about the cause. If a user has also set the merge request to automatically merge once pipeline succeeds, then that user will also be notified.

Email Headers

Notification emails include headers that provide extra content about the notification received:

Header Description
X-GitLab-Project The name of the project the notification belongs to
X-GitLab-Project-Id The ID of the project
X-GitLab-Project-Path The path of the project
X-GitLab-(Resource)-ID The ID of the resource the notification is for, where resource is IssueMergeRequestCommit, etc
X-GitLab-Discussion-ID Only in comment emails, the ID of the discussion the comment is from
X-GitLab-Pipeline-Id Only in pipeline emails, the ID of the pipeline the notification is for
X-GitLab-Reply-Key A unique token to support reply by email
X-GitLab-NotificationReason The reason for being notified. “mentioned”, “assigned”, etc

X-GitLab-NotificationReason

This header holds the reason for the notification to have been sent out, where reason can be mentionedassignedown_activity, etc. Only one reason is sent out according to its priority:

  • own_activity
  • assigned
  • mentioned

The reason in this header will also be shown in the footer of the notification email. For example an email with the reason assigned will have this sentence in the footer: "You are receiving this email because you have been assigned an item on {configured GitLab hostname}"

GitLab Notification Emails的更多相关文章

  1. Jenkins + Ansible + Gitlab之gitlab篇

    前言 持续交付 版本控制器:Gitlab.GitHub 持续集成工具:jenkins 部署工具:ansible  课程安排 Gitlab搭建与流程使用 Ansible环境配置与Playbook编写规范 ...

  2. 远程办公的GitLab开源的员工手册:涵盖了公司价值观,内部沟通交流指南,开发流程,如何开会,写作风格指南,如何报销,如何请假,线上办公工具推荐等方方面面

    原文 :https://docs.gitlab.com.cn/ce/ 英文 :https://about.gitlab.com/handbook/ GitLab Community Edition G ...

  3. 在CentOS6.4上安装GitLab

    1.Install and configure the necessary dependencies On CentOS 6 (and RedHat/Oracle/Scientific Linux 6 ...

  4. 二、CentOS 7安装部署GitLab服务器(解决邮箱发信问题)

    一.环境安装(10.0.0) 1.安装依赖软件 yum -y install policycoreutils policycoreutils-python openssh-server openssh ...

  5. [转]gitlab ci/cd 发布

    转自 https://meigit.readthedocs.io/en/latest/configure_gitlab_i18n_and_create_gitlab_ci_with_gitlab_ru ...

  6. ofbiz 本地化及邮件设置126邮箱

    ofibz登陆功能有通过电子邮件找会密码的功能,但找回密码功能需要配置一个发送email的邮箱账号和smtp服务器的配置,具体配置如下: 1:在ofbiz数据库的表product_store_emai ...

  7. The Google Test and Development Environment (持续更新)

    最近Google Testing Blog上开始连载The Google Test and Development Environment(Google的测试和开发环境),因为blogspot被墙,我 ...

  8. Linux 上使用 Gmail SMTP 服务器发送邮件通知

    导读 假定你想配置一个 Linux 应用,用于从你的服务器或桌面客户端发送邮件信息.邮件信息可能是邮件简报.状态更新(如 Cachet).监控警报(如 Monit).磁盘时间(如 RAID mdadm ...

  9. galera cluster,mysql配置wsrep_notify_cmd参数,增加邮件告警

    vi /usr/local/sunlight/wsrep_notify_cmd.sh chown mysql:mysql  /usr/local/sunlight/wsrep_notify_cmd.s ...

随机推荐

  1. s:select 标签中list存放map对象的使用

    1.XXXAction.java private List<Map<String, String>> maptest = null; public List<Map< ...

  2. Asp.Net MVC 3.0 使用Gzip压缩

    前言 Gzip最早由Jean-loup Gailly和Mark Adler创建,用于Unix系统的文件压缩.我们在Linux中经常会用到后缀为.gz的文件,它们就是Gzip格式的.现今已经成为Inte ...

  3. css3 3d展示中rotate()介绍与简单实现

    最近在了解css3的3d动画效果,学习发现,css3中的3d效果实现还是很好玩的,现在我给你大家简单的介绍一下css3中3d效果的实现. 我也只是一个初学者,如果在博客中写的不对的地方欢迎指正. 好了 ...

  4. MVC 部署在IIS7 出现的 404 错误

    如果你不幸在 windows server 2008 R2 的 IIS7 中部署 MVC 站点的话,如果你输入:http://yourdomain/Organization/Index ,那么你很有可 ...

  5. java之 22天 GUI 图形界面编程(一)

    转自:http://takeme.iteye.com/blog/1876850 GUI(图形用户界面) import java.awt.Button; import java.awt.FlowLayo ...

  6. OTL翻译(7) -- otl_exception类

    otl_exception 这个类是OTL用来抛出异常的类.如果数据库API返回一个非0的错误值,则OTL会将会抛出一个otl_exception的异常.一个otl_exception异常有可能是一个 ...

  7. Zabbix iostat 监控配置

    ## zabbix iostat 监控模板安装与配置 配置定时任务,用于生成iostat的统计数据 crontab -e * * * * * /usr/local/zabbix327/bin/iost ...

  8. 第七章 Xmemcached客户端介绍

    提示:有关于XMemcached在实际开发中的具体使用,查看"Java企业项目开发实践"系列博客的<第八章 企业项目开发--分布式缓存memcached> 注意:本文主 ...

  9. Java 连接MS Access数据库

    java连接MS Access的两种方式: 1.JDBC-ODBC Java连接Access可以使用MS自带的管理工具-->数据源(ODBC)设置建立连接,这样就不需要导入jar.但是,如此一来 ...

  10. 关于Java的一些NIO框架的一点想法

    闲着有点无聊想写点东西. 问题:生活中工作中,会有人问我javaNIO框架里面 Netty Mina  xSocket Grizzly 等等哪个比较好? 在这里写一下自己的感受,也算是总结一下吧 在我 ...