%%{init: { "fontFamily": "GitLab Sans", 'theme':'neutral' }}%%
flowchart TD
  accTitle: Notification hierarchy
  accDescr: Example of a group, subgroup, and project
N[Default/global notification level set to Watch]
N --> A
A[Group A: Notification level set to Global]
A-. Inherits Watch level .-> N
A --> B[Subgroup B: Notification level set to Participate]
B --> C[Project C: Notification level set to Global]
C-. Inherits Participate level .-&gt; B</code></pre></details></div>

프로젝트 C는 하위 그룹 B에서 Participate 알림 수준을 상속합니다.
전역 알림 설정의 Watch 알림 수준은 상속하지 않습니다.
그룹 알림#
각 그룹에 대해 알림 수준과 이메일 주소를 선택할 수 있습니다.
그룹 알림 수준 변경#
그룹의 알림 수준을 선택하려면 다음 두 방법 중 하나를 사용합니다:

오른쪽 상단에서 아바타를 선택합니다.
Preferences를 선택합니다.
왼쪽 사이드바에서 Notifications를 선택합니다.
Groups 섹션에서 해당 그룹을 찾습니다.
원하는 알림 수준을 선택합니다.

또는 다음을 수행합니다:

상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
벨 아이콘([notifications]) 옆의 알림 드롭다운 목록을 선택합니다.
원하는 알림 수준을 선택합니다.

그룹 알림에 사용할 이메일 주소 변경#
소속된 각 그룹의 알림을 받을 이메일 주소를 선택할 수 있습니다.
예를 들어 프리랜서로 일하면서 고객 프로젝트 관련 이메일을 따로 관리하려는 경우 그룹 알림을 활용할 수 있습니다.

오른쪽 상단에서 아바타를 선택합니다.
Preferences를 선택합니다.
왼쪽 사이드바에서 Notifications를 선택합니다.
Groups 섹션에서 해당 그룹을 찾습니다.
원하는 이메일 주소를 선택합니다.

프로젝트 알림 수준 변경#
최신 상태를 유지할 수 있도록 각 프로젝트에 알림 수준을 선택할 수 있습니다.
프로젝트의 알림 수준을 선택하려면 다음 두 방법 중 하나를 사용합니다:

오른쪽 상단에서 아바타를 선택합니다.
Preferences를 선택합니다.
왼쪽 사이드바에서 Notifications를 선택합니다.
Projects 섹션에서 해당 프로젝트를 찾습니다.
원하는 알림 수준을 선택합니다.

또는 다음을 수행합니다:

상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
벨 아이콘([notifications]) 옆의 알림 드롭다운 목록을 선택합니다.
원하는 알림 수준을 선택합니다.


새 릴리스가 제공될 때 알림을 받는 방법은 릴리스 알림에서 확인합니다.
알림 이벤트#
알림은 사용자, 프로젝트, 그룹 이벤트와 작업 항목 활동에 대해
전송됩니다.
사용자 이벤트#
히스토리
개인 액세스 토큰 교체 알림이 GitLab 18.3에서 도입되었습니다.
사용자 알림 이벤트:



이벤트
수신자
세부 정보




이메일 변경
사용자
보안 이메일, 항상 전송됩니다.


그룹 액세스 수준 변경
사용자



새 이메일 주소 추가
사용자
보안 이메일, 새로 추가된 이메일 주소로 전송됩니다.


새 이메일 주소 추가
사용자
보안 이메일, 기본 이메일 주소로 전송됩니다.


새 SSH 키 추가
사용자
보안 이메일, 항상 전송됩니다.


새 사용자 생성
사용자
OmniAuth(LDAP)를 제외하고 사용자 생성 시 전송됩니다.


비밀번호 변경
사용자
보안 이메일, 사용자가 자신의 비밀번호를 변경할 때 항상 전송됩니다.


관리자에 의한 비밀번호 변경
사용자
보안 이메일, 관리자가 다른 사용자의 비밀번호를 변경할 때 항상 전송됩니다.


개인 액세스 토큰 취소
사용자
보안 이메일, 항상 전송됩니다.


개인 액세스 토큰 교체
사용자
보안 이메일, 항상 전송됩니다.


개인 액세스 토큰 만료 임박
사용자
보안 이메일, 항상 전송됩니다.


개인 액세스 토큰 생성
사용자
보안 이메일, 항상 전송됩니다.


개인 액세스 토큰 만료
사용자
보안 이메일, 항상 전송됩니다.


SSH 키 만료
사용자
보안 이메일, 항상 전송됩니다.


이중 인증 해제
사용자
보안 이메일, 항상 전송됩니다.



프로젝트 이벤트#
히스토리
프로젝트 배포 토큰 만료 임박 알림이 GitLab 18.3에서 도입되었습니다.
프로젝트 삭제 예정 알림이 GitLab 17.11에서 도입되었습니다.
프로젝트 알림 이벤트:



이벤트
수신자
세부 정보




새 릴리스
프로젝트 멤버
Release is created 사용자 지정 알림 수준을 선택한 경우에만 전송됩니다.


프로젝트 액세스 만료
프로젝트 멤버
사용자의 프로젝트 액세스가 7일 후 만료될 때 전송됩니다.


프로젝트 액세스 수준 변경
프로젝트 멤버
사용자의 프로젝트 액세스 수준이 변경될 때 전송됩니다.


프로젝트 액세스 토큰 만료 임박
직접 소속 프로젝트 Owner 및 Maintainer
보안 이메일, 항상 전송됩니다.


프로젝트 배포 토큰 만료 임박
프로젝트 Owner 및 Maintainer
보안 이메일, 항상 전송됩니다.


프로젝트 이동
프로젝트 멤버
Disabled를 제외한 모든 알림 수준에서 전송되거나, Project is moved 사용자 지정 알림 수준을 선택한 경우 전송됩니다.


프로젝트 삭제 예정
프로젝트 Owner
프로젝트가 삭제 예정으로 지정될 때 전송됩니다.


프로젝트에 사용자 추가
사용자
사용자가 프로젝트에 추가될 때 전송됩니다.



그룹 이벤트#
히스토리
그룹 삭제 예정 알림이 GitLab 17.11에서 도입되었습니다.
그룹 알림 이벤트:



이벤트
수신자
세부 정보




그룹 액세스 만료
그룹 멤버
사용자의 그룹 액세스가 7일 후 만료될 때 전송됩니다.


그룹 액세스 토큰 만료 임박
직접 소속 그룹 Owner
보안 이메일, 항상 전송됩니다.


그룹 삭제 예정
그룹 Owner
그룹이 삭제 예정으로 지정될 때 전송됩니다.


그룹에 사용자 추가
사용자
사용자가 그룹에 추가될 때 전송됩니다.


새 SAML/SCIM 사용자 프로비저닝
사용자
SAML/SCIM을 통해 사용자가 프로비저닝될 때 전송됩니다.



이슈, 머지 리퀘스트, 에픽 이벤트#
히스토리
승인 자격이 있는 머지 리퀘스트 알림이 GitLab 17.11에서 이름이 변경되었습니다.
서비스 계정 파이프라인 알림이 GitLab 18.1에서 도입되었습니다.
이벤트는 선택한 알림 수준에 따라 알림을 생성합니다.
일부 알림은 Custom 알림 수준을 선택하고 원하는 이벤트를 선택하여 켤 수 있습니다. 에픽, 이슈, 머지 리퀘스트에 대해 알림을 직접 구독할
수도 있습니다.
기본적으로 사용자가 만든 이슈, 머지 리퀘스트, 에픽에 대해서는 알림을 받지 않습니다.
본인 활동에 대한 알림을 켤 수 있습니다.
에픽 이벤트 알림은 다음 알림 수준에 대해 전송됩니다:



이벤트
Watch
Participate
On Mention
Subscribed
Custom
추가 세부 정보




닫힘
예
예

예
예



새 에픽
예
예
예

예
설명에서 사용자 이름으로 언급될 때 전송됩니다.


새 댓글
예
예
예
예
Comment is added를 선택한 경우
댓글에서 사용자 이름으로 언급될 때도 전송됩니다.


다시 열림
예
예

예
예




이슈 이벤트 알림은 다음 알림 수준에 대해 전송됩니다:



이벤트
Watch
Participate
On Mention
Subscribed
Custom
추가 세부 정보




닫힘
예
예

예
Issue is closed를 선택한 경우



내일 마감

예


Issue is due tomorrow를 선택한 경우
알림은 다음 날짜가 마감일인 열린 이슈에 대해 서버 시간대(GitLab.com은 UTC) 00:50에 전송됩니다.


마일스톤 변경
예
예

예
예



마일스톤 제거
예
예

예
예



새 이슈
예
예
예

Issue is created를 선택한 경우
설명에서 사용자 이름으로 언급될 때도 전송됩니다.


새 댓글
예
예
예
예
Comment is added를 선택한 경우
댓글에서 사용자 이름으로 언급될 때도 전송됩니다.


제목 또는 설명 변경
예

예


사용자 이름으로 새로 언급된 경우.


재배정
예
예

예
Issue is reassigned를 선택한 경우
이전 담당자에게도 전송됩니다.


다시 열림
예
예

예
Issue is reopened를 선택한 경우





머지 리퀘스트 알림은 다음 알림 수준에 대해 전송됩니다:



이벤트
Watch
Participate
On Mention
Subscribed
Custom
추가 세부 정보




닫힘
예
예

예
Merge request is closed를 선택한 경우



충돌
예




작성자와 머지 리퀘스트를 자동 병합으로 설정한 모든 사용자.


준비 완료로 표시
예
예


예



병합됨
예
예

예
Merge request is merged를 선택한 경우



자동 병합으로 설정
예
예

예
Merge request is set to auto-merge를 선택한 경우
작성자, 감시자, 구독자에 대해서는 사용자 지정 알림 수준이 무시됩니다.


마일스톤 변경
예
예

예
예



마일스톤 제거
예
예

예
예



새 머지 리퀘스트
예
예
예

Merge request is created를 선택한 경우
설명에서 사용자 이름으로 언급된 모든 사람.


새 댓글
예
예
예
예
Comment is added를 선택한 경우
댓글에서 사용자 이름으로 언급된 모든 사람.


새 푸시

예


Merge request receives a push를 선택한 경우



재배정
예
예

예
Merge request is reassigned를 선택한 경우
이전 담당자에게도 전송됩니다.


검토자 변경
예
예

예
Merge request reviewers are changed를 선택한 경우
이전 검토자에게도 전송됩니다.


다시 열림
예
예

예
Merge request is reopened를 선택한 경우



제목 또는 설명 변경
예

예


사용자 이름으로 새로 언급된 경우.


승인 자격이 있는 새 머지 리퀘스트.




Merge request you're eligible to approve is created를 선택한 경우




특정 이슈, 머지 리퀘스트, 에픽에 대한 알림 구독#
특정 이슈, 머지 리퀘스트, 에픽의 알림을 전환하려면 다음을 수행합니다:

오른쪽 사이드바 상단에서 다음을 선택합니다:

알림을 켜려면 Notifications on([notifications]).
알림을 끄려면 Notifications off([notifications-off]).



이동된 알림#
히스토리
GitLab 19.3에서 일반 공개되었습니다. 기능 플래그 notifications_todos_buttons가 제거되었습니다.
알림을 켜면 논의에 참여하지 않았더라도 업데이트마다 알림을 받기
시작합니다.
에픽에서 알림을 켜도 에픽에 연결된 이슈에는 자동으로 구독되지
않습니다.
알림을 끄면 업데이트에 대한 알림을 더 이상 받지 않습니다.
이 토글을 끄면 해당 이슈, 머지 리퀘스트, 에픽과 관련된 업데이트만 구독이 취소됩니다.
GitLab의 모든 이메일 수신을 해제하는 방법을 확인합니다.
CI/CD 파이프라인 이벤트#
CI/CD 파이프라인 이벤트 알림은 다음 알림 수준에 대해 파이프라인 생성자에게 전송됩니다:



이벤트
Watch
Custom
추가 세부 정보




실패
예
Pipeline fails를 선택한 경우



복구

Pipeline is fixed를 선택한 경우



성공
예
Pipeline is successful를 선택한 경우
이전에 파이프라인이 실패했다면 실패 후 처음 성공한 파이프라인에 대해 "Fixed pipeline" 메시지가 전송되고, 이후 성공한 파이프라인에 대해서는 "Successful pipeline" 메시지가 전송됩니다.



서비스 계정 파이프라인 이벤트 알림은 다음 알림 수준에 대해 전송됩니다:



이벤트
Watch
Custom




실패
예
Pipeline by Service Account fails를 선택한 경우


복구

Pipeline by Service Account is fixed를 선택한 경우


성공
예
Pipeline by Service Account is successful를 선택한 경우



모든 이벤트를 Watch 수준에 추가하는 작업은 이슈
501083에서 추적합니다.
특정 이벤트 비활성화#
GitLab Self-Managed 및 GitLab Dedicated에서 always sent 보안 이메일을 끄려면,
인스턴스 관리자가 개별 백그라운드 job을 끌 수 있습니다.
예를 들면 다음과 같습니다:

personal_access_tokens_expiring_worker
personal_access_tokens_expired_notification_worker
ssh_keys_expiring_soon_notification_worker
ssh_keys_expired_notification_worker
deploy_tokens_expiring_worker
members_expiring_worker

알 수 없는 로그인에 대한 알림#
히스토리
GitLab 17.5에서 지리적 위치가 추가되었습니다.
Note
이 기능은 GitLab Self-Managed 인스턴스에서 기본적으로 켜져 있습니다. 관리자는 UI의
로그인 제한 섹션에서 이 기능을 끌 수 있습니다.
GitLab.com에서는 이 기능이 항상 켜져 있습니다.

사용자가 이전에 알려지지 않은 IP 주소나 디바이스에서 로그인에 성공하면
GitLab은 이메일로 사용자에게 알립니다. 이런 방식으로 GitLab은 악의적이거나 인가되지 않은 로그인 가능성을
사용자에게 미리 알립니다. 이 알림 이메일에는 다음이 포함됩니다:

호스트 이름.
사용자의 이름과 사용자 이름.
IP 주소.
지리적 위치.
로그인 날짜와 시간.

GitLab은 여러 방법으로 알려진 로그인을 식별합니다. 알림 이메일이 전송되려면 모든 방법이 실패해야 합니다.

마지막 로그인 IP: 현재 로그인 IP 주소를 마지막 로그인 IP 주소와
비교합니다.
현재 활성 세션: 사용자가 같은 IP 주소에서 기존 활성 세션을 갖고 있는
경우입니다. 활성 세션을 참고합니다.
쿠키: 로그인에 성공하면 암호화된 쿠키가 브라우저에 저장됩니다.
이 쿠키는 마지막 로그인 성공 후 14일이 지나면 만료되도록 설정됩니다.

잘못된 확인 코드를 사용한 로그인 시도에 대한 알림#
GitLab은 잘못된 이중 인증(2FA) 코드로 계정에 로그인하려는 시도를 감지하면 이메일 알림을
보냅니다. 이를 통해 공격자가 사용자 이름과 비밀번호를 확보해 2FA를 무차별 대입으로 뚫으려
하고 있음을 알아차릴 수 있습니다.
디자인에 대한 알림#
누군가 디자인에 댓글을 달면 참여자에게 이메일 알림이 전송됩니다.
참여자는 다음과 같습니다:

디자인 작성자(작성자가 서로 다른 버전의 디자인을 업로드한 경우 여러 명일 수 있습니다).
디자인에 달린 댓글의 작성자.
디자인 댓글에서 언급된 모든 사람.

그룹 또는 프로젝트 액세스 만료에 대한 알림#
GitLab은 사용자의 그룹 또는 프로젝트 액세스가 7일 후 만료되면 이메일 알림을 보냅니다.
이 알림은 그룹 또는 프로젝트 멤버가 원하는 경우 액세스 기간을 연장하도록 상기시킵니다.
GitLab의 모든 이메일 수신 해제#
이메일 알림을 더 이상 받고 싶지 않으면 다음을 수행합니다:

오른쪽 상단에서 아바타를 선택합니다.
Preferences를 선택합니다.
왼쪽 사이드바에서 Notifications를 선택합니다.
Global notification level을 Disabled로 설정합니다.
Receive notifications about your own activity 체크박스를 선택 해제합니다.
그룹이나 프로젝트에 소속되어 있으면 해당 알림 설정을 Global 또는
Disabled로 설정합니다.

GitLab Self-Managed 및 Dedicated 인스턴스에서는 이렇게 설정한 뒤에도 일부 이벤트 알림은 계속 전송됩니다:

인스턴스 관리자는 계속 이메일을 보낼 수 있습니다
always sent로 표시된 알림 이벤트

알림 이메일 구독 취소#
GitLab에서 오는 알림 이메일은 리소스 단위(예: 특정 이슈)로 구독을 취소할 수 있습니다.
구독 취소 링크 사용#
GitLab에서 오는 모든 알림 이메일 하단에는 구독 취소 링크가 있습니다.
구독을 취소하려면 다음을 수행합니다:

이메일에서 구독 취소 링크를 선택합니다.
브라우저에서 GitLab에 로그인한 상태라면 즉시 구독이 취소됩니다.
로그인하지 않은 상태라면 작업을 확인해야 합니다.

이메일 클라이언트 또는 기타 소프트웨어 사용#
이메일 클라이언트에서 GitLab 이메일을 볼 때 Unsubscribe가 표시될 수 있습니다.
구독을 취소하려면 이 버튼을 선택합니다.
GitLab에서 오는 알림 이메일에는 특수 헤더가 포함됩니다.
이 헤더를 사용하면 지원되는 이메일 클라이언트와 기타 소프트웨어가
사용자의 구독을 자동으로 취소할 수 있습니다. 예를 들면 다음과 같습니다:
List-Unsubscribe: <https://gitlab.com/-/sent_notifications/[REDACTED]/unsubscribe>,<mailto:incoming+[REDACTED]-unsubscribe@incoming.gitlab.com>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

List-Unsubscribe 헤더에는 두 개의 항목이 있습니다:

소프트웨어가 POST 요청을 보내는 링크입니다.
이 작업은 해당 리소스에서 사용자의 구독을 바로 취소합니다.
이 링크에 GET 요청을 보내면 구독을 취소하지 않고 확인 대화 상자를 표시합니다.
소프트웨어가 구독 취소 이메일을 보내는 이메일 주소입니다.
이메일 본문은 무시됩니다.

이메일로 구독을 취소하는 경우에도 이메일로 회신할 때와 같은 2년
보존 정책이 적용됩니다.
이메일 필터링에 사용할 수 있는 이메일 헤더#
알림 이메일 메시지에는 GitLab 고유 헤더가 포함됩니다. 알림을 더 잘 관리하려면
이 헤더의 내용을 기준으로 알림 이메일을 필터링할 수 있습니다.
예를 들어 특정 프로젝트에서 머지 리퀘스트나 이슈가 자신에게 배정된 이메일만
필터링할 수 있습니다.
다음 표는 GitLab 고유 이메일 헤더 전체를 정리한 것입니다:



헤더
설명




List-Id
RFC 2919 메일링 리스트 식별자 형식의 프로젝트 경로입니다. 필터로 이메일을 정리할 때 사용할 수 있습니다.


X-GitLab-(Resource)-ID
알림 대상 리소스의 ID입니다. 리소스는 예를 들어 Issue, MergeRequest, Commit 또는 그 밖의 리소스일 수 있습니다.


X-GitLab-(Resource)-State
알림 대상 리소스의 상태입니다. 리소스는 예를 들어 Issue 또는 MergeRequest일 수 있습니다. 값은 opened, closed, merged, locked 중 하나일 수 있습니다.


X-GitLab-ConfidentialIssue
알림 대상 이슈의 비공개 여부를 나타내는 불리언 값입니다.


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-Group-Id
그룹의 ID입니다.


X-GitLab-Group-Path
그룹의 경로입니다.


X-GitLab-Group
알림이 속한 그룹의 이름입니다.


X-GitLab-Reply-Key
이메일 회신을 지원하는 고유 토큰입니다.



X-GitLab-NotificationReason#
X-GitLab-NotificationReason 헤더에는 알림 이유가 담깁니다.
값은 다음 중 하나이며, 우선순위 순서입니다:

own_activity
assigned
review_requested
mentioned
subscribed

알림 이유는 알림 이메일의 바닥글에도 포함됩니다.
예를 들어 이유가 assigned인 이메일은 바닥글에 다음 문장이 있습니다:
You are receiving this email because you have been assigned an item on <configured GitLab hostname>.

온콜 경고 알림#
온콜 경고
알림 이메일은 경고의 상태 중 하나를 가질 수 있습니다:

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 인스턴스가 있는지 다시
확인합니다.
이메일 알림을 켰으나 받지 못하는 경우#
GitLab에서 이메일 알림을 켰는데도 사용자가 예상대로 알림을 받지 못한다면, 해당 사용자의 이메일이 GitLab에서 확인되었는지, 그리고 이메일 공급자가 GitLab 인스턴스에서 보내는 이메일을 차단하고 있지 않은지 확인합니다. 많은 이메일 공급자(Outlook 등)는
잘 알려지지 않은 자체 관리 메일 서버 IP 주소에서 오는 이메일을 차단합니다. 확인하려면 인스턴스의
SMTP 서버에서 직접 이메일을 보내 봅니다. 예를 들어 Sendmail로 보내는 테스트 이메일은 다음과 비슷합니다:
# (echo subject: test; echo) | $(which sendmail) -v -Am -i <valid email address>

이메일 공급자가 메시지를 차단하고 있으면 다음과 같은 출력이 나올 수 있습니다(이메일 공급자와 SMTP 서버에 따라 다릅니다):
Diagnostic-Code: smtp; 550 5.7.1 Unfortunately, messages from [xx.xx.xx.xx]
weren't sent. For more information, please go to
http://go.microsoft.com/fwlink/?LinkID=526655 (http://go.microsoft.com/fwlink/?LinkID=526655) AS(900)

보통 이 문제는 SMTP 서버의 IP 주소를 메일 공급자의 허용 목록에 추가하면 해결됩니다.
자세한 방법은 메일 공급자의 문서를 확인합니다.