• 通知を受け取る人
• 通知設定の編集
  • 通知範囲
  • 通知レベル
  • グローバル通知設定
  • グループ通知
    • グループ通知レベルの変更
    • グループ通知に使用するメールアドレスの変更
  • プロジェクト通知のレベル変更
  • 製品マーケティングメールの配信停止
    • 自分で管理するプロダクトマーケティングメール
• 通知イベント
• イシュー、マージリクエスト、エピックに関する通知
  • 課題、マージリクエスト、エピックに関する通知を受け取る人
  • イシュー、マージリクエスト、エピックに対する通知設定の編集
  • イシュー、マージリクエスト、エピックに関する通知イベント
• 不明なサインインに対する通知
• 不正な認証コードを使用したサインイン試行に対する通知
• デザインに関する通知
• グループやプロジェクトのアクセス期限に関する通知
• GitLabからのメールをすべてオプトアウト
• 電子メールのフィルタリングに使用できる電子メール・ヘッダ
  • X-GitLab-NotificationReason
    • オンコールアラート通知
    • インシデントのエスカレーション通知
• トラブルシューティング
  • 通知の受信者リストを引き出す
  • 存在しない失敗したパイプラインに関する通知

通知メール

• GitLab 14.9で導入された 機能フラグ enhanced_notify_css。デフォルトでは無効になっています。
• GitLab 14.9でGitLab.comで有効化された拡張メールスタイル。
• GitLab 15.0で、セルフマネージドでEメールスタイルが有効になりました。

メール通知でGitLabで何が起きているのかを常に知ることができます。イシュー、マージリクエスト、エピック、デザインのアクティビティに関する最新情報を受け取ることができます。

GitLab管理者がユーザーにメッセージを送るために使えるツールについては、GitLabからのメールをお読みください。

通知を受け取る人

イシュー、マージリクエスト、エピックに対して通知を有効にすると、そこで起こったアクションが GitLab に通知されます。

次のような理由で通知を受け取ることがあります：

• イシュー、マージリクエスト、エピック、デザインに参加したとき。あなたがコメントや編集を行ったとき、または誰かが¹ について言及したときに参加者となります。
• イシュー、マージリクエスト、エピックで通知を有効にしました。
• プロジェクトまたはグループの通知を設定しました。
• パイプラインメールのインテグレーションを通じて、グループまたはプロジェクトのパイプライン通知を購読しています。

1. GitLab はコメントを編集してユーザーの言及を含めると通知を送信しません。

通知設定の編集

多くの通知を受け取ると、圧倒されることがあります。受信する通知を調整することができます。例えば、特定のプロジェクトのすべてのアクティビティについて通知を受け取りたい場合。他のプロジェクトでは、自分の名前が出たときだけ通知されるようにしたいものです。

これらの通知設定はあなただけに適用されます。他の人が受け取る通知には影響しません。

通知設定を編集するには

1. 左のサイドバーで、自分のアバターを選択してください。
2. 環境設定を選択します。
3. 左サイドバーで「通知」を選択します。
4. 必要なグローバル、グループ、またはプロジェクトの通知設定を編集します。編集した設定は自動的に保存されます。

通知範囲

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

通知範囲は、最も広いレベルから最も具体的なレベルまで適用されます：

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

通知レベル

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

グローバル通知設定

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

• Notification email: 通知を送信するメールアドレス。デフォルトはプライマリメールアドレスです。
• 製品のマーケティングメールを受け取る：GitLabの機能に関する定期的なメールを受け取るには、このチェックボックスを選択します。
• グローバル通知レベル: 全ての通知に適用されるデフォルトの通知レベルです。
• 自分のアクティビティに関する通知を受け取る：自分のアクティビティに関する通知を受け取るには、このチェックボックスを選択します。デフォルトでは選択されていません。

グループ通知

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

グループ通知レベルの変更

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

1. 左のサイドバーで、自分のアバターを選択してください。
2. 環境設定を選択します。
3. 左サイドバーで「通知」を選択します。
4. グループセクションでプロジェクトを探します。
5. 必要な通知レベルを選択します。

または:

1. 左のサイドバーで、Search（検索）を選択するか、Go to（移動）を選択してグループを探します。
2. ベルアイコン（{notifications}）の隣にある通知ドロップダウンリストを選択します。
3. 必要な通知レベルを選択します。

グループ通知に使用するメールアドレスの変更

GitLab 12.0 で導入されました。

所属するグループごとに通知を受け取るメールアドレスを選択できます。例えば、フリーランスで仕事をしていて、クライアントのプロジェクトに関するメールを分けたい場合などにグループ通知を使うことができます。

1. 左のサイドバーで、自分のアバターを選択してください。
2. 環境設定を選択します。
3. 左サイドバーで「通知」を選択します。
4. グループセクションでプロジェクトを探します。
5. 必要なメールアドレスを選択します。

プロジェクト通知のレベル変更

最新の情報を得るために、プロジェクトごとに通知レベルを選択できます。

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

1. 左のサイドバーで、自分のアバターを選択してください。
2. 環境設定を選択します。
3. 左サイドバーで「通知」を選択します。
4. プロジェクトセクションでプロジェクトを探します。
5. 必要な通知レベルを選択します。

または:

1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
2. ベルアイコン（{notifications}）の隣にある通知ドロップダウンリストを選択します。
3. 必要な通知レベルを選択します。

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

製品マーケティングメールの配信停止

GitLabの様々な機能を紹介するメールを受け取ることができます。これらのメールはデフォルトで有効になっています。

オプトアウトするには

1. 左のサイドバーで、自分のアバターを選択してください。
2. 環境設定を選択します。
3. 左サイドバーで「通知」を選択します。
4. 製品マーケティングメールを受信する]チェックボックスをオフにします。編集した設定は自動的に保存され、有効になります。

これらのメールを無効にしても、すべてのメールが無効になるわけではありません。GitLabからのすべてのメールを無効にする方法はこちらをご覧ください。

自分で管理するプロダクトマーケティングメール

セルフマネージド・インストールは、ユーザーのアクションに基づいてこれらのメールを生成し、自動的に送信します。これをオンにしても、GitLabインスタンスやあなたの会社がGitLab Inc.に個人情報を送信することはありません。

インスタンス管理者は、すべてのユーザーに対してこの設定を行うことができます。オプトアウトを選択した場合、管理者が後ですべてのユーザーに対してこれらのメールを有効にしても、あなたの設定はインスタンス全体の設定より優先されます。

通知イベント

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

イシュー、マージリクエスト、エピックに関する通知

イシュー、マージリクエスト、エピックで発生したイベントの通知も受け取ることができます。

課題、マージリクエスト、エピックに関する通知を受け取る人

イシュー、マージリクエスト、エピックでは、ほとんどのイベントで、通知が送信されます：

• 参加者
  • 作成者と担当者。
  • コメントの作成者。
  • タイトルまたは説明文にユーザー名で記載されている人。
  • 通知レベルが「参加中」以上の場合、コメントの中でユーザー名で言及された人。
• Watchers：通知レベルが「Watch」のユーザー。
• 購読者: 手動で通知を購読している人。
• カスタム: 通知レベル “カスタム “のユーザーで、イベントタイプに合った通知をオンにしたユーザー。

イシュー、マージリクエスト、エピックに対する通知設定の編集

イシュー、マージリクエスト、エピックに対する通知を切り替えるには、右サイドバーの通知トグルをオンまたはオフにします。

通知をオンにすると、ディスカッションに参加していなくても、更新ごとに通知を受け取るようになります。エピックで通知をオンにすると、そのエピックにリンクされているイシューには自動的に登録されません。

通知をオフにすると、更新の通知を受け取らなくなります。このトグルをオフにすると、この課題、マージリクエスト、エピックに関連するアップデートのみ配信停止になります。GitLabからのすべてのメールの配信を停止する方法はこちらをご覧ください。

右サイドバーにこのアクションが表示されない場合は、プロジェクトやインスタンスでサイドバーのアクションを移動する機能フラグが有効になっている可能性があります。

イシュー、マージリクエスト、エピックに関する通知イベント

以下の表は、イシュー、マージリクエスト、エピックに対する通知を生成するイベントを示しています：

デフォルトでは、自分で作成したイシュー、マージリクエスト、エピックに関する通知は届きません。自分のイシューやマージリクエストなどの通知を常に受け取るには、自分のアクティビティに関する通知をオンにしてください。

不明なサインインに対する通知

• GitLab 13.0から導入されました。
• GitLab 15.10 で導入された、サインインしているユーザーのフルネームとユーザー名をリストアップ。

ユーザーが未知のIPアドレスやデバイスからのサインインに成功すると、GitLabはユーザーにメールで通知します。こうすることで、GitLabは悪意のあるサインインや不正なサインインの可能性があることをユーザーに積極的に警告します。この通知メールには

• ホスト名
• ユーザー名とユーザー名。
• IPアドレス。
• サインインした日時。

GitLabは既知のサインインを識別するためにいくつかの方法を使用します。通知メールを送信するためには、全ての方法が失敗しなければなりません。

• 最後のサインインIP: 現在のサインインIPアドレスが最後のサインインIPアドレスと照合されます。
• 現在のアクティブなセッション：ユーザーが同じIPアドレスから既存のアクティブなセッションを持っている場合。アクティブなセッション」を参照してください。
• クッキー：サインインに成功すると、暗号化されたクッキーがブラウザに保存されます。このクッキーは、最後にサインインに成功してから14日後に失効するように設定されています。

不正な認証コードを使用したサインイン試行に対する通知

GitLab 15.5 で導入されました。

GitLabは、間違った二要素認証(2FA)コードを使ってアカウントにサインインしようとしたことを検知すると、メール通知を送信します。これにより、悪意のある人物があなたのユーザ名とパスワードにアクセスし、2FAをブルートフォースしようとしていることを検知することができます。

デザインに関する通知

GitLab 13.6で導入されました。

誰かがデザインにコメントすると、参加者にメール通知が送られます。

参加者は

• デザインの作成者（異なる作成者が異なるバージョンのデザインをアップロードしている場合、複数人でもかまいません）。
• デザインに対するコメントの作成者。
• デザインに関するコメントで言及された人。

グループやプロジェクトのアクセス期限に関する通知

GitLab 16.3 で導入されました。

GitLabは、グループやプロジェクトに対するユーザーのアクセス期限が7日後に切れた場合、メール通知を送信します。これにより、グループやプロジェクトのメンバーはアクセス期間を延長するよう促されます。

GitLabからのメールをすべてオプトアウト

GitLabからのお知らせメールを受け取りたくない場合：

1. 左のサイドバーで、自分のアバターを選択してください。
2. 環境設定を選択します。
3. 左サイドバーで「通知」を選択します。
4. 製品マーケティングメールを受信する」チェックボックスをオフにします。
5. グローバル通知レベルを 無効に設定します。
6. 自分のアクティビティに関する通知を受け取る」チェックボックスをオフにします。
7. グループやプロジェクトに所属している場合は、通知設定を「グローバル」または「無効」に設定します。

セルフマネージドインストールでは、この設定を行っても、インスタンス管理者はあなたにメールを送ることができます。配信を停止するには、これらのメールのいずれかの配信停止リンクを選択します。

電子メールのフィルタリングに使用できる電子メール・ヘッダ

通知メールのメッセージには GitLab 固有のヘッダが含まれています。通知をよりよく管理するために、これらのヘッダの内容に基づいて通知メールをフィルタリングすることができます。

たとえば、マージリクエストやイシューを割り当てられている特定のプロジェクトからのメールをすべてフィルタリングすることができます。

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

X-GitLab-NotificationReason

X-GitLab-NotificationReason ヘッダは通知の理由を含んでいます。値は優先度の高い順に以下のいずれかです：

• own_activity
• assigned
• review_requested
• mentioned
• subscribed

通知の理由は、通知メールのフッターにも含まれます。例えば、assigned という理由のメールは、フッターに次のような文章があります：

あなたがこのメールを受信しているのは、⼟⽊ のアイテムが割り当てられているためです。

オンコールアラート通知

オンコールアラート通知メールには、アラートのステータスのいずれかを設定できます：

• alert_triggered
• alert_acknowledged
• alert_resolved
• alert_ignored

インシデントのエスカレーション通知

インシデントのエスカレーション通知メールには、インシデントのステータスのいずれかを指定できます：

• incident_triggered
• incident_acknowledged
• incident_resolved
• incident_ignored

X-GitLab-NotificationReason ヘッダに含まれるイベントのリストの拡張は、イシュー20689 で追跡されています。

トラブルシューティング

通知の受信者リストを引き出す

プロジェクトからの通知を受け取る受信者のリストを引き出したい場合 (主にカスタム通知のトラブルシューティングに使用します)、Railsコンソールでsudo gitlab-rails c を実行し、プロジェクト名を更新してください：

project = Project.find_by_full_path '<project_name>'
merge_request = project.merge_requests.find_by(iid: 1)
current_user = User.first
recipients = NotificationRecipients::BuildService.build_recipients(merge_request, current_user, action: "push_to"); recipients.count
recipients.each { |notify| puts notify.user.username }

存在しない失敗したパイプラインに関する通知

存在しなくなった失敗したパイプラインに関する通知を（メールやSlackを通して）受け取った場合は、そのメッセージを引き起こした可能性のあるGitLabインスタンスが重複していないか再確認してください。