사전 요구 사항
- 연결할 팀에 접근 권한이 있는 Better Stack 계정.
- 해당 팀의 서드파티 앱 인증 권한.
OAuth는 Better Stack 사용자가 이미 볼 수 있는 범위로 연결을 제한합니다. 작동하는 최소 권한 사용자로 연결하세요.
설정
연결 세부 정보
Better Stack은 OAuth를 사용하므로 저장할 자격 증명 필드가 없습니다. CloudThinker는 접근을 승인한 후 Better Stack이 발급한 인증 토큰을 보유합니다.필수 권한
CloudThinker는 연결된 팀 내에서 인증한 사용자의 가시성을 상속합니다.- 읽기 작업 (모니터, 인시던트, 온콜, 로그, 메트릭)은 표준 멤버 접근으로 작동합니다.
- 쓰기 작업 (인시던트 승인, 보고서 게시, 대시보드 또는 알림 편집)은 Better Stack 권한 및 CloudThinker의 명시적인 승인이 필요합니다.
에이전트 기능
연결 후 에이전트는 두 가지 Better Stack 서비스에 읽기 접근 권한과 승인이 필요한 쓰기 접근 권한을 갖습니다. Uptime| 카테고리 | 에이전트가 할 수 있는 작업 |
|---|---|
| 모니터 | 모니터 목록 조회, 기간별 가용성 % 및 응답 시간 검사 |
| 하트비트 | 크론/예약 작업 하트비트 및 히트율 검사 |
| 인시던트 | 인시던트, 타임라인, 댓글, 에스컬레이션 옵션 목록 조회 및 검사 |
| 온콜 | 온콜 일정, 현재 로테이션, 교대 이벤트 확인 |
| 에스컬레이션 | 에스컬레이션 정책 및 심각도 정의 검사 |
| 상태 페이지 | 상태 페이지, 추적 컴포넌트, 과거 보고서 목록 조회 |
| 카테고리 | 에이전트가 할 수 있는 작업 |
|---|---|
| 로그 | 소스로 스코프가 지정된 로그 검색, 소스 필드 및 구성 검사 |
| 메트릭 | 메트릭 쿼리 및 카디널리티 검사 |
| 대시보드 및 차트 | 대시보드, 차트, 템플릿 목록 조회 및 검사 |
| 알림 | 차트 알림 목록 조회 및 검사 |
| 오류 | 최근 오류 목록 조회 및 오류 그룹 검사 |
| 카테고리 | 에이전트가 할 수 있는 작업 |
|---|---|
| 인시던트 | 인시던트 승인, 해결, 재개, 에스컬레이션, 댓글 달기, 생성 |
| 상태 페이지 | 상태 페이지 보고서 및 업데이트 게시 |
| 대시보드 및 차트 | 대시보드 및 차트 생성, 편집, 이름 변경, 제거 |
| 알림 | 차트 알림 생성, 편집, 삭제, 일시 중지 |
| 오류 | 오류 상태 업데이트 (해결 / 무시) |
연결 확인
예시 프롬프트
로그 검색은 소스 단위로 스코프가 지정되므로 전역 검색이 없습니다. 에이전트가 쿼리하기 전에 소스를 확인할 수 있도록 소스 이름(예:
api-gateway)을 지정하세요.문제 해결
401 Unauthorized로 연결 실패
401 Unauthorized로 연결 실패
리소스에서 404 Not Found 반환
리소스에서 404 Not Found 반환
리소스가 다른 팀에 속하거나 삭제되었습니다. 연결된 팀에서 다시 목록을 조회하여 현재 ID를 가져오세요.
429 Too Many Requests로 요청 실패
429 Too Many Requests로 요청 실패
Better Stack의 속도 제한에 도달했습니다. 에이전트는 자동으로 백오프하고 재시도합니다.
로그 쿼리에서 구문 오류 반환
로그 쿼리에서 구문 오류 반환
Better Stack은 Live Tail 구문을 사용합니다. 에이전트에게 소스에 대한 쿼리 지침을 로드한 후 세부 조정하도록 요청하세요.
보안
- 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
- 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
- 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
- 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
- 최소 권한 사용자 — CloudThinker에 필요한 접근만으로 인증하세요. 인증 사용자의 팀 멤버십을 CloudThinker가 봐야 하는 범위로 제한하세요.
- 미사용 시 취소 — 연결을 더 이상 사용하지 않는 경우 Better Stack 앱 설정에서 인증을 제거하세요.
관련 항목
Datadog 연결
옵저버빌리티 및 모니터링
PagerDuty 연결
인시던트 알림 및 온콜