Slack 봇 설정 가이드
인프라 장애 및 주요 이벤트를 실시간으로 통보받기 위한 GIIP 전용 Slack 봇(App) 설정 방법을 안내합니다.
📋 개요
Slack 봇은 GIIP 플랫폼에서 감지된 크리티컬한 이슈나 리소스 부족 현상을 담당자의 Slack 채널로 즉시 전파합니다. 이를 통해 웹 대시보드를 계속 보고 있지 않아도 신속한 대응이 가능해집니다.
🔍 주요 설정 단계
1. Slack App 생성 및 토큰 발급
- Slack API 사이트에서 'Create New App'을 진행합니다.
- Bot Type:
,chat:write
권한을 부여합니다.incoming-webhook - Bot User OAuth Token:
로 시작하는 토큰을 복사합니다.xoxb-
2. GIIP에 봇 등록
- GIIP [알림 설정] 메뉴에 복사한 토큰을 입력합니다.
- 알림을 받을 기본 채널 ID를 입력합니다. (예:
)C0123456789
3. 알림 필터 및 유형 선택
모든 이벤트를 다 받으면 소음이 될 수 있으므로, 필요한 유형만 선택하세요.
- Critical Issues: 서버 다운, 연결 끊김 등 즉시 조치가 필요한 항목
- AI Recommendations: 비용 절감이나 자원 최적화 제안
- Security Alerts: 비정상 로그인 시도나 보안 위협 감지
🛠️ 설정 방법
- GIIP [시스템 관리] > [Slack 봇 설정] 메뉴로 이동합니다.
- [Register New Bot] 버튼을 클릭하여 발급받은 Bot Token과 Channel ID를 입력합니다.
- [Send Test Message]를 눌러 해당 Slack 채널에 "GIIP 연동 성공" 메시지가 오는지 확인합니다.
- 하단의 알림 체크박스를 통해 수신할 이벤트 범위를 결정하고 저장합니다.
💡 활용 팁
- 채널 분리: '운영 전용' 채널과 'R&D 전용' 채널을 분리하여 각 담당자에게 필요한 알림만 가도록 설정하세요.
- 슬랙 커맨드 활용: GIIP 봇에게
와 같은 명령어를 입력하여 현재 인프라 요약 정보를 Slack 내에서 즉시 조회할 수도 있습니다. (추후 지원 예정)/giip status
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| [Send Test Message]를 눌러도 채널에 "GIIP 연동 성공" 메시지가 오지 않음 | 봇이 해당 채널에 초대되지 않았거나 Channel ID가 잘못됨 | 대상 채널에 봇을 초대하고 입력한 채널 ID(예: |
| 토큰 저장 시 인증 오류가 발생함 | | Slack 앱의 Bot User OAuth Token( |
| 봇이 메시지를 게시하지 못하거나 권한 오류가 표시됨 | | Slack 앱에 해당 권한을 추가한 뒤 앱을 재설치(Reinstall)합니다. |
| 설정을 저장했는데 알림이 오지 않음 | 알림 유형 체크박스가 선택되지 않음 | 수신할 이벤트 유형(Critical Issues 등)을 선택하고 저장합니다. |
버전: 1.0 최종 업데이트: 2026-03-19 소스 파일:
giipv3/public/help/slack-bot-setup.ko.md