• 누가 알림을 받는가
• 알림 설정 편집
  • 알림 범위
  • 알림 수준
  • 글로벌 알림 설정
  • 그룹 알림
    • 그룹 알림 수준 변경
    • 그룹 알림에 사용할 이메일 주소 변경
  • 프로젝트 알림 수준 변경
• 알림 이벤트
• 문제, 병합 요청 및 에픽에 대한 알림
  • 문제, 병합 요청 및 에픽에 대한 알림을 받는 사람
  • 문제, 병합 요청 및 에픽에 대한 알림 설정 편집
  • 문제, 병합 요청 및 에픽에 대한 알림 이벤트
• 알림: 알려지지 않은 로그인
• 잘못된 인증 코드로 시도된 로그인에 대한 알림
• 디자인에 대한 알림
• 그룹 또는 프로젝트 접근 만료에 대한 알림
• 모든 GitLab 이메일 수신 거부
• 이메일 헤더를 사용하여 이메일 필터링하기
  • X-GitLab-NotificationReason
    • 온콜 경고 알림
    • 사고 에스컬레이션 알림
• 문제 해결
  • 알림을 받을 수신자 목록 가져오기
  • 존재하지 않는 실패한 파이프라인에 대한 알림
  • 이메일 알림이 활성화되지만 수신되지 않는 경우

알림 이메일

• GitLab 14.9에서 도입된 향상된 이메일 스타일링 기능 플래그 enhanced_notify_css로 명명되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 14.9에서 GitLab.com에 활성화된 향상된 이메일 스타일링.
• GitLab 15.0에서 자체 관리에 활성화된 향상된 이메일 스타일링.
• GitLab 16.6에서 제거된 제품 마케팅 이메일.

이메일 알림을 통해 GitLab에서 발생하는 사항에 대한 최신 정보를 얻으세요.
문제, 병합 요청, 에픽 및 디자인에서 활동에 대한 업데이트를 받을 수 있습니다.

GitLab 관리자가 사용자에게 메시지를 보내는 데 사용할 수 있는 도구에 대한 내용은
GitLab에서 이메일을 읽어보세요.

GitLab 17.2 및 이후 버전에서는 알림이 제한됩니다
프로젝트 또는 그룹당 사용자당 24시간 기준으로.

누가 알림을 받는가

문제, 병합 요청 또는 에픽에 대해 알림이 활성화되면, GitLab은 그곳에서 발생하는 작업에 대해 알림을 보냅니다.

다음과 같은 이유로 알림을 받을 수 있습니다:

• 문제, 병합 요청, 에픽 또는 디자인에 참여합니다.
  댓글을 달거나 수정하거나 누군가가 당신을 언급할 때 당신은 참가자가 됩니다. ¹
• 문제, 병합 요청 또는 에픽에서 알림을 활성화했습니다.
• 프로젝트 또는 그룹에 대한 알림을 구성했습니다.
• 파이프라인 이메일 통합을 통해 그룹 또는 프로젝트 파이프라인 알림을 구독하고 있습니다.

1. GitLab은
   댓글을 편집하여 사용자 언급을 포함할 때 알림을 보내지 않습니다.

알림 설정 편집

많은 알림이 도착하면 압도적일 수 있습니다. 받는 알림을 조정할 수 있습니다.
예를 들어 특정 프로젝트의 모든 활동에 대해 알림을 받도록 할 수 있습니다.
다른 프로젝트에 대해서는 이름으로 언급될 때만 알림을 받고 싶을 수 있습니다.

이 알림 설정은 귀하에게만 적용됩니다.
다른 사용자에게 수신되는 알림에는 영향을 주지 않습니다.

알림 설정을 편집하려면:

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. 원하는 알림 수준을 선택합니다.

새 릴리스를 알리기 위해 알림을 받는 방법을 배우려면 릴리스에 대한 알림을 시청하세요.

알림 이벤트

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

문제, 병합 요청 및 에픽에 대한 알림

문제, 병합 요청, 에픽에서 발생하는 이벤트에 대한 알림도 받습니다.

문제, 병합 요청 및 에픽에 대한 알림을 받는 사람

문제, 병합 요청, 에픽에서 대부분의 이벤트에 대해 알림이 다음과 같이 전송됩니다:

• 참가자:
  • 작성자와 담당자.
  • 댓글 작성자.
  • 제목이나 설명에 사용자 이름으로 언급된 사람.
  • 댓글에 사용자 이름으로 언급된 사람, 알림 수준이 “참여” 이상일 경우.
• 구독자: 알림 수준이 “Watch”인 사용자.
• 구독자: 수동으로 알림을 구독한 모든 사람.
• 맞춤형: 적절한 유형의 이벤트에 대한 알림을 활성화한 알림 수준이 “Custom”인 사용자.

행동이 필요하지 않은 알림 수를 최소화하기 위해, 적격 승인자는 자신의 프로젝트 내 모든 활동에 대해 알림을 받지 않습니다. 이러한 알림을 활성화하려면, 알림 설정을 Watch로 변경해야 합니다.

문제, 병합 요청 및 에픽에 대한 알림 설정 편집

문제, 병합 요청 또는 에픽에서 알림을 전환하려면: 오른쪽 사이드바에서 Notifications () 토글을 켜거나 끄세요.

알림을 켜면, 토론에 참여하지 않았더라도 각 업데이트에 대한 알림을 받기 시작합니다.

에픽에서 알림을 켜면 에픽에 연결된 문제에 자동으로 구독되지 않습니다.

알림을 끄면, 업데이트에 대한 알림 수신을 중지합니다.

이 토글을 끄면 오직 이 문제, 병합 요청 또는 에픽과 관련된 업데이트에서 구독 해지됩니다.

GitLab의 모든 이메일에서 옵트 아웃하는 방법을 알아보세요.

문제, 병합 요청 및 에픽에 대한 알림 이벤트

다음 표는 문제, 병합 요청 및 에픽에 대한 알림을 생성하는 이벤트를 나타냅니다:

기본적으로, 자신이 만든 문제, 병합 요청 또는 에픽에 대한 알림은 받지 않습니다.

자신의 문제 및 병합 요청 등에 대한 알림을 항상 받으려면, 자신의 활동에 대한 알림을 켜세요.

알림: 알려지지 않은 로그인

• 로그인한 사용자의 전체 이름과 사용자 이름이 GitLab 15.10에 소개되었습니다.
• 지리적 위치가 GitLab 17.5에 추가되었습니다.

참고:
이 기능은 자체 관리 인스턴스에 대해 기본적으로 활성화됩니다.

관리자는 UI의 로그인 제한 섹션을 통해 이 기능을 비활성화할 수 있습니다.
GitLab.com에서는 이 기능이 항상 활성화되어 있습니다.

사용자가 이전에 알려지지 않은 IP 주소 또는 장치에서 성공적으로 로그인하면
GitLab은 사용자에게 이메일로 알림을 보냅니다.
이렇게 GitLab은 사용자에게 잠재적으로 악의적이거나 무단 로그인에 대해 사전에 알립니다.
이 알림 이메일에는 다음이 포함됩니다:

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

GitLab은 알려진 로그인을 식별하기 위해 여러 가지 방법을 사용합니다.
모든 방법이 실패해야 알림 이메일이 전송됩니다.

• 마지막 로그인 IP: 현재 로그인 IP 주소가 마지막 로그인
  IP 주소와 대조됩니다.
• 현재 활성 세션: 사용자가 동일한 IP 주소에서 기존 활성 세션을 가지는지 여부.
  활성 세션을 참조하세요.
• 쿠키: 성공적인 로그인 후, 암호화된 쿠키가 브라우저에 저장됩니다.
  이 쿠키는 마지막 성공적인 로그인 후 14일 후에 만료되도록 설정됩니다.

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

• GitLab 15.5에 소개되었습니다.

GitLab은 귀하의 계정에 잘못된 2단계 인증(2FA) 코드를 사용하여 로그인 시도를 감지하면
이메일 알림을 보냅니다.
이는 악의적인 사용자가 귀하의 사용자 이름과 비밀번호에 접근했으며,
2FA를 브루트 포스로 시도하고 있음을 감지하는 데 도움이 됩니다.

디자인에 대한 알림

디자인에 누군가 댓글을 달면
참여자에게 이메일 알림이 전송됩니다.

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

• 디자인의 저자(디자인의 서로 다른 버전을 업로드한 여러 사람이 있을 수 있음).
• 디자인에 대한 댓글의 저자.
• 디자인에 대한 댓글에서 언급된 모든 사람.

그룹 또는 프로젝트 접근 만료에 대한 알림

• GitLab 16.3에 소개되었습니다.

사용자의 그룹 또는 프로젝트 접근이 7일 후에 만료되면 GitLab은 이메일 알림을 보냅니다.
이는 그룹 또는 프로젝트 구성원이 원할 경우 접근 기간을 연장하도록 상기시킵니다.

모든 GitLab 이메일 수신 거부

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

1. 왼쪽 사이드바에서 아바타를 선택합니다.
2. 환경설정을 선택합니다.
3. 왼쪽 사이드바에서 알림을 선택합니다.
4. 전체 알림 수준을 비활성화로 설정합니다.
5. 자신의 활동에 대한 알림 받기 체크박스를 지웁니다.
6. 그룹이나 프로젝트에 속해 있는 경우, 그들의 알림 설정을 전체 또는
   비활성화로 설정합니다.

자체 관리 설치의 경우, 이를 수행한 후에도 인스턴스 관리자가
여전히 이메일을 보낼 수 있습니다.
구독 해지를 원하시면 이러한 이메일 중 하나에 있는 구독 해지 링크를 선택하십시오.

이메일 헤더를 사용하여 이메일 필터링하기

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

예를 들어, 특정 프로젝트에서 병합 요청이나 문제를 할당받을 경우 해당 프로젝트의 모든 이메일을 필터링할 수 있습니다.

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

X-GitLab-NotificationReason

X-GitLab-NotificationReason 헤더는 알림의 이유를 포함합니다. 값은 우선 순위에 따라 다음 중 하나입니다:

• own_activity
• assigned
• review_requested
• mentioned
• subscribed

알림의 이유는 알림 이메일의 바닥글에도 포함됩니다. 예를 들어, assigned 이유가 있는 이메일의 바닥글에는 이 문장이 포함되어 있습니다:

당신은 <구성된 GitLab 호스트 이름>에서 항목이 할당되었기 때문에 이 이메일을 받고 있습니다.

온콜 경고 알림

온콜 경고 알림 이메일에는 경고의 상태가 있을 수 있습니다:

• 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 인스턴스에서 보낸 이메일을 차단하고 있지 않은지 확인하십시오.
많은 이메일 제공업체(예: 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 주소를 이메일 제공업체의 허용 목록에 추가함으로써 해결할 수 있습니다.
이메일 제공업체의 문서를 참조하여 지침을 확인하십시오.