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

# 활동 로그

> 시스템 변경 이력을 추적하고 모니터링하는 방법을 안내합니다.

## 이 가이드는 누구를 위한 것인가요?

**관리자** 계정으로 시스템 활동을 모니터링하는 분들을 위한 가이드입니다.

* 누가 언제 무엇을 변경했는지 확인하고 싶은 분
* 문제 발생 시 원인을 추적하고 싶은 분
* 시스템 사용 현황을 파악하고 싶은 분

***

## 시작하기 전에

<Note>
  다음 조건이 충족되어야 합니다:

  * A2 관리 콘솔 접속 권한 (**관리자** 역할)
  * 로그 조회 권한 (Audit Log 읽기)
</Note>

***

## 활동 로그란?

A2 플랫폼에서 발생하는 모든 데이터 변경 사항이 자동으로 기록됩니다.

```mermaid theme={null}
flowchart LR
    A[사용자가 작업 수행] --> B[데이터 변경]
    B --> C[활동 로그 자동 기록]
    C --> D[관리자가 조회/분석]
```

### 기록되는 정보

| 항목         | 영어         | 설명                   |
| ---------- | ---------- | -------------------- |
| **이벤트 유형** | Event Type | 어떤 작업인지 (생성, 수정, 삭제) |
| **작업자**    | Actor      | 누가 작업했는지 (이메일)       |
| **작업 시각**  | Timestamp  | 언제 작업했는지             |
| **대상**     | Target     | 어떤 데이터가 변경되었는지       |
| **변경 전 값** | Old Value  | 변경 전 상태              |
| **변경 후 값** | New Value  | 변경 후 상태              |

***

## 활동 로그 조회하기

### 전체 로그 보기

1. **로그** 메뉴로 이동합니다.
2. 최근 활동 로그가 표시됩니다.

### 필터로 검색하기

원하는 로그만 빠르게 찾을 수 있습니다.

| 필터         | 영어         | 설명             | 예시                                          |
| ---------- | ---------- | -------------- | ------------------------------------------- |
| **이벤트 유형** | Event Type | 특정 작업만 검색      | 캠페인 수정                                      |
| **작업자**    | Actor      | 특정 사용자 작업만 검색  | [user@example.com](mailto:user@example.com) |
| **기간**     | Period     | 특정 기간 내 작업만 검색 | 2024-03-01 \~ 2024-03-31                    |

***

## 이벤트 유형 이해하기

### 이벤트 이름 규칙

이벤트 이름은 **\_** 형식입니다.

| 작업     | 영어     | 의미          |
| ------ | ------ | ----------- |
| **생성** | insert | 새 데이터가 만들어짐 |
| **수정** | update | 기존 데이터가 변경됨 |
| **삭제** | delete | 데이터가 삭제됨    |

### 주요 이벤트

<Tabs>
  <Tab title="사용자 관련">
    | 이벤트    | 설명          |
    | ------ | ----------- |
    | 사용자 생성 | 새 계정이 만들어짐  |
    | 사용자 수정 | 사용자 정보가 변경됨 |
    | 사용자 삭제 | 계정이 삭제됨     |
  </Tab>

  <Tab title="캠페인 관련">
    | 이벤트    | 설명          |
    | ------ | ----------- |
    | 캠페인 생성 | 새 캠페인이 만들어짐 |
    | 캠페인 수정 | 캠페인 정보가 변경됨 |
    | 캠페인 삭제 | 캠페인이 삭제됨    |
  </Tab>

  <Tab title="지면 관련">
    | 이벤트   | 설명         |
    | ----- | ---------- |
    | 지면 생성 | 새 지면이 만들어짐 |
    | 지면 수정 | 지면 정보가 변경됨 |
    | 지면 삭제 | 지면이 삭제됨    |
  </Tab>

  <Tab title="배정 관련">
    | 이벤트   | 설명                    |
    | ----- | --------------------- |
    | 배정 생성 | 새 배정이 만들어짐            |
    | 배정 수정 | 배정 상태가 변경됨 (승인, 거절 등) |
    | 배정 삭제 | 배정이 삭제됨               |
  </Tab>

  <Tab title="결제 관련">
    | 이벤트   | 설명                |
    | ----- | ----------------- |
    | 결제 생성 | 새 결제가 발생함         |
    | 결제 수정 | 결제 상태가 변경됨 (환불 등) |
  </Tab>
</Tabs>

***

## 변경 내역 확인하기

로그를 클릭하면 **변경 전/후 값**을 비교할 수 있습니다.

### 예시: 캠페인 수정

| 항목        | 변경 전    | 변경 후     |
| --------- | ------- | -------- |
| **상태**    | 준비 중    | 준비 완료    |
| **일일 예산** | 50,000원 | 100,000원 |

### 생성(Insert)의 경우

* **변경 전**: 없음 (빈 값)
* **변경 후**: 새로 생성된 데이터

### 삭제(Delete)의 경우

* **변경 전**: 삭제된 데이터
* **변경 후**: 없음 (빈 값)

***

## 활용 사례

### 문제 추적

캠페인에 문제가 발생했을 때 변경 이력을 추적합니다.

1. **로그** 메뉴로 이동합니다.
2. **이벤트 유형**을 "캠페인 수정"으로 설정합니다.
3. 해당 캠페인의 변경 이력을 확인합니다.

### 사용자 활동 감사

특정 사용자의 모든 활동을 확인합니다.

1. **로그** 메뉴로 이동합니다.
2. **작업자** 필터에 확인할 사용자의 이메일을 입력합니다.
3. 해당 사용자의 모든 작업 이력을 확인합니다.

### 일일 변경 요약

하루 동안 시스템에서 발생한 모든 변경 사항을 확인합니다.

1. **로그** 메뉴로 이동합니다.
2. **기간** 필터를 오늘로 설정합니다.
3. 오늘 발생한 모든 변경 사항을 확인합니다.

***

## 로그 보관 정책

### 보관 기간

| 항목             | 기간          |
| -------------- | ----------- |
| **전체 로그**      | 무기한 보관 (기본) |
| **한 번에 조회 가능** | 최근 1,024건   |

<Note>
  활동 로그는 **읽기 전용**입니다. 데이터 무결성을 위해 수정하거나 삭제할 수 없습니다.
</Note>

### 조회 성능 최적화

대량의 로그를 조회할 때는 필터를 활용하세요.

<Tip>
  **날짜 범위**와 **이벤트 유형**을 지정하면 조회 속도가 크게 향상됩니다.
</Tip>

***

## 조회 권한

| 역할      | 권한             |
| ------- | -------------- |
| **관리자** | 모든 활동 로그 조회 가능 |
| **매체사** | ❌ 조회 불가        |
| **광고주** | ❌ 조회 불가        |

<Warning>
  활동 로그는 **관리자만** 조회할 수 있습니다. 민감한 시스템 정보가 포함되어 있으므로 신중하게 관리하세요.
</Warning>

***

## 문제 해결

<AccordionGroup>
  <Accordion title="활동 로그를 삭제할 수 있나요?">
    아니요, 활동 로그는 **데이터 무결성**을 위해 삭제할 수 없습니다. 법적 요구사항과 감사 목적으로 영구 보관됩니다.
  </Accordion>

  <Accordion title="어떤 작업이 로그에 기록되나요?">
    데이터베이스의 **생성, 수정, 삭제** 작업이 모두 기록됩니다. 단, 조회(읽기) 작업은 기록되지 않습니다.
  </Accordion>

  <Accordion title="로그 조회가 느려요">
    필터를 사용하여 검색 범위를 좁히세요:

    1. **날짜 범위**를 지정하세요
    2. **이벤트 유형**을 선택하세요
    3. **작업자**를 지정하세요
  </Accordion>

  <Accordion title="API 호출도 로그에 기록되나요?">
    현재는 **데이터 변경 작업만** 기록됩니다. API를 통한 조회(GET) 요청은 별도로 기록되지 않습니다.
  </Accordion>

  <Accordion title="로그에서 특정 캠페인의 이력만 보고 싶어요">
    현재는 캠페인 ID로 직접 필터링하는 기능이 없습니다. **이벤트 유형**을 "캠페인 수정"으로 설정하고 목록에서 찾아보세요.
  </Accordion>

  <Accordion title="로그를 내보낼 수 있나요?">
    현재 로그 내보내기 기능은 제공되지 않습니다. 필요한 경우 관리자에게 별도 문의하세요.
  </Accordion>
</AccordionGroup>

***

## 관리자 가이드를 마치며

여기까지 오셨다면 A2 플랫폼의 관리자 기능을 모두 살펴보셨습니다!

다시 처음부터 확인하고 싶다면: → [관리자 가이드 개요](/guides/platform-admin/ko)