GitLab Notification Emails

原文：https://docs.gitlab.com/ee/user/profile/notifications.html

• Receiving notifications
• Tuning your notifications
  • Editing notification settings
• Global notification settings
  • Notification scope
    • Project notifications
    • Group notifications
      • Group notification level
      • Group notification email address
  • Notification levels
• Notification events
• Issue / Epics / Merge request events
• Filtering email
  • X-GitLab-NotificationReason

GitLab Notification Emails

GitLab 通知使您可以随时了解 GitLab 中发生的事情. 启用通知后，您可以接收有关问题，合并请求和史诗活动的更新. 通知通过电子邮件发送.

Receiving notifications

您将由于以下原因之一收到通知：

• 您参与发行，合并请求或史诗. 在这种情况下， 参与意味着评论或编辑.
• You enable notifications in an issue, merge request, or epic. To enable notifications, click the Notifications toggle in the sidebar to on.

启用通知后，您将收到有关该问题，合并请求或史诗中发生的操作的通知.

注意：通知可能会被管理员阻止，从而阻止发送通知.

Tuning your notifications

通知的数量可能是巨大的. GitLab 允许您调整收到的通知. 例如，您可能希望收到有关特定项目中所有活动的通知，而对于其他项目，仅当您的名字被提及时才得到通知.

您可以通过组合通知设置来调整收到的通知：

• Global notification settings
• Notification scope
• Notification levels

Editing notification settings

编辑通知设置：

1. 点击您的个人资料图片，然后选择设置 .
2. 点击左侧边栏中的通知 .
3. 编辑所需的通知设置. 编辑的设置将自动保存并启用.

这些通知设置仅适用于您. 它们不会影响同一项目或组中其他任何人收到的通知.

Global notification settings

全局通知设置是默认设置，除非您为项目或组选择不同的值.

• 通知电子邮件
  • 这是您的通知将发送到的电子邮件地址.
• 全局通知级别
  • 这是适用于所有通知的默认通知级别 .
• 接收有关您自己的活动的通知.
  • 如果您想接收有关自己活动的通知，请选中此复选框. 默认值：未选中.

Notification scope

您可以通过为每个项目和组选择不同的通知级别来调整通知的范围.

通知范围按优先级顺序应用（从高到低）：

• Project
  • 对于每个项目，您可以选择一个通知级别. 您的项目设置将覆盖组设置.
• Group
  • 对于每个组，您可以选择一个通知级别. 您的群组设置会覆盖您的默认设置.
• 全局（默认）
  • 如果尚未为发生活动的项目或组选择通知级别，则将应用全局或默认通知级别.

Project notifications

您可以为每个项目选择一个通知级别. 如果您需要密切监视选定项目中的活动，这将很有用.

要为项目选择通知级别，请使用以下两种方法之一：

1. 点击您的个人资料图片，然后选择设置 .
2. 点击左侧边栏中的通知 .
3. 在” 项目”部分中找到该项目.
4. 选择所需的通知级别 .

Or:

1. 导航到项目页面.
2. 单击带有下拉图标的通知下拉列表.
3. 选择所需的通知级别 .

有关如何在有新版本发布时通知的演示，请参阅发布通知 .

Group notifications

您可以为每个组选择通知级别和电子邮件地址.

Group notification level

要为组选择通知级别，请使用以下两种方法之一：

1. 点击您的个人资料图片，然后选择设置 .
2. 点击左侧边栏中的通知 .
3. 在” 组”部分中找到该项目.
4. 选择所需的通知级别 .

1. 导航到组的页面.
2. 单击带有下拉图标的通知下拉列表.
3. 选择所需的通知级别 .

Group notification email address

在 GitLab 12.0 中引入

您可以选择一个电子邮件地址，以接收您所属的每个组的通知. 例如，如果您是自由职业者，并且希望将有关客户项目的电子邮件分开存放，这可能会很有用.

1. 点击您的个人资料图片，然后选择设置 .
2. 点击左侧边栏中的通知 .
3. 在” 组”部分中找到该项目.
4. 选择所需的电子邮件地址.

Notification levels

对于每个项目和组，您可以选择以下级别之一：

Notification events

将通知用户以下事件：

Issue / Epics / Merge request events

在以下大多数情况下，通知将发送到：

• Participants:
  • 发行/合并请求的作者和受让人
  • 关于问题/合并请求的评论的作者
  • @username在问题，合并请求或史诗的标题或描述中提到的任何人
  • @username在有关问题，合并请求或史诗的任何评论中提及的”参与”或更高通知级别的任何人
• 观察者：通知级别为”观察”的用户
• 订阅者：手动订阅问题，合并请求或史诗的任何人
• 自定义：通知级别为”自定义”的用户针对下表中显示的任何事件打开了通知

注意：为了最大程度地减少不需要任何操作的通知的数量，从GitLab 12.9 起 ，不再为项目中的所有活动通知合格的批准者. 要接收它们，他们必须将其用户通知设置更改为” 观看” .

此外，如果发布或合并请求的标题或描述发生了更改，则通知将通过@username发送到任何新提及的内容，就像在原始文本中提到的一样.

您不会收到有关您自己创建的问题，合并请求或里程碑的通知（除非由于问题而定）. 仅当其他人对您创建或提及的内容进行评论或添加更改时，您才会收到自动通知.

如果开放的合并请求由于冲突而变得不可合并，则将通知其原因. 如果用户还将合并请求设置为一旦管道成功就自动合并，则该用户也会收到通知.

Filtering email

通知电子邮件包括特定于 GitLab 的标题. 您可以根据这些标头的内容过滤通知电子邮件，以更好地管理您的通知. 例如，您可以过滤特定项目的所有电子邮件，在该项目中您将被分配合并请求或问题.

下表列出了所有特定于 GitLab 的电子邮件标题：

X-GitLab-NotificationReason

X-GitLab-NotificationReason标头包含X-GitLab-NotificationReason的原因. 该值是按优先级顺序的以下值之一：

• own_activity
• assigned
• mentioned

通知的原因也包含在通知电子邮件的页脚中. 例如有原因的电子邮件assigned都会有这句话的注脚：

• You are receiving this email because you have been assigned an item on <configured GitLab hostname>.

注意：正在考虑将其他事件的通知包含在X-GitLab-NotificationReason标头中. 有关详细信息，请参见此相关问题 .