> ## Documentation Index
> Fetch the complete documentation index at: https://www.perplexity.ai/help-center/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/).

# 감사 로그

> 웹훅으로 전송되는 감사 로그를 사용하여 Enterprise 조직에서 지원되는 활동을 추적합니다.

## 개요

감사 로그는 시트가 50개 이상이거나 [Enterprise Max](https://www.perplexity.ai/help-center/help-center/ko/articles/12310544-enterprise-max는-무엇인가요.md) 시트가 하나 이상인 Enterprise 조직에서 사용할 수 있습니다. 관리자는 감사 로그를 사용하여 활동을 조사하고 관리상의 변경 사항을 모니터링할 수 있습니다.

기록된 이벤트를 웹훅으로 수신할 수 있습니다. 쿼리와 답변 텍스트는 처음 500자로 제한됩니다.

감사 로그는 모든 작업을 기록하지 않습니다. ID 공급자와 멤버십을 동기화하는 SCIM이나 일괄 처리 도구를 통해 변경한 시트 등급은 감사 로그에 기록되지 않습니다. CSV 일괄 작업을 통한 구성원 추가 및 제거도 제외됩니다.

## 시작하기 전에

* 조직이 위의 시트 요건을 충족하는지 확인합니다.
* 조직 설정에 액세스할 수 있는 관리자에게 로깅 활성화를 요청합니다.
* 웹훅 전송을 사용하려면 HTTPS 엔드포인트와 인증 값을 준비합니다.

## 개인정보 보호 및 데이터 보안

웹훅 페이로드는 활동 식별자뿐 아니라 개인정보와 기록된 콘텐츠를 포함할 수 있습니다. 이벤트에 따라 메타데이터에 쿼리 및 답변 텍스트, 파일 이름, 대상 구성원의 이메일 주소, 조직 설정 값, Perplexity Computer 작업 세부 정보가 포함될 수 있습니다.

수집한 로그에 대한 액세스는 조직의 개인정보 보호정책에 따라 제한하세요. 웹훅 URL과 인증 값을 기밀로 유지하세요.

Enterprise 전반의 데이터 처리 방식은 [기업 조직 및 사용자를 위한 데이터 보존 및 개인정보 보호](https://www.perplexity.ai/help-center/help-center/ko/articles/11187708-기업-조직-및-사용자를-위한-데이터-보존-및-개인정보-보호.md)를 참고하세요. [신뢰 센터](https://trust.perplexity.ai)에서는 보안 및 규정 준수 문서를 제공하며, [데이터 처리 부록](https://www.perplexity.ai/hub/legal/dpa)은 계약에 포함되는 경우 적용되는 데이터 처리 계약 조건을 규정합니다.

## 감사 로그 활성화

1. [**조직 설정**](https://www.perplexity.ai/account/org/details)으로 이동합니다.
2. **데이터 및 개인정보 보호**를 엽니다.
3. **감사 로그 설정**에서 **감사 로깅 활성화**를 켭니다.

   [![감사 로깅 활성화 토글이 꺼져 있는 감사 로그 설정.](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/4e223dea80_Enable_2BAudit_2BLogging.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=d63b4606c88adfad0dbcec3af53850fb)](https://www.perplexity.ai/help-center/help-center/assets/img/4e223dea80_Enable_2BAudit_2BLogging.png)

   *그림 1: 감사 로그 설정의 감사 로깅 활성화 컨트롤.*

웹훅 전송을 사용하려면 다음 단계를 완료합니다.

1. 웹훅 URL을 지정하는 필드에 HTTPS 엔드포인트를 입력합니다.

   [![로깅이 활성화되어 있고 웹훅 URL 필드와 선택 사항인 인증 헤더 필드가 표시된 감사 로그 설정.](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/b01c823af0_Audit_2BLog_2BSettings.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=42d2df5403254f2c0df98178bdb9d006)](https://www.perplexity.ai/help-center/help-center/assets/img/b01c823af0_Audit_2BLog_2BSettings.png)

   *그림 2: 웹훅 URL 및 인증 헤더 설정.*

2. 웹훅 URL 필드 옆의 **저장**을 클릭합니다.

3. 엔드포인트에 인증이 필요한 경우 인증 헤더를 지정하는 필드에 값을 입력합니다.

4. 인증 헤더 필드 옆의 **저장**을 클릭합니다.

인증 스킴을 지정하지 않으면 입력한 값은 Bearer 토큰으로 전송됩니다. 지원되는 두 형식은 [웹훅 인증](#webhook-authentication)을 참고하세요.

### 정상 작동 확인

지원되는 작업을 수행한 후 수신 엔드포인트가 웹훅 이벤트를 받고 HTTP `2xx` 응답을 반환하는지 확인합니다.

## 웹훅 인증

Bearer 토큰 또는 완전한 인증 값으로 웹훅 엔드포인트를 보호할 수 있습니다. 수신 엔드포인트에서 요구하는 값을 구성하세요.

### Bearer 토큰

`YOUR_WEBHOOK_TOKEN`처럼 접두사 없이 토큰을 입력합니다. Perplexity는 앞에 `Bearer`를 붙여 `Authorization: Bearer YOUR_WEBHOOK_TOKEN`으로 전송합니다.

### 사용자 지정 인증 헤더

인증 스킴을 포함한 완전한 인증 값을 입력합니다. 예를 들어 `Splunk YOUR_HEC_TOKEN`은 `Authorization: Splunk YOUR_HEC_TOKEN`으로 전송됩니다.

## 웹훅 전송

### 요청 형식

감사 로그는 HTTP `POST` 요청으로 웹훅 URL에 전송됩니다. 요청 본문은 `application/json`을 사용합니다.

### 인증 헤더

인증 값을 구성한 경우 Perplexity는 해당 값을 `Authorization` 헤더에 포함합니다. Bearer 및 사용자 지정 스킴 형식은 [웹훅 인증](#webhook-authentication)을 참고하세요.

### 응답 처리

웹훅 엔드포인트는 1초 이내에 HTTP `2xx` 응답을 반환하여 수신을 확인해야 합니다. Perplexity는 HTTP `4xx` 및 `5xx` 응답을 포함한 전송 오류를 기록하지만, 실패하거나 시간이 초과된 전송을 자동으로 재시도하지는 않습니다. 수신 엔드포인트에서 오류와 누락된 이벤트를 모니터링하세요.

## 웹훅 감사 로그 스키마

웹훅 이벤트는 아래 필드를 사용합니다.

| 필드 | 유형 | 필수 | 설명 |
| - | - | - | - |
| `uuid` | 문자열 | 예 | 이벤트 식별자 |
| `timestamp` | 문자열 | 예 | RFC 3339 타임스탬프 |
| `event_type` | 문자열 | 예 | 이벤트 유형 |
| `user_email` | 문자열 | 예 | 작업을 수행한 구성원의 이메일 |
| `ip_address` | 문자열 | 예 | 클라이언트 주소 또는 IP 주소가 아님을 나타내는 값 |
| `user_agent` | 문자열 | 예 | 클라이언트 사용자 에이전트 |
| `session_id` | 문자열 또는 null | 아니요 | 관련 이벤트 식별자 |
| `user_id` | 문자열 또는 null | 아니요 | 기록된 경우의 사용자 식별자 |
| `metadata` | 객체 또는 null | 아니요 | 이벤트별 데이터 |

*표 1: 웹훅 페이로드 필드.*

필수 문자열 필드라도 값이 기록되지 않으면 비어 있을 수 있습니다. 모든 `ip_address` 값이 IP 주소라고 가정하지 마세요.

### 이벤트 유형

다음 표는 문서화된 웹훅 이벤트 유형을 설명합니다. 모든 작업이 기록된다는 보장은 아닙니다.

#### 사용자 활동 이벤트

| 이벤트 유형 | 설명 |
| - | - |
| `login` | 로그인 성공 |
| `query` | 검색 쿼리 제출 |
| `answer_generated` | 답변 반환 |
| `file_upload` | 쿼리 또는 프로젝트에 파일 업로드 |
| `file_download` | 프로젝트에서 파일 다운로드 |
| `file_delete` | 쿼리 또는 프로젝트에서 파일 삭제 |

*표 2: 사용자 활동 이벤트.*

쿼리 이벤트에는 첨부된 각 파일의 `file_uuid`와 `file_name`을 포함하는 `metadata.attachments`가 있을 수 있습니다.

#### 스레드 이벤트

| 이벤트 유형 | 설명 |
| - | - |
| `thread_forked` | 스레드 복사 |
| `thread_exported` | 스레드 내보내기 |
| `thread_shared` | 스레드 공유 |
| `thread_deleted` | 스레드 삭제 |

*표 3: 스레드 이벤트.*

#### 멤버십 이벤트

| 이벤트 유형 | 설명 |
| - | - |
| `member_invited` | 구성원 초대 |
| `member_invite_rescinded` | 대기 중인 초대 철회 |
| `member_removed` | 구성원 제거 |
| `member_role_changed` | 구성원 역할 변경 |

*표 4: 멤버십 이벤트.*

#### 조직 이벤트

| 이벤트 유형 | 설명 |
| - | - |
| `organization_settings_update` | 조직 설정 변경 |

*표 5: 조직 이벤트.*

#### 역할 및 그룹 이벤트

| 이벤트 유형 | 설명 |
| - | - |
| `role_created` | 사용자 지정 역할 생성 |
| `role_updated` | 역할 세부 정보 또는 권한 업데이트 |
| `role_deleted` | 사용자 지정 역할 삭제 |
| `role_users_changed` | 역할에 사용자 추가 또는 역할에서 사용자 제거 |
| `role_groups_changed` | 역할에 그룹 추가 또는 역할에서 그룹 제거 |
| `group_created` | 사용자 그룹 생성 |
| `group_deleted` | 사용자 그룹 삭제 |
| `group_members_changed` | 그룹 멤버십 변경 |

*표 6: 역할 및 그룹 이벤트.*

`role_users_changed`와 `role_groups_changed`의 메타데이터에는 값이 `added` 또는 `removed`인 `action`이 포함될 수 있습니다. 이 필드를 사용하여 멤버십 변경이 추가인지 제거인지 구분합니다.

#### Comet 에이전트 이벤트

| 이벤트 유형 | 설명 |
| - | - |
| `comet_agent_action` | Comet의 자동 작업 |

*표 7: Comet 에이전트 이벤트.*

#### 커넥터 이벤트

| 이벤트 유형 | 설명 |
| - | - |
| `connector_connected` | 타사 커넥터 연결 |
| `connector_disconnected` | 타사 커넥터 연결 해제 |

*표 8: 커넥터 이벤트.*

#### Computer 이벤트

| 이벤트 유형 | 설명 |
| - | - |
| `computer_task_started` | Computer 작업 시작 |
| `computer_agent_action` | 작업 실행 중 자동 동작 |
| `computer_task_completed` | 작업 정상 완료 |
| `computer_task_error` | 오류로 인한 작업 실패 |

*표 9: Computer 이벤트.*

### 웹훅 페이로드 예제

다음 JSON 페이로드는 일반 웹훅으로 전송되는 쿼리 이벤트를 설명하기 위한 예제입니다.

```json theme={null}
{
  "uuid": "6ba7b810-9dad-41d1-80b4-00c04fd430c8",
  "timestamp": "2026-10-28T09:05:31+00:00",
  "event_type": "query",
  "user_email": "member@example.com",
  "ip_address": "203.0.113.45",
  "user_agent": "ExampleClient/1.0",
  "session_id": "query_abc123",
  "metadata": {
    "query_str": "What are the best practices for API security?"
  }
}
```

## 플랫폼별 형식

### Slack 웹훅

웹훅 URL이 `https://hooks.slack.com`으로 시작하면 Perplexity는 Slack의 Block Kit 형식을 사용합니다. `blocks` 배열에는 이벤트 유형, 구성원 및 클라이언트 세부 정보, 그리고 기록된 경우 이벤트 메타데이터를 위한 섹션이 포함됩니다.

이벤트 유형 레이블은 밑줄을 제거하고 각 단어의 첫 글자를 대문자로 표시합니다. Slack 형식에서는 개별 메타데이터 값은 500자, 메타데이터 섹션은 2,500자에서 잘리며, 긴 값에는 잘림 안내가 표시됩니다.

### Splunk HTTP 이벤트 수집기

인증 값이 `Splunk`로 시작하면 Perplexity는 Splunk의 HTTP 이벤트 수집기(HEC)를 위해 페이로드를 `event` 객체로 감쌉니다. 다음 예제는 이 래퍼 구조를 설명합니다.

```json theme={null}
{
  "event": {
    "uuid": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
    "timestamp": "2026-10-28T09:05:31+00:00",
    "event_type": "login",
    "user_email": "member@example.com",
    "ip_address": "203.0.113.45",
    "user_agent": "ExampleClient/1.0",
    "session_id": null,
    "metadata": {}
  }
}
```

### 일반 웹훅

그 외 웹훅 대상으로는 플랫폼별 래퍼 없이 표준 JSON 페이로드를 전송합니다. 형식은 [웹훅 페이로드 예제](#webhook-payload-example)를 참고하세요.

## 일반적인 웹훅 사용 사례

### 리서치 세션 추적

`session_id`를 사용하여 쿼리와 답변을 연결합니다.

**1. 쿼리 이벤트 찾기**

이벤트 메타데이터의 `query_str`을 확인합니다. 관련 이벤트를 찾을 수 있도록 `session_id`를 기록합니다.

**2. 답변 이벤트 연결**

동일한 `session_id`를 가진 `answer_generated` 이벤트를 찾습니다. 기록된 경우 `answer`에는 답변의 처음 최대 500자가 포함되며, 사용된 `model`도 함께 기록됩니다.

### 파일 액세스 모니터링

파일 식별자를 사용하여 업로드와 다운로드를 연결합니다. 웹훅 이벤트 메타데이터에는 기록된 파일 및 프로젝트 세부 정보가 포함될 수 있습니다.

**1. 파일 업로드 찾기**

업로드 이벤트의 `file_uuid`를 확인합니다. 이후 이벤트와 비교할 수 있도록 식별자를 기록합니다.

**2. 파일 다운로드 연결**

동일한 `file_uuid`를 가진 다운로드 이벤트를 찾습니다. 작업 수행자 및 타임스탬프 필드를 사용하여 누가 언제 파일에 액세스했는지 확인합니다.

### 구성 변경 감사

`organization_settings_update`에서는 설정의 `key`가 변경된 항목을 식별합니다. 웹훅 메타데이터에는 `old_value`와 `new_value`가 포함될 수 있습니다.

자체 분석 시스템에서 저장된 웹훅 데이터를 `user_email`로 필터링하여 어떤 관리자가 변경했는지 추적할 수 있습니다.

## 모범 사례

### 웹훅 엔드포인트 구현

* **신속한 응답**: 1초 이내에 수신을 확인합니다.
* **비동기 처리**: 수신한 이벤트를 처리 대기열에 추가합니다.
* **페이로드 검증**: 수집 전에 구조와 내용을 확인합니다.
* **엔드포인트 보안**: HTTPS를 사용하고 구성된 인증 값을 검증합니다.
* **오류 모니터링**: 수신 측 오류를 기록하고 전송 누락을 조사합니다.

### 수집한 로그 저장 및 분석

* **보존 정책 설정**: 조직에서 요구하는 기간 동안 수집한 로그를 보관합니다.
* **관련 필드 인덱싱**: 이벤트 유형, 작업 수행자, 타임스탬프, 세션 필드를 분석에 사용합니다.
* **활동 연결**: `session_id`를 사용하여 관련 이벤트를 연결합니다.
* **패턴 모니터링**: 비정상적인 액세스나 관리상의 변경 사항을 조사합니다.
* **백업 유지**: 조직의 보안 및 개인정보 보호정책에 따라 사본을 보관합니다.

## 문제 해결

| 증상 | 가능한 원인 | 다음 단계 |
| - | - | - |
| 웹훅 이벤트가 수신되지 않음 | 로깅 또는 엔드포인트 설정이 완료되지 않았을 수 있음 | 로깅이 활성화되어 있고 HTTPS 엔드포인트가 저장되어 있는지 확인합니다 |
| 엔드포인트가 HTTP `4xx` 또는 `5xx`를 반환함 | 수신 엔드포인트가 요청을 거부했거나 오류가 발생함 | 수신 측 로그와 설정된 인증 값을 확인합니다 |
| 전송 실패 후 이벤트가 누락됨 | 실패한 전송은 자동으로 재시도되지 않음 | 수신 측 오류를 모니터링하고 자동 재전송에 의존하지 마세요 |

*표 10: 일반적인 웹훅 전송 문제.*

지원팀에 문의할 때는 정확한 오류, 영향을 받은 이벤트 또는 전송 실패의 시각, 시간대, 이미 시도한 단계를 포함하세요. 인증 값, 토큰 및 민감한 이벤트 내용은 제외하세요.

## 자주 묻는 질문

### 시트가 50개 미만이어도 감사 로그를 사용할 수 있나요?

예. 시트가 50개 미만인 조직도 하나 이상의 시트가 Enterprise Max 플랜이면 감사 로그에 액세스할 수 있습니다. 이용 조건은 [Enterprise Max는 무엇인가요?](https://www.perplexity.ai/help-center/help-center/ko/articles/12310544-enterprise-max는-무엇인가요.md)를 참고하세요.

### 실수로 감사 로그를 활성화하여 예상치 못한 요금이 청구되면 어떻게 하나요?

청구 내역과 환불 가능 여부를 검토하려면 담당 어카운트 팀에 문의하거나 [**도움말 > 지원팀에 문의**](https://www.perplexity.ai/?support=true#settings/account)를 이용하세요. [환불](https://www.perplexity.ai/help-center/help-center/ko/articles/10354288-환불.md)도 참고하세요. 감사 로그를 비활성화한다고 해서 청구 취소가 보장되는 것은 아닙니다.

## 관련 참조 문서

* [Enterprise 역할 및 권한](https://www.perplexity.ai/help-center/help-center/ko/articles/11187754-enterprise-yeokhal-mich-gwonhan.md)
* [Enterprise Max는 무엇인가요?](https://www.perplexity.ai/help-center/help-center/ko/articles/12310544-enterprise-max는-무엇인가요.md)
* [기업 조직 및 사용자를 위한 데이터 보존 및 개인정보 보호](https://www.perplexity.ai/help-center/help-center/ko/articles/11187708-기업-조직-및-사용자를-위한-데이터-보존-및-개인정보-보호.md)
* [Enterprise용 데이터 보존](https://www.perplexity.ai/help-center/help-center/ko/articles/11652701-enterprise용-데이터-보존.md)

## 도움이 더 필요하신가요?

담당 어카운트 팀에 문의하거나 [**도움말 > 지원팀에 문의**를 통해 연락하세요](https://www.perplexity.ai/?support=true#settings/account). 보안 및 규정 준수 문서는 [**신뢰 센터**](https://trust.perplexity.ai)에서 확인하세요.


## Related topics

- [Enterprise 역할 및 권한](https://www.perplexity.ai/help-center/help-center/ko/articles/11187754-enterprise-yeokhal-mich-gwonhan.md)
- [커넥터 역할 기반 액세스 제어](https://www.perplexity.ai/help-center/help-center/ko/articles/2026100201-커넥터-역할-기반-액세스-제어.md)
- [Perplexity와 Snowflake 연결하기](https://www.perplexity.ai/help-center/help-center/ko/articles/14017006-connecting-perplexity-with-snowflake.md)
- [기업 조직 및 사용자를 위한 데이터 보존 및 개인정보 보호](https://www.perplexity.ai/help-center/help-center/ko/articles/11187708-기업-조직-및-사용자를-위한-데이터-보존-및-개인정보-보호.md)