• 누가 알림을 받나요
• 알림 설정 편집
  • 알림 범위
  • 알림 수준
  • 전역 알림 설정
  • 그룹 알림
    • 그룹 알림 수준 변경
    • 그룹 알림에 사용된 이메일 주소 변경
  • 프로젝트 알림 수준 변경
• 알림 이벤트
• 이슈, 병합 요청, 에픽 관련 알림
  • 이슈, 병합 요청, 에픽에 대한 알림 수신자
  • 이슈, 병합 요청, 에픽에 대한 알림 설정 편집
  • 이슈, 병합 요청, 에픽에 대한 알림 이벤트
• 알 수 없는 로그인을 위한 알림
• 잘못된 확인 코드를 사용한 로그인 시도에 대한 알림
• 디자인에 대한 알림
• 그룹 또는 프로젝트 액세스 만료에 대한 알림
• 모든 GitLab 이메일 수신 거부
• 이메일 필터링에 사용할 수 있는 GitLab 이메일 헤더
  • X-GitLab-NotificationReason
    • 온콜 알림 알림
    • 사고 에스컬레이션 알림
• 문제 해결
  • 알림을 받을 수 있는 수신자 목록을 가져옵니다.
  • 존재하지 않는 실패한 파이프라인에 대한 알림
  • 이메일 알림이 활성화되어 있지만 수신되지 않음

알림 이메일

• GitLab 14.9에 소개된 특징 플래그로 enhanced_notify_css라는 기능 플래그가 있는 향상된 이메일 스타일링입니다. 기본 상태에서 비활성화됨.
• GitLab 14.9에서 GitLab.com에 활성화된 향상된 이메일 스타일링입니다.
• GitLab 15.0에서 Self-managed에 활성화된 향상된 이메일 스타일링입니다.
• GitLab 16.6에서 제거된 제품 마케팅 이메일입니다.

GitLab에서의 활동에 대한 업데이트를 받으세요. 이슈, 병합 요청, epic, 디자인에서의 활동에 대한 업데이트를 받을 수 있습니다.

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

GitLab 17.2 이상에서는 알림이 24시간마다 한 번 제한됩니다 (프로젝트 또는 그룹 당).

누가 알림을 받나요

알림이 이슈, 병합 요청 또는 epic에 대해 활성화되었을 때, GitLab은 해당 위치에서 발생한 동작에 대해 알려줍니다.

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

• 이슈, 병합 요청, epic 또는 디자인에 참여합니다. 댓글을 작성하거나 편집하거나 누군가가 ¹ 언급하면 참여자가 됩니다.
• 이슈, 병합 요청 또는 epic에서 알림을 활성화했습니다.
• 프로젝트 또는 그룹의 알림을 구성했습니다.
• 파이프라인 이메일 통합을 통해 그룹 또는 프로젝트 파이프라인 알림을 구독했습니다.

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. 선택한 알림 수준을 선택하세요.

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

알림 이벤트

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

이슈, 병합 요청, 에픽 관련 알림

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

이슈, 병합 요청, 에픽에 대한 알림 수신자

이슈, 병합 요청 및 에픽에서 대부분의 이벤트에 대한 알림은 다음 대상에게 전송됩니다:

• 참여자:
  • 작성자 및 할당된 사람.
  • 코멘트 작성자.
  • 제목 또는 설명에서 사용자 이름으로 언급된 사람.
  • 그들의 알림 수준이 “참여” 이상인 경우 코멘트에서 사용자 이름으로 언급된 사람.
• 감시자: 알림 수준이 “감시”인 사용자.
• 구독자: 수동으로 알림을 구독한 사람.
• 사용자 지정: 해당 유형의 이벤트에 대한 알림을 켜놓은 알림 수준이 “사용자 지정”인 사용자.

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

이슈, 병합 요청, 에픽에 대한 알림 설정 편집

이슈, 병합 요청 및 에픽에서 알림을 전환하려면: 오른쪽 사이드바에서 알림 () 토글을 켜거나 끕니다.

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

알림을 끌 때, 토글을 끄면 업데이트에 대한 알림을 받지 않게 됩니다. 이 토글을 끄면 이슈, 병합 요청 또는 에픽과 관련된 업데이트로부터 구독이 해지됩니다. 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에 도입되었습니다.

GitLab은 그룹 또는 프로젝트 멤버의 액세스가 7일 후에 만료되면 알림 이메일을 보냅니다. 이는 그룹 또는 프로젝트 멤버가 액세스 기간을 연장하려면 알림해 주는 것입니다.

모든 GitLab 이메일 수신 거부

이제 더 이상 어떤 이메일 알림도 받고 싶지 않다면:

1. 왼쪽 사이드바에서 아바타를 선택하세요.
2. 환경 설정을 선택하세요.
3. 왼쪽 사이드바에서 알림을 선택하세요.
4. 글로벌 알림 수준을 비활성화로 설정하세요.
5. 자신의 활동에 대한 알림 받기 확인란을 선택해제하세요.
6. 그룹이나 프로젝트에 속해 있다면, 그들의 알림 설정을 글로벌 또는 비활성화로 설정하세요.

셀프 마이그레이션 설치에서는, 이 작업을 한 후에도 인스턴스 관리자는 여전히 당신에게 이메일을 보낼 수 있습니다. 구독을 취소하려면 이메일 중 하나에 있는 구독 해제 링크를 선택하세요.

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

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

예를 들어, 특정 프로젝트로부터 할당된 병합 요청 또는 이슈가 있는 경우 모든 이메일을 필터링할 수 있습니다.

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

X-GitLab-NotificationReason

X-GitLab-NotificationReason 헤더는 알림의 이유를 포함합니다. 값은 아래 우선 순위로 하나입니다:

• own_activity
• assigned
• review_requested
• mentioned
• subscribed

알림의 이유는 또한 알림 이메일의 푸터에 포함됩니다. 예를 들어, 할당됨 레이블이 지정된 이메일에는 다음 문장이 푸터에 포함됩니다:

구성된 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과 같은 많은 이메일 공급업체는 알려져 있지 않은 Self-managed 메일 서버 IP 주소에서 오는 이메일을 차단합니다. 확인하려면 인스턴스의 SMTP 서버에서 직접 이메일을 보내 보세요. 예를 들어, Sendmail에서의 테스트 이메일은 다음과 같을 수 있습니다:

# (echo subject: test; echo) | $(which sendmail) -v -Am -i <valid email address>

이메일 공급자가 메시지를 차단하는 경우, (이메일 공급자와 SMTP 서버에 따라) 다음과 유사한 출력을 받을 수 있습니다:

진단 코드: 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 주소를 메일 공급자의 허용 목록에 추가하여 해결할 수 있습니다. 지침은 메일 공급자의 문서를 확인하세요.