알림 및 웹훅
Alpacon은 서버 전반에서 일어나는 일을 팀에 알려 줍니다. 결정을 기다리는 승인 요청, 보안 이벤트, 모니터링 경고, 연결이 끊긴 서버 등이 대상입니다. 알림은 기본적으로 인앱 피드에 표시되며, 워크스페이스는 이를 이메일, 브라우저 푸시, 외부 웹훅 엔드포인트로도 전달할 수 있습니다.
이 문서에서는 어떤 이벤트가 알림을 발생시키는지, 알림이 도달할 수 있는 채널은 무엇인지, 각 채널을 누가 구성하는지 설명합니다. 설정 화면을 단계별로 보려면 설정 관리하기를 참고하세요. 웹훅을 스크립트로 다루려면 웹훅 CLI 참조를 참고하세요.
알림이 발생하는 경우
인앱 알림
모든 멤버에게는 우측 상단의 종 아이콘에서 여는 알림 피드가 있습니다. 나와 관련된 최근 활동을 모아 다음과 같은 범주로 묶어 보여줍니다.
- 승인: 결정을 기다리는 접근 및 명령 요청
- 보안: 비인가 접근 시도, 열린 비보안 포트, 알 수 없거나 이동한 장치
- 서버: 연결 끊김을 포함한 서버 상태 변화
- 작업 세션과 명령: 세션 및 권한 명령 활동
- 토큰과 워크스페이스: 토큰 및 워크스페이스 변경
- 모니터링: 서버 메트릭 임계값 초과
각 항목에는 정보, 경고, 심각 중 하나의 심각도가 표시됩니다. 피드는 가장 최근 항목을 보여주며, 항목을 읽음으로 표시하거나 지울 수 있습니다. 모든 플랜의 모든 멤버가 사용할 수 있고 별도 설정이 필요 없습니다.
서버 연결 끊김
인앱 피드 외에도, 서버가 Alpacon과의 연결이 끊긴 상태로 유지되면 워크스페이스가 경고를 보낼 수 있으며 어떤 채널로 전달할지 선택합니다. 서버가 1분 동안 연결이 끊기면 경고 항목을, 5분이 지나면 심각 항목을 받습니다.
모니터링 규칙 경고
모니터링 규칙은 실시간 서버 메트릭을 지켜보다가 규칙의 임계값에 도달하면 경고를 발생시킵니다. 이 경고는 대시보드와 이메일로 전달됩니다. 규칙을 정의하려면 모니터링 규칙을 참고하세요.
채널과 설정 위치
| 채널 | 설명 | 설정 위치 |
|---|---|---|
| 인앱 피드 | 상단 바의 종 아이콘, 멤버별 피드 하나 | 항상 켜짐, 설정 불필요 |
| 이메일 | 받은 편지함으로 전달되는 알림 | 연동 > 알림 |
| 브라우저 푸시 | 브라우저 푸시 알림(Alpacon Cloud 전용) | 연동 > 알림 |
| 웹훅 | 외부 엔드포인트로 전송(Slack, Discord, Microsoft Teams, Telegram, 커스텀 URL) | 연동 > 웹훅 또는 CLI |
이 설정을 열려면 좌측 사이드바에서 Workspace settings를 클릭한 다음 연동 그룹으로 이동합니다. 알림에서는 알림 유형을 켜거나 끄고 전달할 채널을 선택할 수 있으며, 웹훅에서는 엔드포인트를 관리합니다. 채널에서 웹훅을 선택해도 웹훅 엔드포인트를 하나 이상 등록해야 실제로 전송됩니다.
웹훅
웹훅은 알림 이벤트를 외부 서비스로 전송하여 팀이 이미 지켜보는 채널에서 확인할 수 있게 합니다. Alpacon은 각 메시지를 대상에 맞게 자동으로 포맷하므로, Slack 웹훅은 Slack 메시지로, Teams 웹훅은 Teams 카드로 표시됩니다. 지원 대상은 Slack, Discord, Microsoft Teams, Telegram, 커스텀 HTTP 엔드포인트이며, 입력한 URL에서 자동으로 감지됩니다.
제품에서 웹훅을 추가하는 방법은 다음과 같습니다.
- Workspace settings > 연동 > 웹훅으로 이동합니다.
- 새 웹훅을 클릭합니다.
- 이름과 URL을 입력합니다. 프로바이더는 재정의가 필요하지 않으면 자동 감지로 두고, 공개 엔드포인트에는 SSL 인증 확인을 켠 상태로 두며, 활성화됨을 설정합니다.
- 저장합니다.
Slack, Discord, Teams, Telegram에서 수신 웹훅 URL을 만드는 등 프로바이더별 설정 단계는 웹훅 설정을 참고하세요. 메시지 페이로드와 프로바이더 옵션을 포함해 명령줄에서 웹훅을 생성하고 관리하려면 웹훅 CLI 참조를 참고하세요.
웹훅의 SSL 검증을 끄면 메시지가 가로채기에 노출됩니다. 공개 엔드포인트에는 켜 두고, 신뢰할 수 있는 내부 주소나 로컬 테스트에서만 끄세요.
구성 권한
알림 채널과 규칙은 개인 환경설정이 아니라 워크스페이스 전체에 적용되는 설정입니다. 한 멤버가 구성하면 워크스페이스 전체에 적용됩니다. 인앱 피드만 예외로, 개인별로 제공되며 항상 켜져 있습니다. 현재 사용자별 알림 환경설정은 제공하지 않습니다.
| 설정 | 변경 권한 |
|---|---|
| 알림 유형 및 채널(연동 > 알림) | Superuser |
| 웹훅(연동 > 웹훅) | Staff 및 Superuser |
| 모니터링 규칙(연동 > 모니터링 규칙) | Superuser |
| 내 인앱 피드 | 모든 멤버 |
플랜별 제공 범위
이메일 알림, 웹훅(Slack도 웹훅 대상 중 하나), 모니터링 규칙은 Essentials 플랜 이상에서 사용할 수 있습니다. Free 플랜에서도 인앱 피드는 동작하며, 웹훅이나 모니터링 규칙을 열면 업그레이드 안내 창이 표시됩니다. 업그레이드 안내가 동작하는 방식과 플랜 변경 위치는 플랜 및 결제를, 전체 플랜 구성은 요금제 페이지를 참고하세요.
CLI로 관리하기
Alpacon CLI에서도 같은 설정을 다룰 수 있습니다.
alpacon webhook: 웹훅을 생성, 조회, 확인, 수정, 삭제합니다. 페이로드 형식과 프로바이더 옵션도 포함합니다.alpacon workspace notifications: 워크스페이스 알림 설정을 조회하고 업데이트합니다.
셀프 호스팅 배포
셀프 호스팅 배포에서는 브라우저 푸시를 사용할 수 없으며, 이메일 전송 여부는 배포 환경에 이메일이 구성되어 있는지에 따라 달라집니다. 인앱 피드와 웹훅은 모든 배포에서 동작합니다.