지원 플랫폼
| 플랫폼 | 지원 |
|---|---|
| PagerDuty | 모든 플랜 (Free, Professional, Business, Digital Operations) |
사전 요구사항
- 어떤 플랜이든 PagerDuty 계정.
- My Profile → User Settings → API Access에서 생성한 User API Token.
General Access REST API Key 대신 User API Token을 사용하세요. 사용자 토큰은 해당 사용자가 볼 수 있는 범위로 접근을 제한하여 더 나은 보안 경계를 제공합니다.
설정
PagerDuty 열기
app.pagerduty.com에서 PagerDuty 계정에 로그인합니다.
User API 키 생성
사용자 아이콘 → My Profile을 클릭한 후 User Settings → API Access로 스크롤하여 Create API User Token을 클릭합니다:
- Description:
cloudthinker - Create Key 클릭
연결 세부 정보
| 필드 | 설명 | 예시 |
|---|---|---|
| PAGERDUTY_USER_API_KEY | PagerDuty User API Token | u+xxxxx... |
필요 권한
최소 권한 (읽기 전용)
Observer 또는 Responder 역할의 사용자가 제공하는 권한:- 인시던트, 서비스, 에스컬레이션 정책 확인
- 온콜 스케줄 확인
- 팀 및 사용자 확인
권장 권한 (전체 운영)
Responder 또는 Manager 역할의 사용자가 제공하는 권한:- 모든 읽기 권한
- 인시던트 확인 및 해결
- 인시던트 및 상태 업데이트 생성
- 온콜 재정의 관리
에이전트 기능
연결 후 에이전트는 PagerDuty 데이터를 조회하고 작업할 수 있습니다.| 기능 | 설명 |
|---|---|
| 인시던트 트리아지 | 트리거된 인시던트와 확인된 인시던트 목록 조회, 패턴 파악 |
| 온콜 스케줄 | 현재 온콜 담당자 및 예정된 로테이션 확인 |
| 서비스 헬스 | 서비스 상태 및 활성 인시던트 수 모니터링 |
| 에스컬레이션 정책 | 에스컬레이션 체인 및 알림 규칙 확인 |
| 인시던트 작업 | 인시던트 확인, 해결, 메모 추가 |
| 스케줄 관리 | 스케줄 확인 및 커버리지 공백 파악 |
연결 확인
예시 프롬프트
트러블슈팅
인증 실패
인증 실패
토큰이 잘못되었거나 만료되었거나 폐기되었습니다. User API Token을 확인하고, User Token(REST API Key가 아님)을 사용하고 있는지 확인한 후 필요한 경우 새 토큰을 생성합니다.
권한 거부
권한 거부
사용자의 역할 권한이 부족하거나 팀 수준 접근 제한이 있습니다. 쓰기 작업의 경우 사용자에게 Responder 또는 Manager 역할이 있는지 확인합니다.
서비스 또는 인시던트가 없음
서비스 또는 인시던트가 없음
사용자가 관련 팀에 접근할 수 없습니다. 팀 멤버십에 모니터링하려는 서비스가 포함되어 있는지 확인합니다.
토큰 폐기됨
토큰 폐기됨
PagerDuty의 My Profile → User Settings로 이동하여 새 API User Token을 생성하고, CloudThinker 연결 설정에서 토큰을 업데이트합니다.
보안
- 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
- 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
- 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
- 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
- 사용자 토큰 — General Access REST API Key 대신 전용 PagerDuty 사용자 범위의 User API Token을 사용합니다.
- 팀 범위 제한 — 전용 사용자의 팀 멤버십을 CloudThinker가 모니터링해야 하는 서비스로만 제한합니다.
관련 항목
ServiceNow 연결
ITSM 인시던트 관리
Datadog 연결
옵저버빌리티 및 모니터링