• 누가 알림을 받나요
• 알림 설정 편집
  • 알림 범위
  • 알림 수준
  • 전역 알림 설정
  • 그룹 알림
    • 그룹 알림 수준 변경
    • 그룹 알림을 위해 사용하는 이메일 주소 변경
  • 프로젝트 알림 수준 변경
• 알림 이벤트
• 이슈, 병합 요청 및 에픽에 대한 알림
  • 누가 이슈, 병합 요청 및 에픽에 대한 알림을 받나요?
  • 이슈, 병합 요청 및 에픽에 대한 알림 설정 편집
  • 이슈, 병합 요청 및 에픽에 대한 알림 이벤트
• 알 수 없는 로그인에 대한 알림
• 잘못된 검증 코드를 사용한 시도에 대한 알림
• 디자인에 대한 알림
• 그룹 또는 프로젝트 액세스 만료에 대한 알림
• GitLab 이메일 수신 거부
• 이메일 필터링에 사용할 수 있는 이메일 헤더
  • X-GitLab-NotificationReason
    • 당직 알림 알림
    • 사건 에스컬레이션 알림
• Troubleshooting
  • 알림을 받을 수신자 목록 가져오기
  • 존재하지 않는 실패한 파이프라인에 대한 알림

이메일 알림

• GitLab 14.9에서 enhanced_notify_css라는 기능 플래그로 도입된 향상된 이메일 스타일
• GitLab 14.9에서 GitLab.com에서 활성화된 향상된 이메일 스타일
• GitLab 15.0에서 자체 관리형에서 활성화된 향상된 이메일 스타일
• GitLab 16.6에서 제품 마케팅 이메일 제거

GitLab에서의 상황에 대한 이메일 알림을 통해 최신 정보를 받아보세요. 이슈, 병합 요청, 에픽, 그리고 디자인과 관련된 활동에 대한 업데이트를 받을 수 있습니다.

사용자에게 메시지를 보낼 수 있는 GitLab 관리자용 도구에 대한 자세한 내용은 GitLab에서의 이메일을 참조하세요.

누가 알림을 받나요

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

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

• 이슈, 병합 요청, 에픽, 또는 디자인에 참여하거나 댓글을 남기거나 편집하거나 누군가가 여러분을 언급한 경우 참여자가 됩니다.
• 이슈, 병합 요청 또는 에픽에서 알림을 활성화한 경우
• 프로젝트나 그룹에 대한 알림 구성을 했을 경우
• 프로젝트 또는 그룹 파이프라인 알림을 파이프라인 이메일 통합을 통해 구독한 경우

1. 이슈를 관련 있는 사용자 언급을 포함하여 수정하는 경우, GitLab은 알림을 보내지 않습니다.

알림 설정 편집

너무 많은 알림을 받는 것은 혼란스러울 수 있습니다. 받는 알림을 조정할 수 있습니다. 예를 들어, 특정 프로젝트의 모든 활동에 대해 알림을 받고 싶을 수 있습니다. 다른 프로젝트의 경우에는 이름으로 언급될 때만 알림을 받고 싶을 수도 있습니다.

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

알림 설정을 편집하려면:

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

알림 범위

각 프로젝트와 그룹에 대해 다른 알림 수준을 선택하여 알림 범위를 조정할 수 있습니다.

알림 범위는 가장 넓고 가장 구체적인 수준부터 적용됩니다:

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

알림 수준

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

전역 알림 설정

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

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

그룹 알림

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

그룹 알림 수준 변경

그룹에 대해 알림 수준을 선택하려면 다음 중 하나의 방법을 사용하세요:

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

또는:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾으세요.
2. 종아모양 아이콘({알림}) 옆의 알림 드롭다운 목록을 선택하세요.
3. 원하는 알림 수준을 선택하세요.

그룹 알림을 위해 사용하는 이메일 주소 변경

• GitLab 12.0에 도입되었습니다.

당신은 소속된 각 그룹에 대한 알림을 받을 이메일 주소를 선택할 수 있습니다. 예를 들어, 프리랜서로 일하면서 고객 프로젝트에 대한 이메일을 분리하고 싶다면 그룹 알림을 사용할 수 있습니다.

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

프로젝트 알림 수준 변경

최신 상태를 유지하는 데 도움이 되도록 각 프로젝트에 대해 알림 수준을 선택할 수 있습니다.

프로젝트의 알림 수준을 선택하려면 다음 중 하나의 방법을 사용하세요:

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

또는:

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

새 릴리스가 출시되면 알림을 받는 방법을 알아보려면 릴리스 알림을 확인하세요.

알림 이벤트

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

이슈, 병합 요청 및 에픽에 대한 알림

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

누가 이슈, 병합 요청 및 에픽에 대한 알림을 받나요?

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

• 참가자:
  • 작성자 및 담당자
  • 댓글의 작성자
  • 제목이나 설명에 사용자 이름으로 언급됨
  • 댓글에서 사용자 이름으로 언급된 경우, 알림 수준이 “참여” 이상인 경우
• 감시자: 알림 수준이 “감시”인 사용자
• 구독자: 수동으로 알림을 구독한 사람
• 사용자 지정: 이벤트 유형에 대한 알림을 켠 알림 수준이 “사용자 지정”인 사용자

참고: 행동이 필요하지 않은 알림을 최소화하기 위해, GitLab 12.9 및 이후에는 적격 승인자에게 프로젝트의 모든 활동에 대해 더 이상 알림이 전송되지 않습니다. 이러한 알림을 켜려면 사용자 알림 설정을 감시로 변경해야 합니다.

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

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

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

알림을 끌 때는 업데이트에 대한 알림을 받지 않습니다. 이 토글을 끄면 해당 이슈, 병합 요청 또는 에픽과 관련된 업데이트에 대한 구독이 취소됩니다. GitLab의 모든 이메일에서 탈퇴하는 방법을 알아보세요.

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

다음 표는 이슈, 병합 요청 및 에픽에 대한 알림을 생성하는 이벤트를 보여줍니다.

기본적으로 자신이 생성한 이슈, 병합 요청 또는 에픽에 대한 알림을 받지 않습니다. 자신의 활동에 관한 알림을 항상 받으려면, 전체 알림 설정을 사용하도록 설정하세요.

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

• GitLab 13.0에서 도입.
• 서명된 사용자의 전체 이름 및 사용자 이름을 나열하면 GitLab 15.10에 도입되었습니다.

참고: 이 기능은 Self-Managed 인스턴스의 경우 기본적으로 활성화됩니다. 관리자는 UI의 로그인 제한 섹션에서 이 기능을 비활성화할 수 있습니다. 이 기능은 GitLab.com에서 항상 활성화됩니다.

사용자가 이전에 알 수 없는 IP 주소나 장치에서 로그인에 성공하면, GitLab은 사용자에게 이메일로 알립니다. 이런 식으로 GitLab은 잠재적으로 애매하거나 불법적인 로그인에 대해 사용자에게 적극적으로 경고합니다. 이 알림 이메일에는 다음이 포함됩니다:

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

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

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

잘못된 검증 코드를 사용한 시도에 대한 알림

• GitLab 15.5에서 도입.

GitLab은 귀하의 계정으로의 로그인 시도 중 잘못된 이중 인증 (2FA) 코드를 사용하여 감지하면 이메일 알림을 보냅니다. 이는 악의적인 사용자가 귀하의 사용자 이름 및 암호에 액세스했으며 2FA를 강제로 시도하고 있는 것을 감지할 수 있습니다.

디자인에 대한 알림

• GitLab 13.6에서 도입.

디자인에 댓글을 작성하면 전체 참여자에게 이메일 알림이 전송됩니다.

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

• 디자인의 작성자(다른 작성자가 다른 버전의 디자인을 업로드했을 경우 여러 사용자가 될 수 있음).
• 디자인에 댓글을 작성한 사용자.
• 디자인에 댓글에서 언급된 모든 사람.

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

• GitLab 16.3에서 도입.

GitLab은 그룹 또는 프로젝트 멤버의 액세스가 7일 후에 만료되면 이메일 알림을 보냅니다. 이는 그룹 또는 프로젝트 멤버가 액세스 기간을 연장하고자 하는지를 상기시킵니다.

GitLab 이메일 수신 거부

더 이상 어떠한 이메일 알림도 받고 싶지 않은 경우:

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

Self-Managed 설치에서도 이를 수행한 후에도 인스턴스 관리자는 여전히 귀하에게 이메일을 보낼 수 있습니다. 구독을 취소하려면 이메일 중 하나에서 구독 취소 링크를 선택하십시오.

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

알림 이메일 메시지에는 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에서 추적됩니다.

Troubleshooting

알림을 받을 수신자 목록 가져오기

프로젝트에서 알림을 받을 수신자 목록을 가져오려면(주로 문제 해결용 사용), 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 인스턴스가 있는지 확인하세요.