알림 이메일

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

GitLab에서 발생하는 활동에 대한 업데이트를 이메일 알림을 통해 받아보세요. 이슈, Merge Request, 이야기, 디자인에서의 활동에 대한 업데이트를 받을 수 있습니다.

사용자가 메시지를 보내는 데 사용할 수 있는 GitLab 관리자용 도구에 대해 알아보려면 GitLab에서의 이메일을 읽어보세요.

알림을 받는 대상

이슈, Merge Request 또는 이야기에 대한 알림이 활성화되면 GitLab는 해당 위치에서 발생한 동작에 대해 알림을 보냅니다.

다음 중 하나의 이유로 인해 알림을 받을 수 있습니다:

  1. GitLab는 사용자 언급을 포함하는 댓글을 편집할 때 알림을 보내지 않습니다.
note
관리자는 알림을 차단하여 보내지 않도록 설정할 수 있습니다.

알림 설정 편집

너무 많은 알림을 받는 것은 지치게 할 수 있습니다. 받는 알림을 조절할 수 있습니다. 예를 들어 특정 프로젝트에서 모든 활동에 대한 알림을 받고 싶을 수 있습니다. 다른 프로젝트의 경우, 자신의 이름으로 언급될 때만 알림을 받고 싶을 수도 있습니다.

이러한 알림 설정은 본인에게만 적용됩니다. 다른 사람이 받는 알림에 영향을 주지 않습니다.

알림 설정을 편집하려면:

  1. 왼쪽 사이드바에서 아바타를 선택합니다.
  2. 환경 설정을 선택합니다.
  3. 왼쪽 사이드바에서 알림을 선택합니다.
  4. 원하는 전역, 그룹 또는 프로젝트 알림 설정을 편집합니다. 편집된 설정은 자동으로 저장됩니다.

알림 범위

프로젝트 및 그룹마다 다른 알림 수준을 선택하여 알림 범위를 조절할 수 있습니다.

알림 범위는 가장 포괄적인 것에서 가장 구체적인 수준까지 적용됩니다.

  • 전역 알림 수준은 프로젝트나 그룹에서 활동이 발생한 곳에 알림 수준을 선택하지 않은 경우 적용됩니다.
  • 그룹 설정은 기본 설정을 재정의합니다.
  • 프로젝트 설정은 그룹 설정을 재정의합니다.

알림 수준

각 프로젝트 및 그룹에 대해 다음 중 하나의 수준을 선택할 수 있습니다:

수준 설명
전역 전역 설정이 적용됩니다.
관찰 모든 활동에 대해 알림을 받습니다.
참여 참여한 스레드에 대해 알림을 받습니다.
언급됨 댓글에서 언급될 때 알림을 받습니다.
비활성화 알림을 받지 않습니다.
사용자 정의 선택한 이벤트 및 참여한 스레드에 대해 알림을 받습니다.

전역 알림 설정

전역 알림 설정은 프로젝트 또는 그룹에 다른 값을 선택하지 않은 경우 기본 설정입니다.

  • 알림 이메일: 알림을 받을 이메일 주소. 기본 이메일 주소로 설정됩니다.
  • 전역 알림 수준: 모든 알림에 적용되는 기본 알림 수준.
  • 본인의 활동에 대한 알림 받기: 본인의 활동에 대한 알림을 받으려면 이 확인란을 선택합니다. 기본적으로 선택되지 않습니다.

그룹 알림

각 그룹에 대해 알림 수준과 이메일 주소를 선택할 수 있습니다.

그룹 알림 수준 변경

그룹에 대한 알림 수준을 선택하려면 다음 방법 중 하나를 사용합니다:

  1. 왼쪽 사이드바에서 아바타를 선택합니다.
  2. 환경 설정을 선택합니다.
  3. 왼쪽 사이드바에서 알림을 선택합니다.
  4. 그룹 섹션에서 그룹을 찾습니다.
  5. 원하는 알림 수준을 선택합니다.

또는:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 벨 아이콘 ({알림}) 옆의 알림 드롭다운 디렉터리을 선택합니다.
  3. 원하는 알림 수준을 선택합니다.

그룹 알림에 사용된 이메일 주소 변경

그룹에 대한 알림을 받을 이메일 주소를 선택할 수 있습니다. 예를 들어 프리랜서로 일하고 있고 클라이언트 프로젝트에 대한 이메일을 따로 받고 싶을 경우 등을 위해 그룹 알림을 사용할 수 있습니다.

  1. 왼쪽 사이드바에서 아바타를 선택합니다.
  2. 환경 설정을 선택합니다.
  3. 왼쪽 사이드바에서 알림을 선택합니다.
  4. 그룹 섹션에서 그룹을 찾습니다.
  5. 원하는 이메일 주소를 선택합니다.

프로젝트 알림 수준 변경

최신 정보를 받을 수 있도록 각 프로젝트에 대해 알림 수준을 선택할 수 있습니다.

프로젝트에 대한 알림 수준을 선택하려면 다음 방법 중 하나를 사용합니다:

  1. 왼쪽 사이드바에서 아바타를 선택합니다.
  2. 환경 설정을 선택합니다.
  3. 왼쪽 사이드바에서 알림을 선택합니다.
  4. 프로젝트 섹션에서 프로젝트를 찾습니다.
  5. 원하는 알림 수준을 선택합니다.

또는:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 벨 아이콘 ({알림}) 옆의 알림 드롭다운 디렉터리을 선택합니다.
  3. 원하는 알림 수준을 선택합니다.

새 릴리스에 대한 알림을 받으려면 릴리스 알림을 시청하세요.

알림 이벤트

사용자들은 다음 이벤트에 대해 알림을 받습니다:

이벤트 수신자 설정 수준
새 릴리스 프로젝트 구성원 사용자 정의 알림.
프로젝트 이동 프로젝트 구성원 비활성화를 제외한 다른 모든 수준에 전송됩니다.
이메일 주소 변경 사용자 보안 이메일, 항상 전송됩니다.
그룹 액세스 레벨 변경 사용자 사용자 그룹 액세스 레벨이 변경될 때 전송됩니다.
새 이메일 주소 추가 사용자 보안 이메일, 기본 이메일 주소로 전송됩니다.
새 이메일 주소 추가 사용자 보안 이메일, 새로 추가된 이메일 주소로 전송됩니다.
새 SAML/SCIM 사용자 프로비저닝 사용자 SAML/SCIM을 통해 사용자가 프로비저닝되면 전송됩니다.
새 SSH 키 추가 사용자 보안 이메일, 항상 전송됩니다.
새 사용자 생성 사용자 사용자 생성시 전송됩니다. (LDAP을 제외)
비밀번호 변경 사용자 보안 이메일, 사용자가 자신의 비밀번호를 변경할 때 항상 전송됩니다.
관리자에 의한 비밀번호 변경 사용자 보안 이메일, 관리자가 다른 사용자의 비밀번호를 변경할 때 항상 전송됩니다.
개인 액세스 토큰 만료 예정 사용자 보안 이메일, 항상 전송됩니다.
개인 액세스 토큰이 생성됨 사용자 보안 이메일, 항상 전송됩니다.
개인 액세스 토큰 만료 사용자 보안 이메일, 항상 전송됩니다.
개인 액세스 토큰이 폐기됨 사용자 보안 이메일, 항상 전송됨. GitLab 15.5에 도입.
그룹 액세스 토큰 만료 예정 그룹 소유자, 유지관리자 및 관리자 보안 이메일, 항상 전송됨. GitLab 16.4에 도입.
프로젝트 액세스 토큰 만료 예정 그룹 소유자, 유지관리자 및 관리자 보안 이메일, 항상 전송됨. GitLab 16.4에 도입.
프로젝트 액세스 레벨 변경 사용자 사용자 프로젝트 액세스 레벨이 변경되면 전송됩니다.
SSH 키 만료 사용자 보안 이메일, 항상 전송됩니다.
이중 인증 비활성화 사용자 보안 이메일, 항상 전송됩니다.
그룹에 사용자 추가 사용자 사용자가 그룹에 추가된 경우 전송됩니다.
프로젝트에 사용자 추가 사용자 사용자가 프로젝트에 추가된 경우 전송됩니다.
그룹 액세스 만료 그룹 구성원 사용자의 그룹 액세스가 7일 후 만료되는 경우 전송됩니다. GitLab 16.3에 도입.
프로젝트 액세스 만료 프로젝트 구성원 사용자의 프로젝트 액세스가 7일 후 만료되는 경우 전송됩니다. GitLab 16.3에 도입.

이슈, Merge Request 및 에픽에 대한 알림

또한 이슈, Merge Request 및 에픽에서 발생한 이벤트에 대한 알림을 받습니다.

이슈, Merge Request 및 에픽에 대한 알림 수신 대상

대부분의 이슈, Merge Request 및 에픽 이벤트에 대한 알림은 다음 대상에게 전송됩니다:

  • 참여자:
    • 작성자 및 지정자.
    • 코멘트 작성자.
    • 제목 또는 설명에서 사용자 이름으로 언급된 사람.
    • 댓글에서 사용자 이름으로 언급될 경우, 알림 수준이 “참여” 이상인 경우.
  • 감시자: 알림 수준이 “감시”인 사용자.
  • 구독자: 매뉴얼으로 알림을 구독한 사용자.
  • 사용자 지정: 해당 유형의 이벤트에 대한 알림을 켠 사용자 중 알림 수준이 “사용자 지정”인 사용자.

어떤 조치도 필요하지 않은 알림 수를 최소화하기 위해, 적격 승인자는 프로젝트의 모든 활동에 대해 알림을 받지 않습니다. 이러한 알림을 받으려면 해당 사용자는 사용자 알림 설정을 감시로 변경해야 합니다.

이슈, Merge Request 및 에픽에 대한 알림 설정 편집

이슈, Merge Request 또는 에픽에서 알림을 토글하려면 오른쪽 사이드바에서 알림 ({알림}) 토글을 켜거나 끕니다.

알림을 때는 토론에 참여하지 않았더라도 각 업데이트에 대한 알림을 시작합니다. 에픽에서 알림을 켜면 해당 에픽에 연결된 이슈에 자동으로 구독되지 않습니다.

알림을 때는 업데이트에 대한 알림을 더 이상 받지 않습니다. 이 토글을 끄면 해당 이슈, Merge Request 또는 에픽에 관련된 업데이트에 대한 구독이 취소됩니다. GitLab의 모든 GitLab 이메일 중단 방법을 알아보세요.

이슈, Merge Request 및 에픽에 대한 알림 이벤트

다음 표는 이슈, Merge Request 및 에픽에 대한 알림을 생성하는 이벤트를 보여줍니다:

유형 이벤트 수신 대상
에픽 종료 구독자 및 참여자.
에픽 새로 만들기 설명에서 사용자 이름으로 언급된 사람 중 알림 수준이 “언급” 이상인 사람.
에픽 새로운 노트 참여자, 감시자, 구독자 및 사용자 지정 알림 수준이 이 이벤트가 선택된 사람. 또한 댓글에서 사용자 이름으로 언급된 사람 중 알림 수준이 “언급” 이상인 사람.
에픽 다시 열기 구독자 및 참여자.
이슈 종료 구독자 및 참여자.
이슈 기한 만료 참여자 및 사용자 지정 알림 수준이 이 이벤트가 선택된 사람.
이슈 마일스톤 변경 구독자 및 참여자.
이슈 마일스톤 제거 구독자 및 참여자.
이슈 새로 만들기 설명에서 사용자 이름으로 언급된 사람 중 알림 수준이 “언급” 이상인 사람.
이슈 새로운 노트 참여자, 감시자, 구독자 및 사용자 지정 알림 수준이 이 이벤트가 선택된 사람. 또한 댓글에서 사용자 이름으로 언급된 사람 중 알림 수준이 “언급” 이상인 사람.
이슈 제목 또는 설명 변경 새로운 언급된 사람.
이슈 다시 할당 참여자, 감시자, 구독자 및 사용자 지정 알림 수준이 이 이벤트가 선택된 사람. 이전 지정자도 포함됩니다.
이슈 다시 열기 구독자 및 참여자.
Merge Request 종료 구독자 및 참여자.
Merge Request 충돌 작성자 및 Merge Request을 자동 Merge으로 설정한 사용자.
Merge Request 준비 상태로 표시 감시자 및 참여자.
Merge Request Merge됨 구독자 및 참여자.
Merge Request 파이프라인 성공 시 Merge됨 작성자, 참여자, 감시자, 구독자 및 이 이벤트가 선택된 사용자 지정 알림 수준. 작성자, 감시자 및 구독자에게는 사용자 지정 알림 수준이 무시됩니다.
Merge Request 마일스톤 변경 구독자 및 참여자.
Merge Request 마일스톤 제거 구독자 및 참여자.
Merge Request 새로 만들기 설명에서 사용자 이름으로 언급된 사람 중 알림 수준이 “언급” 이상인 사람.
Merge Request 새로운 노트 참여자, 감시자, 구독자 및 사용자 지정 알림 수준이 이 이벤트가 선택된 사람. 또한 댓글에서 사용자 이름으로 언급된 사람 중 알림 수준이 “언급” 이상인 사람.
Merge Request 푸시됨 참여자 및 사용자 지정 알림 수준이 이 이벤트가 선택된 사람.
Merge Request 다시 할당 참여자, 감시자, 구독자 및 사용자 지정 알림 수준이 이 이벤트가 선택된 사람. 이전 지정자도 포함됩니다.
Merge Request 검토 요청됨 참여자, 감시자, 구독자 및 사용자 지정 알림 수준이 이 이벤트가 선택된 사람. 이전 검토자도 포함됩니다.
Merge Request 다시 열기 구독자 및 참여자.
Merge Request 제목 또는 설명 변경 새로운 언급된 사람.
Merge Request 승인자로 추가됨 이 이벤트가 선택된 사용자 지정 알림 수준. GitLab 16.7에서 도입.
파이프라인 실패함 파이프라인 작성자.
파이프라인 수정됨 파이프라인 작성자. 기본적으로 활성화됨.
파이프라인 성공함 파이프라인 작성자, 성공한 파이프라인에 대해 성공 알림 수준이 있는 사용자 지정 알림 수준. 이전에 파이프라인이 실패했다면, 첫 번째 성공한 파이프라인에 대해 “수정된 파이프라인” 메시지를 보내고, 이후에는 계속 “성공한 파이프라인” 메시지를 보냅니다.

기본적으로 자신이 만든 이슈, Merge Request 또는 에픽에 대해 알림을 받지 않습니다. 자신이 만든 이슈, Merge Request 등에 항상 알림을 받으려면 자체 활동에 대한 알림 수신을 켜세요.

알 수 없는 로그인에 대한 알림

  • 전체 이름 및 사용자 이름을 나열하는 사람에 대한 알림은 GitLab 15.10에 도입되었습니다.
note
이 기능은 Self-Managed형되는 인스턴스에서 기본적으로 활성화됩니다. 관리자는 UI의 로그인 제한 섹션을 통해 이 기능을 비활성화할 수 있습니다. 이 기능은 GitLab.com에서 항상 활성화됩니다.

이미 알려진 IP 주소나 기기에서 사용자가 성공적으로 로그인하면 GitLab은 이메일로 사용자에게 알립니다. 이를 통해 GitLab은 잠재적으로 해로운 또는 무단의 로그인 시도를 프로액티브하게 사용자에게 경보합니다. 이 알림 이메일에는 다음이 포함됩니다:

  • 호스트 이름.
  • 사용자 이름 및 사용자 이름.
  • IP 주소.
  • 로그인 날짜 및 시간.

GitLab은 이미 알려진 로그인을 식별하기 위해 여러 방법을 사용합니다. 알림 이메일을 보내려면 모든 방법이 실패해야 합니다.

  • 마지막 로그인 IP: 현재 로그인 IP 주소를 마지막으로 로그인한 IP 주소와 비교합니다.
  • 현재 활성 세션: 사용자가 동일한 IP 주소에서 기존 활성 세션을 가지고 있는지 확인합니다. 활성 세션 참조.
  • 쿠키: 성공적인 로그인 이후에 브라우저에 암호화된 쿠키가 저장됩니다. 이 쿠키는 마지막 성공한 로그인 후 14일 후에 만료됩니다.

잘못된 인증 코드 사용으로 시도한 로그인에 대한 알림

GitLab은 사용자가 잘못된 이중 인증(2FA) 코드를 사용하여 계정에 로그인을 시도할 경우 이메일 알림을 보냅니다. 이를 통해 사용자는 악의적인 사용자가 사용자 이름과 암호에 액세스하고 있는지, 그리고 2FA를 무력화하려는 경우를 감지할 수 있습니다.

디자인에 대한 알림

누군가 디자인에 대해 코멘트를 작성하면 참여자에게 이메일 알림이 전송됩니다.

참여자는 다음과 같습니다:

  • 디자인의 작성자(다른 작성자가 다른 버전의 디자인을 업로드했다면 여러 사람일 수 있음).
  • 디자인에 대한 코멘트의 작성자.
  • 디자인 코멘트에서 언급된 누구라도.

그룹 또는 프로젝트 액세스 만료에 대한 알림

GitLab은 사용자의 그룹 또는 프로젝트 액세스가 7일 후에 만료되면 이메일 알림을 보냅니다. 이는 그룹 또는 프로젝트 구성원들이 액세스 기간을 연장하고 싶다면 상기시키는 역할을 합니다.

모든 GitLab 이메일 수신 거부

더 이상 이메일 알림을 받고 싶지 않다면:

  1. 좌측 사이드바에서 아바타를 선택합니다.
  2. 설정을 선택합니다.
  3. 좌측 사이드바에서 알림을 선택합니다.
  4. 글로벌 알림 수준비활성화로 설정합니다.
  5. 내 활동에 대한 알림 수신 확인란을 해제합니다.
  6. 그룹 또는 프로젝트에 속해있다면, 그들의 알림 설정을 글로벌 또는 비활성화로 설정합니다.

Self-Managed형 설치의 경우, 이를 해도 인스턴스 관리자는 여전히 이메일을 보낼 수 있습니다. 구독 취소하려면 이메일 중 하나의 구독 취소 링크를 선택합니다.

이메일 필터링에 사용할 수 있는 이메일 헤더

알림 이메일 메시지에는 GitLab 특정 헤더가 포함되어 있습니다. 알림을 더 잘 관리하기 위해, 이러한 헤더의 내용을 기반으로 알림 이메일을 필터링할 수 있습니다.

예를 들어, 특정 프로젝트로부터 할당된 Merge Request이나 이슈가 있는 모든 이메일을 필터링할 수 있습니다.

다음 표는 모든 GitLab 특정 이메일 헤더를 나열합니다:

헤더 설명
List-Id 이메일 정리를 위해 RFC 2919 메일링 디렉터리 식별자 내의 프로젝트 경로입니다. 필터와 함께 이를 사용할 수 있습니다.
X-GitLab-(Resource)-ID 알림 대상 자원의 ID입니다. 예를 들어 자원은 이슈, Merge Request, 커밋 등일 수 있습니다.
X-GitLab-(Resource)-State 알림 대상 자원의 상태입니다. 자원은 이슈 또는 Merge Request 등이 될 수 있습니다. 값은 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-Reply-Key 이메일 답장을 지원하기 위한 고유한 토큰입니다.

X-GitLab-NotificationReason

X-GitLab-NotificationReason 헤더에는 알림의 이유가 포함되어 있습니다. 값은 다음과 같이 우선순위 순으로 하나입니다:

  • own_activity
  • assigned
  • review_requested
  • mentioned
  • subscribed

알림의 이유는 또한 알림 이메일의 푸터에도 포함됩니다. 예를 들어, assigned 이유를 가진 이메일에는 다음 문장이 푸터에 포함됩니다:

구성된 GitLab 호스트네임에 할당된 항목이 있기 때문에 이 이메일을받게되었습니다.

당직 알림 알림

Tier: Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

당직 경보 알림 이메일은 경보의 상태 중 하나일 수 있습니다:

  • alert_triggered
  • alert_acknowledged
  • alert_resolved
  • alert_ignored

사건 에스컬레이션 알림

Tier: Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

사건 에스컬레이션 알림 이메일은 사건의 상태 중 하나일 수 있습니다:

  • incident_triggered
  • incident_acknowledged
  • incident_resolved
  • incident_ignored

X-GitLab-NotificationReason 헤더에 포함된 이벤트 디렉터리을 확장하는 것은 이슈 20689에서 추적됩니다.

문제 해결

알림을 받을 수신자 디렉터리 가져오기

특정 프로젝트로부터 알림을 받을 수신자 디렉터리을 가져오고 싶다면 (대부분 사용자 지정 알림에 대한 문제 해결에 사용됨), Rails 콘솔에서 sudo gitlab-rails c를 실행하고 프로젝트 이름을 업데이트하십시오:

project = Project.find_by_full_path '<프로젝트 이름>'
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 인스턴스가 중복되었는지 확인하십시오.