• 通知の受信
• 通知の調整
  • 通知設定の編集
• グローバル通知設定
  • 通知範囲
    • プロジェクト通知
    • グループ通知
      • グループ通知レベル
      • グループ通知メールアドレス
  • 通知レベル
• 通知イベント
• イベント / エピック / マージリクエストイベント
• メールのフィルタリング
  • X-GitLab-NotificationReason

GitLab 通知メール

GitLab Notifications を使うと、GitLab で何が起きているのかを常に知ることができます。 Notifications を有効にすると、イシュー、マージリクエスト、エピックでのアクティビティに関する最新情報を受け取ることができます。 Notifications はメールで送信されます。

通知の受信

以下のいずれかの理由で通知が届きます：

• イシュー、マージリクエスト、またはエピックに参加します。 ここでいう_参加とは_、コメントや編集を意味します。
• イシュー、マージリクエスト、エピックで通知を有効にします。 通知を有効にするには、サイドバーの通知トグルをクリックして_オンに_します。

通知を有効にすると、そのイシュー、マージリクエスト、エピックで発生したアクションの通知を受け取ることができます。

通知の調整

GitLabでは、受け取る通知の量を調整することができます。 例えば、特定のプロジェクトのすべてのアクティビティについて通知を受けたいけれど、他のプロジェクトでは自分の名前が言及されたときだけ通知を受けたい、などです。

通知設定を組み合わせることで、受信する通知を調整できます：

• グローバル通知設定
• 通知範囲
• 通知レベル

通知設定の編集

通知設定を編集するには

1. プロフィール画像をクリックし、「設定」を選択します。
2. 左サイドバーの「通知」をクリックします。
3. 編集した設定は自動的に保存され、有効になります。

これらの通知設定はあなただけに適用され、同じプロジェクトやグループの他の人が受け取る通知には影響しません。

グローバル通知設定

プロジェクトやグループで異なる値を選択しない限り、グローバル通知設定がデフォルト設定となります。

• 通知メール
  • このメールアドレスにお知らせが届きます。
• グローバル通知レベル
  • これは、すべての通知に適用されるデフォルトの通知レベルです。
• 自分のアクティビティに関する通知を受け取ります。
  • 自分のアクティビティに関する通知を受け取りたい場合は、このチェックボックスにチェックを入れてください。 デフォルト：チェックされていません。

通知範囲

プロジェクトやグループごとに異なる通知レベルを選択することで、通知の範囲を調整できます。

通知範囲は、優先順位の高いものから順に適用されます：

• プロジェクト
  • プロジェクトごとに、通知レベルを選択できます。 プロジェクトの設定がグループの設定より優先されます。
• グループ
  • グループごとに、通知レベルを選択できます。 グループの設定は、デフォルトの設定より優先されます。
• グローバル（デフォルト）
  • アクティビティが発生したプロジェクトまたはグループの通知レベルを選択していない場合は、グローバルまたは_デフォルトの_通知レベルが適用されます。

プロジェクト通知

プロジェクトごとに通知レベルを選択できるので、特定のプロジェクトのアクティビティを細かく監視する必要がある場合に便利です。

プロジェクトの通知レベルを選択するには、以下のいずれかの方法を使用します：

1. プロフィール画像をクリックし、「設定」を選択します。
2. 左サイドバーの「通知」をクリックします。
3. プロジェクトセクションでプロジェクトを探します。
4. 希望の通知レベルを選択します。

または:

1. プロジェクトのページに移動します。
2. ベルのアイコンが付いた通知ドロップダウンをクリックします。
3. 希望の通知レベルを選択します。

新しいリリースが利用可能になったときに通知を受ける方法については、リリースの通知をご覧ください。

グループ通知

グループごとに通知レベルとメールアドレスを選択できます。

グループ通知レベル

グループの通知レベルを選択するには、以下のいずれかの方法を使用します：

1. プロフィール画像をクリックし、「設定」を選択します。
2. 左サイドバーの「通知」をクリックします。
3. グループセクションでプロジェクトを探します。
4. 希望の通知レベルを選択します。

1. グループのページに移動します。
2. ベルのアイコンが付いた通知ドロップダウンをクリックします。
3. 希望の通知レベルを選択します。

グループ通知メールアドレス

GitLab 12.0 で導入されました。

例えば、フリーランスで仕事をしていて、クライアントのプロジェクトに関するメールを分けたい場合などに便利です。

1. プロフィール画像をクリックし、「設定」を選択します。
2. 左サイドバーの「通知」をクリックします。
3. グループセクションでプロジェクトを探します。
4. ご希望のメールアドレスを選択してください。

通知レベル

プロジェクトやグループごとに、以下のレベルのいずれかを選択できます：

通知イベント

ユーザーには以下のイベントが通知されます：

イベント / エピック / マージリクエストイベント

以下のほとんどの場合、通知は以下の宛先に送信されます：

• 参加者
  • イシュー/マージ・リクエストの作成者および担当者
  • イシュー/マージリクエストのコメント作成者
  • @username 、イシュー、マージリクエスト、またはエピックのタイトルまたは説明で言及された人。
  • @username 、イシュー、マージリクエスト、またはエピックに関するコメントで言及された、通知レベルが「参加」以上の人。 @username
• ウォッチャー：通知レベルが “Watch “のユーザー
• 購読者: そのイシュー、マージリクエスト、またはエピックに対して手動で購読した人。
• カスタム: 通知レベル「カスタム」のユーザで、以下の表のいずれかのイベントの通知をオンにしたユーザ。

さらに、イシューやマージリクエストのタイトルや説明が変更された場合、@username 、元のテキストで言及されていたかのように、新しい言及に対して通知が送信されます。

自分自身で作成したイシュー、マージリクエスト、マイルストーンには通知が届きません（イシューの期限が迫っている場合を除く）。 他の誰かが自分が作成したイシューにコメントや変更を加えたり、自分について言及した場合にのみ、自動通知が届きます。

開かれているマージリクエストがコンフリクトのためにマージ不可能になった場合、その作成者にその原因が通知されます。 ユーザーがマージリクエストをパイプラインが成功したら自動的にマージするように設定していた場合、そのユーザーにも通知されます。

メールのフィルタリング

通知メールのメッセージには GitLab 固有のヘッダが含まれています。 これらのヘッダの内容に基づいて通知メールをフィルタリングすることで、通知をよりよく管理することができます。 たとえば、マージリクエストやイシューを割り当てられている特定のプロジェクトのメールをすべてフィルタリングすることができます。

次の表は、GitLab特有のメールヘッダの一覧です：

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>.