알림 이벤트와 전달 경로

개인별 전달 채널은 알림 설정에서 바꿀 수 있습니다. 외부 주소를 추가하려면 웹훅 설정을 확인하세요.

이벤트별 수신자와 전달 경로#

개인별 설정에 따라 이메일, 브라우저 알림, Slack DM은 꺼질 수 있습니다. 앱 내 알림 피드는 계속 사용할 수 있습니다. 각 이벤트의 전달 시점과 예외는 아래에서 확인하세요.

알림 전달 경로#

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

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

알림이 발생하는 조건#

앱 내 알림#

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

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

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

서버 연결 끊김#

서버가 5분 동안 오프라인 상태이면 앱 내 피드에 심각 알림이 표시되고 이메일로도 전달됩니다. 워크스페이스의 연동 → 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와 별도의 알림 카테고리가 있어, 두 카테고리를 꺼도 요약 메일은 꺼지지 않습니다. 요약 메일의 이메일 알림은 알림 설정에서 따로 끌 수 있습니다. 서버 알림 카드의 경고 행에서도 같은 설정을 변경할 수 있습니다. 알림 설정을 참고하세요. 요약 메일이 발송될 때마다 앱 내 피드에도 표시됩니다.

작업 세션 만료#

승인되었거나 활성 상태인 작업 세션이 끝나기 약 5~10분 전에 요청자와 담당 사용자에게 세션 링크가 포함된 알림이 갑니다. 접근 권한이 더 필요하면 세션을 연장하세요. 연장한 종료 시각에도 별도의 알림이 갑니다.

이 경고는 앱 내 알림에 표시됩니다. Alpacon Cloud에서는 브라우저가 등록되어 있고 알림을 켜 두었다면 브라우저 알림도 받습니다. 이메일이나 Slack으로는 보내지 않습니다. 할당된 API 토큰의 소유자이거나 서비스 토큰 애플리케이션의 소유자라는 이유만으로 수신자에 추가되지는 않습니다. 요청자는 여전히 알림을 받습니다.

알림 설정에서 세션 만료 임박을 끄면 이 브라우저 알림을 받지 않습니다. 세션이 만료되거나 자동 취소되면 앱 내 알림만 받습니다. 세션이 철회되면 브라우저 알림과 이메일도 받습니다.

작업 세션의 승인 요청#

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

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

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

자신의 작업 세션 요청을 승인할 수 있는 경우#

자신이 낸 작업 세션 요청을 직접 승인할 수 있으면 요청은 먼저 본인에게만 전달됩니다. 요청이 아직 열려 있으면 약 10분 뒤에 다른 승인자에게도 알림이 갑니다.

작업 세션을 요청한 사람(본인용이든 에이전트용이든)이 그 요청의 승인자이고, 워크스페이스의 접근 규칙이 본인 요청의 승인을 허용하며, 승인 한 번으로 결정되는 요청일 때 이렇게 전달됩니다.

• 처음에는 본인에게만: 앱 내 피드로 전달되며, 알림 설정에서 끄지 않았다면 이메일과 승인·거절 버튼이 달린 Slack DM(Slack 계정이 연결된 경우)도 받음
• 약 10분 뒤에는 다른 승인자에게: 요청이 아직 열려 있으면 다른 승인자에게 알림이 가고 본인은 다시 알림을 받음. 승인 카드가 워크스페이스의 Slack 승인 채널에 게시되며, Slack 계정이 연결된 다른 승인자를 멘션함
• 그 뒤 다시 알림 두 번: 요청 후 약 20분과 30분에 모든 승인자에게 발송됨

다른 승인자에게 알림이 가기 전에 본인이 결정하면 다른 승인자는 알림을 받지 않으며, 승인 채널에는 결정된 카드가 표시됩니다. 다른 승인자는 언제든 콘솔에서 요청을 열어 결정할 수 있습니다.

승인이 두 번 이상 필요한 요청이나 본인이 승인할 수 없는 요청은 모든 승인자에게 한꺼번에 전달됩니다. sudo 요청, 명령 요청, 연장 요청은 항상 모든 승인자에게 한꺼번에 전달됩니다.

Slack 계정이 연결되어 있지 않으면 다른 요청과 마찬가지로 승인 카드가 바로 승인 채널에 게시되고, 나머지 알림은 여전히 본인에게만 전달됩니다. 본인이 직접 결정한 요청에는 결정 알림이 오지 않으며, 다른 승인자가 결정하면 결정 알림을 받습니다.

세션 위험도 분석#

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

• 심각: 앱 내 알림을 보내고 서버 소유자와 워크스페이스의 Superuser에게 이메일을 발송함
• 높음: 앱 내 알림을 보내고 워크스페이스가 정기 보고서를 받지 않는 경우에만 같은 수신자에게 이메일을 발송함
• 높음 미만: 알림을 보내지 않음

이메일이 발송되면 같은 알림이 워크스페이스에 연결된 Slack 채널에도 한 번 게시됩니다. 직접 로그인 경고도 이 채널로 전송됩니다. 이메일 제목과 Slack 게시물의 머리말에는 분석 결과의 첫 문장을 마침표 없이 사용합니다. 본문은 심각도 · 세션 · 서버 · 승인 상태 형식의 한 줄이며, 서버 이름이 세션 이름과 같으면 서버는 생략합니다. 승인 상태는 “Jane Doe님이 승인했어요”, “3건 중 2건 승인됐어요”, “승인 없이 실행 · 접근 규칙”처럼 표시됩니다. AI 에이전트의 이름을 알 수 있으면 함께 표시하고 “분석 보기” 버튼도 제공합니다. 전체 판단 근거와 권장 조치는 콘솔에서 확인할 수 있습니다.

알림 채널과 설정 위치#

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

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

설정별 변경 권한#

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

요금제별 제공 기능#

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

CLI에서 관리#

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

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

직접 호스팅한 배포 환경#

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