프로젝트 통합
프로젝트 통합
프로젝트에 Slack, Discord, Microsoft Teams, PagerDuty, 이메일, Linear, GitHub Issues를 연결하는 방법을 다뤄요. 통합 기능은 프로젝트와 외부 도구를 이어서 알림을 보내고 프로젝트 관리를 돕는 역할을 해요. 연결된 통합들은 각각 설정한 알림 토글에 따라 이벤트를 받게 돼요.
출처: 문서
본문
알림 (Notifications)
채팅, 이메일, 또는 온콜(on-call) 워크플로우로 팀에 알림을 보낼 수 있어요. 각 알림 통합은 어떤 이벤트가 알림을 트리거할지 개별적으로 토글할 수 있는데, 전체 목록은 알림 이벤트에서 확인할 수 있어요.
Slack
OAuth를 통해 Confident AI를 Slack 워크스페이스와 연결해요. 연결이 끝나면 알림이 게시될 공개 채널을 선택하면 돼요.
Slack을 설정하려면:
- 프로젝트 설정 (Project Settings) → 통합 (Integrations) 으로 이동해요
- Slack 을 클릭해요
- Connect to Slack 을 클릭하면 Slack으로 이동해 통합을 승인하게 돼요
- 승인 후 드롭다운에서 채널을 선택해요
- Save 를 클릭해요
Discord
OAuth를 통해 Confident AI를 Discord 서버와 연결해요. 연결이 끝나면 알림이 게시될 채널을 선택하면 돼요.
Discord를 설정하려면:
- 프로젝트 설정 (Project Settings) → 통합 (Integrations) 으로 이동해요
- Discord 를 클릭해요
- Connect to Discord 를 클릭하면 Discord로 이동해 통합을 승인하게 돼요
- 승인 후 드롭다운에서 채널을 선택해요
- Save 를 클릭해요
Microsoft Teams
수신 웹훅(incoming webhook) URL을 통해 Microsoft Teams 채널로 알림을 보내요.
Microsoft Teams를 설정하려면:
- 프로젝트 설정 (Project Settings) → 통합 (Integrations) 으로 이동해요
- Microsoft Teams 를 클릭해요
- Webhook Endpoint 필드에 Teams의 수신 웹훅 URL을 붙여넣어요 (만드는 방법은 여기에서 확인할 수 있어요)
- Save 를 클릭해요
이메일 (Email)
선택한 프로젝트 멤버에게 이메일로 알림을 보내요.
이메일을 설정하려면:
- 프로젝트 설정 (Project Settings) → 통합 (Integrations) 으로 이동해요
- 이메일 (Email) 을 클릭해요
- 드롭다운에서 프로젝트 멤버를 한 명 이상 선택해요
- Save 를 클릭해요
PagerDuty
Events API v2 라우팅 키(routing key)를 사용해 알림을 PagerDuty로 보내요.
PagerDuty를 설정하려면:
- 프로젝트 설정 (Project Settings) → 통합 (Integrations) 으로 이동해요
- PagerDuty 를 클릭해요
- Routing Key 필드에 PagerDuty Events API v2 라우팅 키를 붙여넣어요
- Save 를 클릭해요
라우팅 키는 PagerDuty의 서비스 (Services) → Service Directory → 본인 서비스 → 통합 (Integrations) 에서 찾을 수 있어요.
프로젝트 관리 (Project Management)
트레이스에서 바로 팀의 업무 관리 도구로 티켓을 생성할 수 있어요. 알림 통합과 달리 프로젝트 관리 통합은 이벤트가 아니라 트레이스 상세 보기에서 수동으로 트리거돼요.
Linear
OAuth를 통해 Confident AI를 Linear 워크스페이스와 연결해요. 연결이 끝나면 티켓이 생성될 팀을 선택해요. 그러면 Observatory의 아무 트레이스에서나 바로 Linear 티켓을 열 수 있어요.
Linear를 설정하려면:
- 프로젝트 설정 (Project Settings) → 통합 (Integrations) 으로 이동해요
- Linear 를 클릭해요
- Connect to Linear 을 클릭하면 Linear로 이동해 통합을 승인하게 돼요
- 승인 후 드롭다운에서 팀을 선택해요
- Save 를 클릭해요
GitHub Issues
GitHub 조직이나 계정에 Confident AI GitHub App을 설치하고, 이슈가 생성될 저장소를 선택해요. 그러면 Observatory의 아무 트레이스에서나 바로 GitHub 이슈를 열 수 있어요.
GitHub Issues를 설정하려면:
- 프로젝트 설정 (Project Settings) → 통합 (Integrations) 으로 이동해요
- GitHub Issues 를 클릭해요
- Install GitHub App 을 클릭하면 GitHub로 이동해 조직이나 계정에 앱을 설치하게 돼요
- 설치 후 드롭다운에서 저장소를 선택해요
- Save 를 클릭해요
Confident AI의 GitHub 접근을 완전히 제거하려면, 여기서 연결을 해제한 뒤 GitHub 조직 설정에서 앱을 제거해야 해요.
알림 이벤트 (Notification events)
각 알림 통합은 연결 후에 개별 이벤트 유형을 켜고 끌 수 있어요. 사용 가능한 이벤트는 통합에 따라 달라져요.
| 이벤트 (Event) | 설명 (Description) | 지원 통합 (Supported by) |
|---|---|---|
| Notify on Test Run Complete | 프로젝트에서 테스트 실행이 완료될 때마다 발생해요 | Slack, Discord, Teams, Email, PagerDuty |
| Notify on Comment | 트레이스, 스팬, 스레드, 또는 테스트 케이스에 댓글이 달릴 때마다 발생해요 | Slack, Discord |
| Notify on Alert | 프로젝트 알림이 트리거될 때마다 발생해요 | Slack, Discord, Teams, Email, PagerDuty |
통합을 연결하고 저장해야 그 알림 토글이 활성화돼요.