• 알림을 받는 대상
• 알림 설정 편집
  • 알림 범위
  • 알림 수준
  • 전역 알림 설정
  • 그룹 알림
    • 그룹 알림 수준 변경
    • 그룹 알림에 사용된 이메일 주소 변경
  • 프로젝트 알림 수준 변경
• 알림 이벤트
• 이슈, Merge Request 및 에픽에 대한 알림
  • 이슈, Merge Request 및 에픽에 대한 알림 수신 대상
  • 이슈, Merge Request 및 에픽에 대한 알림 설정 편집
  • 이슈, Merge Request 및 에픽에 대한 알림 이벤트
• 알 수 없는 로그인에 대한 알림
• 잘못된 인증 코드 사용으로 시도한 로그인에 대한 알림
• 디자인에 대한 알림
• 그룹 또는 프로젝트 액세스 만료에 대한 알림
• 모든 GitLab 이메일 수신 거부
• 이메일 필터링에 사용할 수 있는 이메일 헤더
  • X-GitLab-NotificationReason
    • 당직 알림 알림
    • 사건 에스컬레이션 알림
• 문제 해결
  • 알림을 받을 수신자 디렉터리 가져오기
  • 존재하지 않는 실패한 파이프라인에 대한 알림

알림 이메일

• 14.9 버전에서 도입된 GitLab에 피처 플래그 enhanced_notify_css라는 이름의 기능으로 개선된 이메일 스타일링. 기본적으로 사용하지 않음.
• GitLab 14.9에서 GitLab.com에 활성화된 개선된 이메일 스타일링.
• GitLab 15.0에서 Self-Managed에 활성화된 개선된 이메일 스타일링.
• GitLab 16.6에서 제거된 제품 마케팅 이메일.

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

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

알림을 받는 대상

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

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

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

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

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

알림 이벤트

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 전체 이름 및 사용자 이름을 나열하는 사람에 대한 알림은 GitLab 15.10에 도입되었습니다.

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

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

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

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

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

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

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

디자인에 대한 알림

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

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

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

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

• GitLab 16.3에서 도입되었습니다.

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

모든 GitLab 이메일 수신 거부

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

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

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

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

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

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

다음 표는 모든 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 '<프로젝트 이름>'
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 인스턴스가 중복되었는지 확인하십시오.