알림 이메일
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
이메일 알림으로 GitLab에서 일어나는 일을 항상 파악하세요. GitLab 관리자가 사용자에게 메시지를 보내는 데 사용할 수 있는 도구에 대해서는 GitLab에서 이메일 보내기를 참조하세요. GitLab 17.2 이상에서는 알림이 속도 제한됩니다.
히스토리
- Enhanced email styling introduced in GitLab 14.9 with a feature flag named
enhanced_notify_css. Disabled by default. - Enhanced email styling enabled on GitLab.com in GitLab 14.9.
- Enhanced email styling enabled on GitLab Self-Managed in GitLab 15.0.
- Enhanced email styling generally available in GitLab 18.3. Feature flag
enhanced_notify_cssremoved. - Product marketing emails removed in GitLab 16.6.
이메일 알림으로 GitLab에서 일어나는 일을 항상 파악하세요. 이슈, 머지 리퀘스트, 에픽, 디자인의 활동에 대한 업데이트를 받을 수 있습니다.
GitLab 관리자가 사용자에게 메시지를 보내는 데 사용할 수 있는 도구에 대해서는 GitLab에서 이메일 보내기를 참조하세요.
GitLab 17.2 이상에서는 알림이 속도 제한됩니다. 24시간마다 프로젝트 또는 그룹별로 사용자당 제한이 적용됩니다.
알림을 받는 사람#
이슈, 머지 리퀘스트, 에픽에 대한 알림이 활성화된 경우 GitLab은 그곳에서 발생하는 작업에 대해 알립니다.
다음 이유 중 하나로 알림을 받을 수 있습니다:
- 이슈, 머지 리퀘스트, 에픽, 디자인에 참여한 경우. 댓글을 달거나 편집하거나 누군가가 사용자 이름을 언급하면 참여자가 됩니다.
- 이슈, 머지 리퀘스트, 에픽에서 알림을 활성화한 경우.
- 프로젝트 또는 그룹에 대해 알림을 구성한 경우.
- 파이프라인 이메일 통합을 통해 그룹 또는 프로젝트 파이프라인 알림을 구독한 경우.
다음 경우에는 GitLab이 알림을 보내지 않습니다:
- 계정이 프로젝트 봇인 경우.
- 계정이 기본 이메일 주소를 가진 서비스 계정인 경우.
- 계정이 차단(금지됨) 또는 비활성화된 경우.
- 관리자가 알림을 차단한 경우.
전역 알림 설정#
전역 알림 설정은 프로젝트나 그룹에 대해 다른 설정을 지정하지 않는 한 기본 설정입니다. 예를 들어 특정 프로젝트의 모든 활동에 대한 알림을 받고 싶을 수 있습니다. 다른 프로젝트에서는 이름이 언급될 때만 알림을 받고 싶을 수 있습니다.
이 알림 설정은 자신에게만 적용됩니다. 다른 사람이 받는 알림에는 영향을 주지 않습니다.
알림 설정 편집#
알림 설정을 편집하려면:
- 오른쪽 상단에서 아바타를 선택합니다.
- 환경 설정을 선택합니다.
- 왼쪽 사이드바에서 알림을 선택합니다.
- 전역 알림 이메일에 알림을 받을 이메일 주소를 입력합니다. 기본적으로 기본 이메일 주소로 설정됩니다.
- 전역 알림 수준에서 알림에 적용할 기본 알림 수준을 선택합니다.
- 내 활동에 대한 알림 받기 체크박스를 선택하여 자신의 활동에 대한 알림을 받습니다. 기본적으로 선택되지 않습니다.
알림 수준#
각 프로젝트와 그룹의 오른쪽에서 알림 수준을 선택할 수 있습니다:
| 수준 | 설명 |
|---|---|
| 전역 | 기본 전역 설정이 적용됩니다. |
| 감시 | 대부분의 활동에 대한 알림을 받습니다. |
| 참여 | 참여한 스레드에 대한 알림을 받습니다. |
| 언급 시 | 댓글에서 언급될 때 알림을 받습니다. |
| 비활성화 | 알림을 받지 않습니다. |
| 사용자 정의 | 참여와 동일하며, 선택한 추가 알림 이벤트도 포함됩니다. |
알림 범위#
각 프로젝트와 그룹에 대해 서로 다른 알림 수준을 선택하여 알림 범위를 조정할 수 있습니다.
알림 범위는 가장 넓은 범위에서 가장 구체적인 범위로 적용됩니다:
- 활동이 발생한 프로젝트 또는 그룹에 대해 알림 수준을 선택하지 않은 경우 전역(기본) 알림 수준이 적용됩니다.
- 그룹 설정이 기본 설정을 재정의합니다.
- 프로젝트 설정이 그룹 설정을 재정의합니다.
프로젝트 또는 서브그룹의 알림 수준을 전역으로 설정하면 전역 알림 설정을 직접 상속하지 않습니다. 대신 계층 구조를 따라 올라가며 다음 순서로 구성된 전역이 아닌 다음 알림 수준을 상속합니다:
- 프로젝트 설정.
- 상위 그룹 설정.
- 조상 그룹 설정(계층 구조를 따라 올라가며).
- 최종 대체 설정으로 전역 알림 설정.
예를 들어 기본 전역 알림 설정을 감시로 설정하고 그룹과 프로젝트 알림 수준을 다음과 같이 설정한 경우:
소스 코드 보기
%%{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 .-> B</code></pre></details></div>
프로젝트 C는 서브그룹 B에서 참여 알림 수준을 상속합니다.
전역 알림 설정에서 감시 알림 수준을 상속하지 않습니다.
그룹 알림#
각 그룹에 대해 알림 수준과 이메일 주소를 선택할 수 있습니다.
그룹 알림 수준 변경#
그룹의 알림 수준을 선택하려면 다음 방법 중 하나를 사용합니다:
- 오른쪽 상단에서 아바타를 선택합니다.
- 환경 설정을 선택합니다.
- 왼쪽 사이드바에서 알림을 선택합니다.
- 그룹 섹션에서 그룹을 찾습니다.
- 원하는 알림 수준을 선택합니다.
또는:
- 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 벨 아이콘([notifications]) 옆의 알림 드롭다운 목록을 선택합니다.
- 원하는 알림 수준을 선택합니다.
그룹 알림에 사용되는 이메일 주소 변경#
속한 각 그룹의 알림을 받을 이메일 주소를 선택할 수 있습니다.
예를 들어 프리랜서로 일하면서 고객 프로젝트에 대한 이메일을 별도로 유지하려는 경우 그룹 알림을 사용할 수 있습니다.
- 오른쪽 상단에서 아바타를 선택합니다.
- 환경 설정을 선택합니다.
- 왼쪽 사이드바에서 알림을 선택합니다.
- 그룹 섹션에서 그룹을 찾습니다.
- 원하는 이메일 주소를 선택합니다.
프로젝트 알림 수준 변경#
최신 상태를 유지하려면 각 프로젝트에 대해 알림 수준을 선택할 수 있습니다.
프로젝트의 알림 수준을 선택하려면 다음 방법 중 하나를 사용합니다:
- 오른쪽 상단에서 아바타를 선택합니다.
- 환경 설정을 선택합니다.
- 왼쪽 사이드바에서 알림을 선택합니다.
- 프로젝트 섹션에서 프로젝트를 찾습니다.
- 원하는 알림 수준을 선택합니다.
또는:
- 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 벨 아이콘([notifications]) 옆의 알림 드롭다운 목록을 선택합니다.
- 원하는 알림 수준을 선택합니다.
새 릴리스가 제공될 때 알림을 받는 방법을 알아보려면 릴리스 알림을 시청하세요.
알림 이벤트#
알림은 사용자, 프로젝트, 그룹 이벤트 및 작업 항목 활동에 대해 전송됩니다.
사용자 이벤트#
히스토리
- Notification for personal access token rotated introduced in GitLab 18.3.
사용자 알림 이벤트:
이벤트
수신자
세부 정보
이메일 변경됨
사용자
보안 이메일, 항상 전송됨.
그룹 액세스 수준 변경됨
사용자
새 이메일 주소 추가됨
사용자
보안 이메일, 새로 추가된 이메일 주소로 전송됨.
새 이메일 주소 추가됨
사용자
보안 이메일, 기본 이메일 주소로 전송됨.
새 SSH 키 추가됨
사용자
보안 이메일, 항상 전송됨.
새 사용자 생성됨
사용자
OmniAuth(LDAP)를 제외하고 사용자 생성 시 전송됨.
비밀번호 변경됨
사용자
보안 이메일, 사용자가 자신의 비밀번호를 변경할 때 항상 전송됨.
관리자에 의해 비밀번호 변경됨
사용자
보안 이메일, 관리자가 다른 사용자의 비밀번호를 변경할 때 항상 전송됨.
개인 액세스 토큰이 취소됨
사용자
보안 이메일, 항상 전송됨.
개인 액세스 토큰이 교체됨
사용자
보안 이메일, 항상 전송됨.
개인 액세스 토큰이 곧 만료됨
사용자
보안 이메일, 항상 전송됨.
개인 액세스 토큰이 생성됨
사용자
보안 이메일, 항상 전송됨.
개인 액세스 토큰이 만료됨
사용자
보안 이메일, 항상 전송됨.
SSH 키가 만료됨
사용자
보안 이메일, 항상 전송됨.
이중 인증이 비활성화됨
사용자
보안 이메일, 항상 전송됨.
프로젝트 이벤트#
히스토리
- Notification for project access expired introduced in GitLab 16.3.
- Notification for project access tokens expiring soon introduced in GitLab 16.4.
- Notification for project deploy tokens expiring soon introduced in GitLab 18.3.
- Notification for project scheduled for deletion introduced in GitLab 17.11.
프로젝트 알림 이벤트:
이벤트
수신자
세부 정보
새 릴리스
프로젝트 구성원
릴리스가 생성됨 사용자 정의 알림 수준이 선택된 경우에만 전송됨.
프로젝트 액세스 만료됨
프로젝트 구성원
7일 후 사용자의 프로젝트 액세스가 만료될 때 전송됨.
프로젝트 액세스 수준 변경됨
프로젝트 구성원
사용자 프로젝트 액세스 수준이 변경될 때 전송됨.
프로젝트 액세스 토큰이 곧 만료됨
직접 프로젝트 소유자 및 유지 관리자
보안 이메일, 항상 전송됨.
프로젝트 배포 토큰이 곧 만료됨
프로젝트 소유자 및 유지 관리자
보안 이메일, 항상 전송됨.
프로젝트 이동됨
프로젝트 구성원
비활성화를 제외한 모든 알림 수준에서 전송됨 또는 프로젝트가 이동됨 사용자 정의 알림 수준이 선택된 경우.
프로젝트가 삭제 예약됨
프로젝트 소유자
프로젝트가 삭제 예약될 때 전송됨.
프로젝트에 사용자 추가됨
사용자
사용자가 프로젝트에 추가될 때 전송됨.
그룹 이벤트#
히스토리
- Notification for group access expired introduced in GitLab 16.3.
- Notification for group access tokens expiring soon introduced in GitLab 16.4.
- Notification for group scheduled for deletion introduced in GitLab 17.11.
그룹 알림 이벤트:
이벤트
수신자
세부 정보
그룹 액세스 만료됨
그룹 구성원
7일 후 사용자의 그룹 액세스가 만료될 때 전송됨.
그룹 액세스 토큰이 곧 만료됨
직접 그룹 소유자
보안 이메일, 항상 전송됨.
그룹이 삭제 예약됨
그룹 소유자
그룹이 삭제 예약될 때 전송됨.
그룹에 사용자 추가됨
사용자
사용자가 그룹에 추가될 때 전송됨.
새 SAML/SCIM 사용자 프로비저닝됨
사용자
SAML/SCIM을 통해 사용자가 프로비저닝될 때 전송됨.
이슈, 머지 리퀘스트, 에픽 이벤트#
히스토리
- Notifications for merge requests you're eligible to approve introduced in GitLab 16.7 and renamed in GitLab 17.11.
- Service account pipeline notifications introduced in GitLab 18.1.
이벤트는 선택된 알림 수준에 따라 알림을 생성합니다.
일부 알림은 사용자 정의 알림 수준을 선택하고 원하는 이벤트를 선택하여 선택적으로 활성화할 수 있습니다. 에픽, 이슈, 머지 리퀘스트에 대해 수동으로 알림을 구독할 수도 있습니다.
기본적으로 자신이 생성한 이슈, 머지 리퀘스트, 에픽에 대한 알림을 받지 않습니다.
자신의 활동에 대한 알림을 켤 수 있습니다.
에픽 이벤트 알림은 다음 알림 수준에서 전송됩니다:
이벤트
감시
참여
언급 시
구독
사용자 정의
추가 세부 정보
종료됨
예
예
예
예
새 에픽
예
예
예
예
설명에서 사용자 이름으로 언급될 때 전송됨.
새 댓글
예
예
예
예
댓글이 추가됨이 선택된 경우
댓글에서 사용자 이름으로 언급될 때도 전송됨.
재오픈됨
예
예
예
예
이슈 이벤트 알림은 다음 알림 수준에서 전송됩니다:
이벤트
감시
참여
언급 시
구독
사용자 정의
추가 세부 정보
종료됨
예
예
예
이슈가 종료됨이 선택된 경우
내일 마감됨
예
이슈가 내일 마감됨이 선택된 경우
알림은 서버 시간대(GitLab.com의 경우 UTC) 00:50에 다음 날 마감 날짜가 있는 열린 이슈에 대해 전송됨.
마일스톤 변경됨
예
예
예
예
마일스톤 제거됨
예
예
예
예
새 이슈
예
예
예
이슈가 생성됨이 선택된 경우
설명에서 사용자 이름으로 언급될 때도 전송됨.
새 댓글
예
예
예
예
댓글이 추가됨이 선택된 경우
댓글에서 사용자 이름으로 언급될 때도 전송됨.
제목 또는 설명 변경됨
예
예
사용자 이름으로 새 언급이 있는 경우.
재배정됨
예
예
예
이슈가 재배정됨이 선택된 경우
이전 담당자에게도 전송됨.
재오픈됨
예
예
예
이슈가 재오픈됨이 선택된 경우
머지 리퀘스트 알림은 다음 알림 수준에서 전송됩니다:
이벤트
감시
참여
언급 시
구독
사용자 정의
추가 세부 정보
종료됨
예
예
예
머지 리퀘스트가 종료됨이 선택된 경우
충돌
예
작성자와 머지 리퀘스트를 자동 병합으로 설정한 모든 사용자.
준비 완료로 표시됨
예
예
예
병합됨
예
예
예
머지 리퀘스트가 병합됨이 선택된 경우
자동 병합으로 설정됨
예
예
예
머지 리퀘스트가 자동 병합으로 설정됨이 선택된 경우
작성자, 감시자, 구독자의 사용자 정의 알림 수준은 무시됨.
마일스톤 변경됨
예
예
예
예
마일스톤 제거됨
예
예
예
예
새 머지 리퀘스트
예
예
예
머지 리퀘스트가 생성됨이 선택된 경우
설명에서 사용자 이름으로 언급된 모든 사용자.
새 댓글
예
예
예
예
댓글이 추가됨이 선택된 경우
댓글에서 사용자 이름으로 언급된 모든 사용자.
새 푸시
예
머지 리퀘스트가 푸시를 받음이 선택된 경우
재배정됨
예
예
예
머지 리퀘스트가 재배정됨이 선택된 경우
이전 담당자에게도 전송됨.
검토자 변경됨
예
예
예
머지 리퀘스트 검토자가 변경됨이 선택된 경우
이전 검토자에게도 전송됨.
재오픈됨
예
예
예
머지 리퀘스트가 재오픈됨이 선택된 경우
제목 또는 설명 변경됨
예
예
사용자 이름으로 새 언급이 있는 경우.
승인 자격이 있는 새 머지 리퀘스트.
승인 자격이 있는 머지 리퀘스트가 생성됨이 선택된 경우
특정 이슈, 머지 리퀘스트, 에픽에 대한 알림 구독#
특정 이슈, 머지 리퀘스트, 에픽의 알림을 토글하려면:
- 오른쪽 사이드바 상단에서 다음을 선택합니다:
- 알림 켜기 ([notifications]) - 알림을 활성화합니다.
- 알림 끄기 ([notifications-off]) - 알림을 비활성화합니다.
이동된 알림#
히스토리
- Introduced in GitLab 16.5 with a flag named
notifications_todos_buttons. Disabled by default.
Feature flag
이 기능의 가용성은 기능 플래그에 의해 제어됩니다. 자세한 내용은 히스토리를 참조하세요. 이 기능 플래그를 활성화하면 알림과 할 일 항목 버튼이 페이지의 오른쪽 상단으로 이동합니다.
알림을 켜면 토론에 참여하지 않았더라도 각 업데이트에 대한 알림을 받기 시작합니다.
에픽에서 알림을 켜면 에픽에 연결된 이슈를 자동으로 구독하지 않습니다.
알림을 끄면 업데이트에 대한 알림 수신을 중단합니다.
이 토글을 끄면 이 이슈, 머지 리퀘스트, 에픽과 관련된 업데이트만 구독 취소됩니다.
GitLab의 모든 이메일 거부하는 방법을 알아보세요.
CI/CD 파이프라인 이벤트#
CI/CD 파이프라인 이벤트 알림은 파이프라인을 생성한 사용자에게 다음 알림 수준에서 전송됩니다:
이벤트
감시
사용자 정의
추가 세부 정보
실패
예
파이프라인이 실패함이 선택된 경우
수정됨
파이프라인이 수정됨이 선택된 경우
성공
예
파이프라인이 성공함이 선택된 경우
파이프라인이 이전에 실패한 경우 실패 후 첫 번째 성공한 파이프라인에 대해 "파이프라인 수정됨" 메시지가 전송되고 이후 성공한 파이프라인에 대해 "성공한 파이프라인" 메시지가 전송됨.
서비스 계정 파이프라인 이벤트 알림은 다음 알림 수준에서 전송됩니다:
이벤트
감시
사용자 정의
실패
예
서비스 계정의 파이프라인이 실패함이 선택된 경우
수정됨
서비스 계정의 파이프라인이 수정됨이 선택된 경우
성공
예
서비스 계정의 파이프라인이 성공함이 선택된 경우
이슈 501083은 모든 이벤트를 감시 수준에 추가하는 것을 추적합니다.
특정 이벤트 비활성화#
GitLab Self-Managed 및 GitLab Dedicated에서 항상 전송 보안 이메일을 비활성화하려면
인스턴스 관리자가 개별 백그라운드 작업을 비활성화할 수 있습니다.
예를 들어:
personal_access_tokens_expiring_worker
personal_access_tokens_expired_notification_worker
ssh_keys_expiring_soon_notification_worker
ssh_keys_expired_notification_worker
send_recurring_notifications_worker
deploy_tokens_expiring_worker
members_expiring_worker
알 수 없는 로그인에 대한 알림#
히스토리
- Listing the full name and username of the signed-in user introduced in GitLab 15.10.
- Geographic location added in GitLab 17.5.
Note
이 기능은 GitLab Self-Managed 인스턴스에서 기본적으로 활성화됩니다. 관리자는 UI의 로그인 제한 섹션을 통해 이 기능을 비활성화할 수 있습니다.
이 기능은 GitLab.com에서 항상 활성화됩니다.
사용자가 이전에 알 수 없는 IP 주소 또는 기기에서 성공적으로 로그인하면
GitLab은 이메일로 사용자에게 알립니다. 이를 통해 GitLab은 잠재적으로 악의적이거나 무단 로그인에 대해 사용자에게 사전에 경고합니다. 이 알림 이메일에는 다음이 포함됩니다:
- 호스트 이름.
- 사용자의 이름과 사용자 이름.
- IP 주소.
- 지리적 위치.
- 로그인 날짜 및 시간.
GitLab은 알려진 로그인을 식별하기 위해 여러 방법을 사용합니다. 알림 이메일을 보내려면 모든 방법이 실패해야 합니다.
- 마지막 로그인 IP: 현재 로그인 IP 주소를 마지막 로그인 IP 주소와 비교합니다.
- 현재 활성 세션: 사용자가 동일한 IP 주소에서 기존 활성 세션을 가지고 있는 경우. 활성 세션을 참조하세요.
- 쿠키: 성공적인 로그인 후 암호화된 쿠키가 브라우저에 저장됩니다.
이 쿠키는 마지막 성공 로그인 후 14일이 지나면 만료됩니다.
잘못된 인증 코드를 사용한 로그인 시도에 대한 알림#
히스토리
- Introduced in GitLab 15.5.
GitLab은 잘못된 이중 인증(2FA) 코드를 사용하여 계정에 로그인 시도가 감지되면 이메일 알림을 보냅니다. 이를 통해 나쁜 행위자가 사용자 이름과 비밀번호에 접근하고 2FA를 무차별 대입 공격하려 한다는 것을 감지하는 데 도움이 됩니다.
디자인에 대한 알림#
누군가가 디자인에 댓글을 달면 이메일 알림이 참여자에게 전송됩니다.
참여자는 다음과 같습니다:
- 디자인 작성자(다른 작성자가 다른 버전의 디자인을 업로드한 경우 여러 명일 수 있음).
- 디자인 댓글 작성자.
- 디자인의 댓글에서 언급된 모든 사람.
그룹 또는 프로젝트 액세스 만료에 대한 알림#
히스토리
- Introduced in GitLab 16.3.
GitLab은 사용자의 그룹 또는 프로젝트 액세스가 7일 후에 만료되는 경우 이메일 알림을 보냅니다.
이는 그룹 또는 프로젝트 구성원이 원하는 경우 액세스 기간을 연장하도록 상기시켜 줍니다.
모든 GitLab 이메일 거부#
이메일 알림을 더 이상 받고 싶지 않은 경우:
- 오른쪽 상단에서 아바타를 선택합니다.
- 환경 설정을 선택합니다.
- 왼쪽 사이드바에서 알림을 선택합니다.
- 전역 알림 수준을 비활성화로 설정합니다.
- 내 활동에 대한 알림 받기 체크박스를 선택 취소합니다.
- 그룹이나 프로젝트에 속해 있는 경우 해당 알림 설정을 전역 또는 비활성화로 설정합니다.
GitLab Self-Managed 및 Dedicated 인스턴스에서는 이렇게 해도 특정 이벤트 알림은 여전히 전송됩니다:
- 인스턴스 관리자가 여전히 이메일을 보낼 수 있음
항상 전송인 알림 이벤트
알림 이메일 구독 취소#
GitLab에서 리소스별(예: 특정 이슈)로 알림 이메일을 구독 취소할 수 있습니다.
구독 취소 링크 사용#
GitLab의 모든 알림 이메일 하단에는 구독 취소 링크가 있습니다.
구독 취소하려면:
- 이메일에서 구독 취소 링크를 선택합니다.
- 브라우저에서 GitLab에 로그인되어 있으면 즉시 구독 취소됩니다.
- 로그인되어 있지 않으면 작업을 확인해야 합니다.
이메일 클라이언트 또는 기타 소프트웨어 사용#
이메일 클라이언트는 GitLab의 이메일을 볼 때 구독 취소 버튼을 표시할 수 있습니다.
구독 취소하려면 이 버튼을 선택합니다.
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일 수 있습니다. GitLab 16.4에서 도입됨.
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-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 주소를 메일 공급자의 허용 목록에 추가하여 해결할 수 있습니다. 지침은 메일 공급자의 문서를 확인하세요.
