> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Better Stack

> 업타임 모니터링, 인시던트 분류, 온콜 가시성, 로그 검색을 위해 Better Stack을 CloudThinker에 연결합니다

Better Stack 계정을 연결하면 CloudThinker 에이전트가 업타임을 모니터링하고, 인시던트를 분류하고, 온콜 일정을 확인하고, 로그를 검색할 수 있습니다. Better Stack은 **OAuth**를 사용합니다. Better Stack 내부에서 선택한 팀으로 스코프가 지정되어 CloudThinker를 한 번 인증합니다.

## 사전 요구 사항

* 연결할 팀에 접근 권한이 있는 **Better Stack 계정**.
* 해당 팀의 서드파티 앱 인증 권한.

<Info>
  OAuth는 Better Stack 사용자가 이미 볼 수 있는 범위로 연결을 제한합니다. 작동하는 최소 권한 사용자로 연결하세요.
</Info>

## 설정

<Steps>
  <Step title="CloudThinker 열기">
    CloudThinker 워크스페이스에서 **Connections → Better Stack**으로 이동합니다.
  </Step>

  <Step title="OAuth 흐름 시작">
    **Connect**를 클릭하여 Better Stack의 인증 페이지를 엽니다.
  </Step>

  <Step title="CloudThinker 인증">
    로그인하고, 연결할 팀을 선택한 후 접근을 승인합니다.
  </Step>

  <Step title="CloudThinker로 돌아오기">
    리디렉션됩니다. 연결이 **Connected** 상태를 표시합니다.
  </Step>
</Steps>

<Tip>
  팀을 전환하거나 접근을 취소하려면 CloudThinker에서 연결을 해제하고 다시 연결하거나, Better Stack 앱 설정에서 인증을 제거하세요.
</Tip>

## 연결 세부 정보

Better Stack은 OAuth를 사용하므로 저장할 자격 증명 필드가 없습니다. CloudThinker는 접근을 승인한 후 Better Stack이 발급한 인증 토큰을 보유합니다.

## 필수 권한

CloudThinker는 연결된 팀 내에서 인증한 사용자의 가시성을 상속합니다.

* **읽기 작업** (모니터, 인시던트, 온콜, 로그, 메트릭)은 표준 멤버 접근으로 작동합니다.
* **쓰기 작업** (인시던트 승인, 보고서 게시, 대시보드 또는 알림 편집)은 Better Stack 권한 **및** CloudThinker의 명시적인 [승인](/ko/guide/approval)이 필요합니다.

## 에이전트 기능

연결 후 에이전트는 두 가지 Better Stack 서비스에 읽기 접근 권한과 승인이 필요한 쓰기 접근 권한을 갖습니다.

**Uptime**

| 카테고리       | 에이전트가 할 수 있는 작업                      |
| ---------- | ------------------------------------ |
| **모니터**    | 모니터 목록 조회, 기간별 가용성 % 및 응답 시간 검사      |
| **하트비트**   | 크론/예약 작업 하트비트 및 히트율 검사               |
| **인시던트**   | 인시던트, 타임라인, 댓글, 에스컬레이션 옵션 목록 조회 및 검사 |
| **온콜**     | 온콜 일정, 현재 로테이션, 교대 이벤트 확인            |
| **에스컬레이션** | 에스컬레이션 정책 및 심각도 정의 검사                |
| **상태 페이지** | 상태 페이지, 추적 컴포넌트, 과거 보고서 목록 조회        |

**Telemetry**

| 카테고리          | 에이전트가 할 수 있는 작업                   |
| ------------- | --------------------------------- |
| **로그**        | 소스로 스코프가 지정된 로그 검색, 소스 필드 및 구성 검사 |
| **메트릭**       | 메트릭 쿼리 및 카디널리티 검사                 |
| **대시보드 및 차트** | 대시보드, 차트, 템플릿 목록 조회 및 검사          |
| **알림**        | 차트 알림 목록 조회 및 검사                  |
| **오류**        | 최근 오류 목록 조회 및 오류 그룹 검사            |

**쓰기 작업 (승인 필요)**

| 카테고리          | 에이전트가 할 수 있는 작업                    |
| ------------- | ---------------------------------- |
| **인시던트**      | 인시던트 승인, 해결, 재개, 에스컬레이션, 댓글 달기, 생성 |
| **상태 페이지**    | 상태 페이지 보고서 및 업데이트 게시               |
| **대시보드 및 차트** | 대시보드 및 차트 생성, 편집, 이름 변경, 제거        |
| **알림**        | 차트 알림 생성, 편집, 삭제, 일시 중지            |
| **오류**        | 오류 상태 업데이트 (해결 / 무시)               |

<Warning>
  쓰기 작업은 라이브 모니터링 및 인시던트 상태를 변경합니다. CloudThinker는 쓰기를 실행하기 전에 리소스를 명시한 명시적인 [승인](/ko/guide/approval)을 요구합니다.
</Warning>

### 연결 확인

```text theme={null}
@alex list open Better Stack incidents and #alert on anything hitting production
```

### 예시 프롬프트

```text theme={null}
@alex summarize Better Stack incidents from the last 24h and #recommend follow-ups
@alex search api-gateway logs for 5xx in the last hour and #chart by status code
@alex report 24h availability for production monitors
```

<Note>
  로그 검색은 **소스 단위로 스코프가 지정**되므로 전역 검색이 없습니다. 에이전트가 쿼리하기 전에 소스를 확인할 수 있도록 소스 이름(예: `api-gateway`)을 지정하세요.
</Note>

## 문제 해결

<Accordion title="401 Unauthorized로 연결 실패">
  OAuth 토큰이 만료되었거나 접근이 불충분합니다. 연결을 해제하고 다시 연결하세요.
</Accordion>

<Accordion title="리소스에서 404 Not Found 반환">
  리소스가 다른 팀에 속하거나 삭제되었습니다. 연결된 팀에서 다시 목록을 조회하여 현재 ID를 가져오세요.
</Accordion>

<Accordion title="429 Too Many Requests로 요청 실패">
  Better Stack의 속도 제한에 도달했습니다. 에이전트는 자동으로 백오프하고 재시도합니다.
</Accordion>

<Accordion title="로그 쿼리에서 구문 오류 반환">
  Better Stack은 Live Tail 구문을 사용합니다. 에이전트에게 소스에 대한 쿼리 지침을 로드한 후 세부 조정하도록 요청하세요.
</Accordion>

## 보안

* **최소 권한** — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
* **기본 읽기 전용** — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
* **자격증명 교체** — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
* **오프보딩 시 취소** — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.

- **최소 권한 사용자** — CloudThinker에 필요한 접근만으로 인증하세요. 인증 사용자의 팀 멤버십을 CloudThinker가 봐야 하는 범위로 제한하세요.
- **미사용 시 취소** — 연결을 더 이상 사용하지 않는 경우 Better Stack 앱 설정에서 인증을 제거하세요.

## 관련 항목

<CardGroup cols={2}>
  <Card title="Datadog 연결" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/datadog.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=e8382167f2a1eb1e00971b5f4d703d48" href="/ko/guide/connections/datadog" width="24" height="24" data-path="images/icons/datadog.svg">
    옵저버빌리티 및 모니터링
  </Card>

  <Card title="PagerDuty 연결" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/pagerduty.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=cdc34a966d5d46da70c3bc509a2a7492" href="/ko/guide/connections/pagerduty" width="24" height="24" data-path="images/icons/pagerduty.svg">
    인시던트 알림 및 온콜
  </Card>
</CardGroup>