通知メール

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

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

通知を受け取る人

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

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

  1. GitLab はコメントを編集してユーザーの言及を含めると通知を送信しません。
note
管理者は通知をブロックすることができます。

通知設定の編集

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

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

通知設定を編集するには

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

通知範囲

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

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

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

通知レベル

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

レベル説明
グローバルグローバル設定が適用されます。
見るアクティビティに関する通知を受け取ります。
参加参加したスレッドの通知を受け取ります。
言及についてコメントで言及されたときに通知を受け取ります。
無効通知を受け取りません。
Custom参加したイベントやスレッドの通知を受け取ることができます。

グローバル通知設定

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

  • 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.に個人情報を送信することはありません。

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

通知イベント

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

イベント送信先設定レベル
新規リリースプロジェクトメンバーカスタム通知
プロジェクト移動プロジェクトメンバー障がい者以外の方
Eメール変更ユーザーセキュリティメールは常に送信されます。
グループアクセスレベル変更ユーザーユーザーグループのアクセスレベルが変更されたときに送信されます。
新しいメールアドレスの追加ユーザープライマリメールアドレスに送信されるセキュリティメール。GitLab 14.9で導入
新しいメールアドレスの追加ユーザー新しく追加されたメールアドレスに送信されるセキュリティメール。
新しい SAML/SCIM ユーザがプロビジョニングされました。ユーザーユーザーが SAML/SCIM を通してプロビジョニングされたときに送信されます。GitLab 13.8 で導入
新しいSSHキーが追加されました。ユーザーセキュリティメールは常に送信されます。
新規ユーザー作成ユーザーOmniAuth(LDAP) 以外のユーザー作成時に送信されます。
パスワード変更ユーザーユーザーがパスワードを変更した際に送信されるセキュリティメールです。
管理者によるパスワード変更ユーザー管理者が他のユーザーのパスワードを変更したときに必ず送信されるセキュリティメール。
個人アクセストークンの有効期限が迫っています。ユーザーセキュリティメールは常に送信されます。
個人アクセストークンが作成されました。ユーザー常に送信されるセキュリティメール。GitLab 14.9で導入
個人アクセストークンの有効期限が切れました。ユーザーセキュリティメールは常に送信されます。
個人アクセストークンが失効しました。ユーザー常に送信されるセキュリティメール。 GitLab 15.5で導入
プロジェクトアクセスレベルの変更ユーザーユーザー・プロジェクトのアクセス・レベルが変更されたときに送信されます。
SSHキーの有効期限が切れました。ユーザー常に送信されるセキュリティメール。GitLab 13.12で導入
二要素認証無効ユーザーセキュリティメールは常に送信されます。
グループに追加されたユーザーユーザーユーザーがグループに追加されたときに送信されます。
ユーザーがプロジェクトに追加されました。ユーザーユーザーがプロジェクトに追加されたときに送信されます。
グループアクセス期限切れグループのメンバーユーザーのグループへのアクセス権が7日後に切れるときに送信されます。GitLab 16.3で導入
プロジェクトへのアクセス期限切れプロジェクトメンバーユーザーのプロジェクトへのアクセス権が7日後に切れるときに送信されます。GitLab 16.3 で導入

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

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

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

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

  • 参加者
    • 作成者と担当者。
    • コメントの作成者。
    • タイトルまたは説明文にユーザー名で記載されている人。
    • 通知レベルが「参加中」以上の場合、コメントの中でユーザー名で言及された人。
  • Watchers:通知レベルが「Watch」のユーザー。
  • 購読者: 手動で通知を購読している人。
  • カスタム: 通知レベル “カスタム “のユーザーで、イベントタイプに合った通知をオンにしたユーザー。
note
アクションを必要としない通知の数を最小限にするため、GitLab 12.9以降では、資格のある承認者はプロジェクト内のすべてのアクティビティに対して通知されなくなりました。このような通知をオンにするには、代わりにユーザー通知の設定をウォッチに変更する必要があります。

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

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

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

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

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

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

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

種類イベント送信先
エピック終了購読者と参加者
エピック新しい説明文にユーザー名が記載され、通知レベルが「メンション」以上の人。
エピック新しいメモこのイベントを選択した参加者、ウォッチャー、購読者、カスタム通知レベル。また、コメントでユーザー名で言及され、通知レベルが “Mention “以上の人。
エピック再開購読者と参加者
イシュー終了購読者と参加者
イシュー期限このイベントを選択した参加者とカスタム通知レベル。
イシューマイルストーン変更購読者と参加者
イシューマイルストーン削除購読者と参加者
イシュー新しい説明文にユーザー名が記載され、通知レベルが「メンション」以上の人。
イシュー新しいメモこのイベントを選択した参加者、ウォッチャー、購読者、カスタム通知レベル。また、コメントでユーザー名で言及され、通知レベルが “Mention “以上の人。
イシュータイトルまたは説明の変更ユーザー名による新しい言及
イシュー再割り当て参加者、監視者、購読者、このイベントが選択されているカスタム通知レベル、および旧担当者。
イシュー再開購読者と参加者
マージリクエスト終了購読者と参加者
マージリクエスト競合作成者およびマージリクエストを自動マージに設定したユーザー。
マージリクエスト準備完了ウォッチャーと参加者_GitLab 13.10 で導入されました。_
マージリクエストマージ購読者と参加者
マージリクエストパイプライン成功時にマージ作成者、参加者、監視者、購読者、およびこのイベントが選択されたカスタム通知レベル。カスタム通知レベルは、作成者、監視者、購読者では無視されます。GitLab 13.4 で導入
マージリクエストマイルストーン変更購読者と参加者
マージリクエストマイルストーン削除購読者と参加者
マージリクエスト新しい説明文にユーザー名が記載され、通知レベルが「メンション」以上の人。
マージリクエスト新しいメモこのイベントを選択した参加者、ウォッチャー、購読者、カスタム通知レベル。また、コメントでユーザー名で言及され、通知レベルが “Mention “以上の人。
マージリクエストプッシュこのイベントを選択した参加者とカスタム通知レベル。
マージリクエスト再割り当て参加者、監視者、購読者、このイベントが選択されているカスタム通知レベル、および旧担当者。
マージリクエストレビュアー リクエスト参加者、ウォッチャー、購読者、このイベントが選択されているカスタム通知レベル、旧レビュアー。
マージリクエスト再開購読者と参加者
マージリクエストタイトルまたは説明の変更ユーザー名による新しい言及
パイプライン失敗パイプラインの作成者。
パイプライン固定パイプラインの作成者。デフォルトで有効。GitLab 13.1で導入
パイプライン成功パイプラインの作成者。成功したパイプラインに対するカスタム通知レベル。パイプラインが以前に失敗した場合、失敗後に最初に成功したパイプラインには “Fixed pipeline” メッセージが送信され、それ以降に成功したパイプラインには “Successful pipeline” メッセージが送信されます。

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

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

  • GitLab 13.0から導入されました
  • GitLab 15.10 で導入されたサインインしているユーザーのフルネームとユーザー名をリストアップ。
note
この機能はセルフマネージド・インスタンスではデフォルトで有効になっています。管理者はUIのサインイン制限セクションからこの機能を無効にすることができます。この機能はGitLab.comでは常に有効になっています。

ユーザーが未知の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 固有のメールヘッダの一覧です:

ヘッダ説明
List-IdRFC 2919のメーリングリスト識別子におけるプロジェクトのパス。フィルタを使ったメール整理に使えます。
X-GitLab-(Resource)-ID通知の対象となるリソースのID。リソースは、例えば、IssueMergeRequestCommit、または他のそのようなリソースです。
X-GitLab-ConfidentialIssue通知の機密性を示すブール値。GitLab 16.0 で導入されました
X-GitLab-Discussion-IDコメントの通知メールにおける、コメントの属するスレッドの ID。
X-GitLab-Group-IdグループのID。エピックへの通知メールにのみ表示されます。
X-GitLab-Group-Pathグループのパス。エピックに関する通知メールにのみ表示されます。
X-GitLab-NotificationReason通知の理由。可能な値を参照してください
X-GitLab-Pipeline-Idパイプラインの通知メールにおける、通知の対象となるパイプラインのID。
X-GitLab-Project-IdプロジェクトのID。
X-GitLab-Project-Pathプロジェクトのパス。
X-GitLab-Project通知が属するプロジェクトの名前。
X-GitLab-Reply-Keyメールでの返信をサポートするための一意なトークン。

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インスタンスが重複していないか再確認してください。