알림 및 웹훅

Alpacon은 결정이 필요한 승인 요청, 보안 이벤트, 모니터링 알림, 서버 연결 끊김 등 서버에서 일어나는 일을 팀에 알립니다. 알림은 기본적으로 앱 내 피드에 표시되며 이메일, 브라우저 알림, Slack DM으로도 받을 수 있습니다. 워크스페이스에서 외부 웹훅 엔드포인트로 알림을 전달할 수도 있습니다.

이 페이지에서는 알림이 발생하는 조건, 알림을 받을 수 있는 채널, 각 채널의 설정 담당자를 설명합니다. 스크립트에서 웹훅을 사용하려면 alpacon webhook를 확인하세요.

알림이 발생하는 조건#

앱 내 알림#

모든 멤버는 오른쪽 상단의 종 아이콘에서 알림 피드를 열 수 있습니다. 이 피드에는 자신과 관련된 최근 활동이 다음과 같은 범주로 묶여 표시됩니다.

• 승인: 결정을 기다리는 접속 요청과 명령 요청
• 보안: 무단 접속 시도, Alpacon을 거치지 않은 직접 로그인, 보안에 취약한 열린 포트, 알 수 없거나 위치가 바뀐 기기
• 서버: 연결 끊김을 포함한 서버 상태 변경
• 작업 세션과 명령: 세션 및 권한이 필요한 명령의 활동
• 토큰과 워크스페이스: 토큰 및 워크스페이스 변경
• 모니터링: 서버 메트릭이 임계값을 넘음

각 알림에는 정보, 경고, 심각 중 하나의 심각도가 표시됩니다. 피드에는 가장 최근 알림이 표시되며, 알림을 읽음으로 표시하거나 닫을 수 있습니다. 모든 요금제의 모든 사용자가 별도 설정 없이 사용할 수 있습니다.

서버 연결 끊김#

서버가 5분 동안 오프라인 상태이면 앱 내 피드에 심각 알림이 표시되고 이메일로도 전달됩니다. 워크스페이스의 Integrations > Slack에서 Slack 채널을 연결했다면 해당 채널에도 게시됩니다. 서버가 다시 연결되면 알림이 자동으로 해제되고 후속 이메일이 발송됩니다. Slack에 게시된 경우에는 해당 스레드에도 답글이 달립니다. 서버의 연결이 반복해서 끊겼다가 복구되면 연결이 안정될 때까지 끊김마다 메시지를 보내는 대신 하나의 알림으로 묶습니다. Alpacon에서 시작한 서버 점검 후에는 알림이 발생하지 않으며, 서버별로 끌 수도 있습니다. 자세한 내용은 알림을 받는 방법을 확인하세요. Alpacon이 시작한 플랫폼 전체 점검 시간이나 연결 장애 중에도 알림이 보류됩니다. 자세한 내용은 유지보수 기간을 확인하세요.

직접 로그인#

탐지가 켜져 있을 때 Alpacon을 거치지 않고 서버에 들어온 로그인이 상시 허용 항목과 일치하지 않으면 워크스페이스의 검토자에게 알립니다. 고위험 로그인은 이메일, 워크스페이스의 Slack 채널, 앱 내 피드로 보내고, 그 밖의 예상 밖 로그인은 Slack 채널과 앱 내 피드로 보냅니다. 계정에 연결된 멤버에게는 브라우저 알림으로 “본인이 접속했나요?”라고 묻고, Application maintainer에게는 이메일로 “내 자동화 작업이 맞나요?”라고 묻습니다. 탐지 가능하던 서버가 탐지 불가로 바뀌어도 검토자에게 경고합니다. 수신 대상별 내용은 External access의 알림을 참고하세요.

메트릭 알림#

메트릭 알림 규칙은 서버 메트릭을 지켜보다가 임곗값을 넘거나 메트릭이 들어오지 않는 등 규칙의 조건이 충족되면 알림을 생성합니다. 규칙이 알림을 생성하는 기준은 메트릭 알림을 참고하세요. 알림은 앱 내 피드와 대시보드에 즉시 표시됩니다. 이메일과 Slack 게시물은 연결된 경우 조건이 약 2분 동안 유지되어야 전송되므로, 그 전에 조건이 해소되면 이메일이나 Slack으로 전달되지 않습니다. 대기 시간, 알림 이메일 제목, 수신 대상은 알림 수신을 참고하세요. Metrics 앱의 메트릭 알림 화면에서 규칙을 정의하고, 각 필드는 규칙에 담을 수 있는 항목을 참고하세요.

미해결 알림 요약#

워크스페이스 관리자에게는 한 시간마다 아직 열려 있는 메트릭 알림과 오프라인 알림을 심각도별로 묶고, 지난 한 시간 동안 새로 생성되거나 해결된 알림을 함께 담은 이메일이 전송됩니다. 정보 또는 경고 심각도 규칙의 알림이나 이메일 수신 대상에 관리자가 빠진 알림처럼 관리자에게 개별적으로 전달되지 않는 상황도 관리자가 확인할 수 있도록 하기 위해서입니다. 경고 심각도 알림은 개별 알림 이메일을 보내지 않고, 설정이 켜져 있으면 워크스페이스에 연결된 Slack 채널에 게시되며 이 요약 메일에도 표시됩니다. 지난 한 시간 동안 알림이 생성되거나 해결되는 등 변화가 있을 때만 요약 메일을 보냅니다. 변화는 없지만 열린 알림이 남아 있다면, 워크스페이스 시간대의 09:00 이후 첫 정시 실행 때 대신 알림을 다시 알려주는 이메일을 보냅니다. 시간대가 설정되지 않았다면 UTC를 사용합니다. 열린 알림도 변화도 없는 시간에는 요약 메일을 보내지 않습니다.

알림이 열려 있는 동안에는 매일 다시 알려주는 이메일을 보냅니다.

워크스페이스의 누군가가 확인했거나 무시한 것으로 표시한 알림은 더 이상 다시 알림을 보내는 근거가 되지 않습니다. 같은 워크스페이스의 요약 메일은 모두 Open alert digest for 뒤에 워크스페이스 이름을 붙인 같은 제목을 사용하므로 메일 앱에서 한 대화로 묶입니다. 변경 내용은 이메일 첫 줄에 표시됩니다.

서버 연결이 끊겼다가 복구되기를 반복하면 개별 알림과 마찬가지로 연결 불안정 알림을 한 번만 보냅니다. 따라서 연결이 반복해서 끊기는 것만으로는 매시간 요약 메일이 발송되지 않습니다. 연결이 불안정한 동안에는 매시간 새 알림으로 표시하는 대신 “연결 불안정 시작 시각 …”으로 요약 메일에 한 번만 표시합니다. 그 시간에 다른 변화가 있으면 요약 메일을 보내고, 다시 알려주는 이메일도 이전과 같이 하루에 한 번 보냅니다.

요약 메일에는 Monitoring 및 Servers와 별도의 알림 카테고리가 있어, 두 카테고리를 꺼도 요약 메일은 꺼지지 않습니다. 요약 메일의 이메일 알림은 Preferences > Notifications에서 따로 끌 수 있습니다. 서버 알림 카드의 경고 행에서도 같은 설정을 변경할 수 있습니다. 아래 알림 설정을 참고하세요. 요약 메일이 발송될 때마다 앱 내 피드에도 표시됩니다.

작업 세션의 승인 요청#

작업 세션에서 발생하는 보류된 명령이나 sudo 요청 등의 승인 요청은 요청마다 별도의 이메일을 보내지 않고, 승인자별로 세션당 하나의 이메일 대화로 전달됩니다.

• 세션의 첫 승인 요청은 즉시 이메일로 발송됨
• 이후 요청은 5분 동안 모아 한꺼번에 발송하며, 이메일은 5분에 최대 한 통만 발송함. 5분 동안 새 요청이 없으면 발송하지 않음
• 세션 내내 제목을 승인 필요: 뒤에 세션 제목과 요청자를 붙인 형식으로 유지해 이메일이 하나의 스레드로 묶임
• 각 이메일에 새 요청의 전체 내용, 아직 대기 중인 요청의 요약, 마지막 이메일 이후 승인 여부가 결정되거나 만료된 요청과 결정한 사람을 모두 담음
• 세션의 대기 중인 요청에 대한 알림은 같은 스레드에서 요약 이메일 한 통으로 발송됨

Slack에서는 세션의 첫 게시물로 스레드가 시작되고, 이후 요청은 각각 버튼이 달린 답글로 게시됩니다. 스레드에 요청이 둘 이상이면 첫 게시물에도 대기 중인 요청 수와 위험 수준이 표시됩니다. 작업 세션 밖에서 발생한 요청은 요청마다 별도의 이메일 한 통으로 발송됩니다.

세션 위험도 분석#

세션의 AI 분석이 끝나면 위험도에 따라 결과를 다음과 같이 전달합니다.

• 심각: 앱 내 알림과 서버 소유자 및 워크스페이스의 Superuser에게 이메일을 발송함. 제목은 [Critical]로 시작하고 워크스페이스와 세션 이름을 포함하며, 이메일에는 세션 분석 링크가 담김. Slack에는 게시하지 않음
• 높음: 앱 내 알림과 제목이 [High]로 시작하는 이메일을 발송함
• 높음 미만: 알림을 보내지 않음

알림 채널과 설정 위치#

알림이 어느 채널로 전달되는지는 워크스페이스 전체에 일괄 적용하지 않고 알림 유형별로 결정합니다. 각 멤버는 왼쪽 사이드바 하단의 계정 메뉴에서 알림 설정을 열어 카테고리 전체 또는 카테고리 안의 개별 이벤트에 대한 채널을 끌 수 있습니다.

Webhook은 예외로 워크스페이스 단위에서 관리합니다. 왼쪽 사이드바에서 워크스페이스 설정을 연 다음 Integrations > Webhook에서 엔드포인트를 관리하세요. 엔드포인트를 하나 이상 등록하면 Webhook이 알림을 받습니다.

알림 설정#

왼쪽 사이드바 하단의 계정 메뉴에서 알림 설정을 열거나 환경설정 > 알림으로 바로 이동하세요. 페이지에는 서버 알림 카드, 브라우저 알림 카드, 카테고리와 채널의 전체 설정 표가 차례로 표시됩니다.

서버 알림#

서버 알림 카드에는 알림 심각도별 동작이 요약되어 있고, 직접 바꿀 수 있는 스위치 두 개가 있습니다. 각 스위치는 아래 표의 해당 카테고리와 채널 설정에 연결되어 있습니다. 카드에서 스위치를 바꾸거나 표에서 해당 항목을 바꾸면 같은 설정이 변경됩니다. 심각도 자체는 별도 설정으로 저장되지 않습니다.

• 심각: 이메일과 팀의 Slack 채널. 심각 임계값 알림 메일 받기 스위치는 서버 카테고리의 임계값 알림 이메일을 개인별로 설정함. 규칙에서 이메일을 전혀 보내지 않도록 설정했다면 이 스위치를 켜도 이메일이 발송되지 않음
• 경고: 팀의 Slack 채널과 관리자에게 보내는 시간별 요약 이메일. 매시간 요약 메일 받기 스위치는 표에서 열린 알림 요약 카테고리의 이메일 채널과 같은 설정임
• 정보: 벨 알림만 표시하며 끌 수 없음. 이 행에는 스위치가 없음

심각과 경고 알림은 각각의 원인이 된 규칙에서 Slack 전송을 켜 두었다면 팀의 Slack 채널에도 게시됩니다. 이 설정은 개인별 설정이 아니라 규칙별 설정입니다. 어떤 규칙이 Slack에 게시하는지 확인하거나 변경하려면 카드에서 알림 규칙 열기를 클릭하세요. 다른 이유로 연결된 설정이 꺼져 있으면 스위치가 회색으로 표시되고 조작할 수 없습니다. 예를 들어 아래 표에서 서버 이메일을 모두 껐거나 워크스페이스에서 해당 채널을 필수로 지정해 누구도 끌 수 없을 때 그렇습니다. 이벤트별 알림 설정이 도입되기 전에 배포된 환경에서는 카드에 세 가지 설명만 표시되고 스위치는 없습니다.

이 카드에는 앱 내 주소인 #server-alerts가 있습니다. 이 주소로 연결하면 페이지가 열리면서 맨 위가 아닌 카드 위치로 바로 스크롤됩니다.

개별 이벤트 끄기#

표에서 카테고리 행을 펼치면 그 안의 이벤트를 볼 수 있습니다. 서버에서 해당 카테고리와 채널의 이벤트별 설정을 지원하면 각 이벤트에 스위치가 표시됩니다. 서버 이메일이 그 예입니다. 아직 이벤트별 설정을 지원하지 않는 셀에는 채널에 포함된 이벤트 목록만 표시되고 스위치는 없습니다.

채널 하나에 해당하는 카테고리 셀 전체를 끄면 그 안의 이벤트 스위치도 모두 꺼집니다. 셀이 꺼져 있는 동안 이벤트 스위치는 선택 해제된 채로 잠깁니다. 이전에 따로 꺼 둔 이벤트에는 작은 개별적으로도 꺼짐 태그가 남아 있어, 셀을 다시 켜도 그 이벤트가 함께 켜지지 않습니다. 셀이 켜져 있고 일부 이벤트만 꺼져 있으면 3개 꺼짐과 같은 태그가 표시됩니다. 태그를 클릭하면 행이 펼쳐져 어떤 이벤트가 꺼졌는지 볼 수 있습니다.

채널 전체를 복원하려면 해당 열 머리글에서 선택 해제된 체크박스를 클릭하세요. 그러면 그 열에서 꺼 둔 카테고리별 설정과 개별 이벤트 설정이 모두 되돌아갑니다.

웹훅#

웹훅은 알림 이벤트를 외부 서비스로 보내 팀이 이미 확인하는 채널에 전달합니다. Alpacon은 대상 서비스에 맞게 메시지 형식을 자동으로 지정하므로 Slack 웹훅에는 Slack 메시지로, Microsoft Teams 웹훅에는 Microsoft Teams 카드로 표시됩니다. 입력한 URL을 기준으로 Slack, Discord, Microsoft Teams, Telegram 또는 사용자 지정 HTTP 엔드포인트를 판별합니다.

제품에서 웹훅을 추가하려면 다음 단계를 따르세요.

1. 워크스페이스 설정 > 연동 > 웹훅으로 이동
2. 새 웹훅 클릭
3. 이름과 URL 입력, 직접 재정의할 필요가 없다면 제공자는 자동 판별로 유지, 공개 엔드포인트에는 SSL 검증을 켜고 활성화 설정
4. 저장

Slack, Discord, Microsoft Teams 또는 Telegram에서 수신 웹훅 URL을 만드는 방법 등 서비스별 설정 절차는 웹훅 설정을 참고하세요. 메시지 페이로드와 제공자 옵션을 포함해 명령줄에서 웹훅을 만들고 관리하는 방법은 alpacon webhook를 참고하세요.

설정별 변경 권한#

웹훅과 메트릭 알림은 워크스페이스 전체에 적용됩니다. 멤버 한 명이 설정하면 모두에게 적용됩니다. 알림 수신 채널은 개인별로 설정합니다. 환경설정 > 알림에서 알림 범주 전체 또는 그 안의 개별 이벤트에 대해 이메일, 브라우저 알림, Slack DM을 끌 수 있습니다. 위의 알림 설정을 참고하세요. 이 설정은 본인에게만 적용됩니다. 앱 내 알림 피드는 항상 켜져 있고 끌 수 없으므로 수신 채널을 꺼도 알림이 사라지지 않습니다.

요금제별 제공 기능#

이메일 알림, 웹훅(Slack을 웹훅 대상으로 사용하는 경우 포함), 메트릭 알림을 사용하려면 Essentials 이상의 요금제가 필요합니다. Free 요금제에서도 앱 내 알림 피드는 작동합니다. 웹훅을 열면 업그레이드 대화상자가 표시됩니다. 메트릭 알림은 Metrics 확장 기능에 속하므로 화면 대신 현재 요금제로는 활성화할 수 없다는 안내와 요금제 페이지로 이동하는 버튼이 표시됩니다. 업그레이드 안내 방식과 요금제 변경 위치는 플랜과 결제를, 전체 요금제 구성은 가격 페이지를 참고하세요.

CLI에서 관리#

Alpacon CLI에서도 다음 설정을 관리할 수 있습니다.

• alpacon webhook으로 페이로드 형식과 제공업체 옵션을 포함한 웹훅을 생성, 목록 조회, 상세 조회, 수정, 삭제함

직접 호스팅한 배포 환경#

자체 호스팅 배포에서는 브라우저 알림을 사용할 수 없으며, 이메일 전송은 배포 환경에 이메일이 설정되어 있어야 가능합니다. 앱 내 피드와 웹훅은 어떤 배포 환경에서도 작동합니다.

관련 문서#

• 설정 관리하기
• 유지보수 기간
• 플랜과 결제
• 요청 관리
• alpacon webhook