> ## 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.

# PagerDuty

> PagerDuty를 CloudThinker에 연결하여 온콜 관리, 인시던트 알림, 에스컬레이션 정책 통합을 수행합니다

PagerDuty 계정을 연결하면 CloudThinker 에이전트가 인시던트를 관리하고, 온콜 스케줄을 확인하며, 서비스를 모니터링하고, 에스컬레이션 정책을 처리할 수 있습니다. PagerDuty는 생성한 사용자의 권한 범위로 제한된 **User API Token**으로 인증합니다.

***

## 지원 플랫폼

| 플랫폼           | 지원                                                       |
| ------------- | -------------------------------------------------------- |
| **PagerDuty** | 모든 플랜 (Free, Professional, Business, Digital Operations) |

***

## 사전 요구사항

* 어떤 플랜이든 **PagerDuty 계정**.
* **My Profile → User Settings → API Access**에서 생성한 **User API Token**.

<Info>
  General Access REST API Key 대신 **User API Token**을 사용하세요. 사용자 토큰은 해당 사용자가 볼 수 있는 범위로 접근을 제한하여 더 나은 보안 경계를 제공합니다.
</Info>

***

## 설정

<Steps>
  <Step title="PagerDuty 열기">
    [app.pagerduty.com](https://app.pagerduty.com)에서 PagerDuty 계정에 로그인합니다.
  </Step>

  <Step title="User API 키 생성">
    **사용자 아이콘 → My Profile**을 클릭한 후 **User Settings → API Access**로 스크롤하여 **Create API User Token**을 클릭합니다:

    * **Description**: `cloudthinker`
    * **Create Key** 클릭

    키를 즉시 복사합니다 — 다시 표시되지 않습니다.
  </Step>

  <Step title="CloudThinker에서 연결 추가">
    **Connections → PagerDuty**로 이동하여 다음을 입력합니다:

    * **User API Key**: 방금 생성한 토큰

    **Connect**를 클릭합니다. CloudThinker가 자격 증명을 확인하고 **Connected** 상태를 표시합니다.
  </Step>
</Steps>

<Warning>
  API 토큰을 생성한 직후 바로 복사하세요. PagerDuty는 토큰을 다시 표시하지 않으며, 분실한 경우 새 토큰을 생성해야 합니다.
</Warning>

***

## 연결 세부 정보

| 필드                            | 설명                       | 예시           |
| ----------------------------- | ------------------------ | ------------ |
| **PAGERDUTY\_USER\_API\_KEY** | PagerDuty User API Token | `u+xxxxx...` |

***

## 필요 권한

### 최소 권한 (읽기 전용)

**Observer** 또는 **Responder** 역할의 사용자가 제공하는 권한:

* 인시던트, 서비스, 에스컬레이션 정책 확인
* 온콜 스케줄 확인
* 팀 및 사용자 확인

### 권장 권한 (전체 운영)

**Responder** 또는 **Manager** 역할의 사용자가 제공하는 권한:

* 모든 읽기 권한
* 인시던트 확인 및 해결
* 인시던트 및 상태 업데이트 생성
* 온콜 재정의 관리

<Tip>
  최소 권한 원칙을 따르세요: 읽기 전용 모니터링에는 Observer 역할을 지정하고, 인시던트 쓰기 작업이 필요한 경우에만 Responder 또는 Manager로 승격합니다.
</Tip>

***

## 에이전트 기능

연결 후 에이전트는 PagerDuty 데이터를 조회하고 작업할 수 있습니다.

| 기능            | 설명                               |
| ------------- | -------------------------------- |
| **인시던트 트리아지** | 트리거된 인시던트와 확인된 인시던트 목록 조회, 패턴 파악 |
| **온콜 스케줄**    | 현재 온콜 담당자 및 예정된 로테이션 확인          |
| **서비스 헬스**    | 서비스 상태 및 활성 인시던트 수 모니터링          |
| **에스컬레이션 정책** | 에스컬레이션 체인 및 알림 규칙 확인             |
| **인시던트 작업**   | 인시던트 확인, 해결, 메모 추가               |
| **스케줄 관리**    | 스케줄 확인 및 커버리지 공백 파악              |

### 연결 확인

```text theme={null}
@alex list all triggered PagerDuty incidents and report the current on-call schedule
```

### 예시 프롬프트

```text theme={null}
@alex list all triggered and acknowledged incidents and #report any patterns by service
@alex who is currently on-call for the platform-engineering service?
@alex show next week's on-call schedule and identify any coverage gaps
```

***

## 트러블슈팅

<Accordion title="인증 실패">
  토큰이 잘못되었거나 만료되었거나 폐기되었습니다. User API Token을 확인하고, **User Token**(REST API Key가 아님)을 사용하고 있는지 확인한 후 필요한 경우 새 토큰을 생성합니다.
</Accordion>

<Accordion title="권한 거부">
  사용자의 역할 권한이 부족하거나 팀 수준 접근 제한이 있습니다. 쓰기 작업의 경우 사용자에게 Responder 또는 Manager 역할이 있는지 확인합니다.
</Accordion>

<Accordion title="서비스 또는 인시던트가 없음">
  사용자가 관련 팀에 접근할 수 없습니다. 팀 멤버십에 모니터링하려는 서비스가 포함되어 있는지 확인합니다.
</Accordion>

<Accordion title="토큰 폐기됨">
  PagerDuty의 **My Profile → User Settings**로 이동하여 새 API User Token을 생성하고, CloudThinker 연결 설정에서 토큰을 업데이트합니다.
</Accordion>

***

## 보안

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

- **사용자 토큰** — General Access REST API Key 대신 전용 PagerDuty 사용자 범위의 User API Token을 사용합니다.
- **팀 범위 제한** — 전용 사용자의 팀 멤버십을 CloudThinker가 모니터링해야 하는 서비스로만 제한합니다.

***

## 관련 항목

<CardGroup cols={2}>
  <Card title="ServiceNow 연결" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/servicenow.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=3fee0d3d5346b20beb018bcf854e968e" href="/ko/guide/connections/servicenow" width="24" height="24" data-path="images/icons/servicenow.svg">
    ITSM 인시던트 관리
  </Card>

  <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>
</CardGroup>