감사 로그

감사 로그는 다음 이벤트의 무엇을, 언제, 어떤 IP 주소에서 했는지를 포함하여 Amplitude 조직 전반의 보안 이벤트와 사용자 행동을 추적합니다. 조직 관리자는 이를 사용하여 구성 변경, 사용자 액세스 및 인증 작업을 모니터링합니다.

범주별 추적된 이벤트

감사 로그는 다음 이벤트를 추적합니다.

이벤트별로 캡처된 데이터

각 감사 로그 항목에는 다음이 포함됩니다.

주요 동작 및 참고 사항

• 감사 로그는 최대 90일간의 데이터를 보존합니다.
• 감사 로깅은 비동기식이며 사용자의 원래 작업을 차단하지 않습니다.
• Amplitude는 이벤트를 자동으로 캡처하므로 계측을 추가할 필요가 없습니다.
• 감사 로그의 범위는 조직에 해당합니다.
• 관리자는 조직의 모든 프로젝트에서 이벤트에 액세스할 수 있습니다.
• UI에서 사용자 이메일별로 감사 로그를 검색할 수 있습니다.
• 감사 로그는 미국과 EU를 비롯한 모든 운영 환경에 존재합니다.

감사 로그 액세스

Amplitude의 조직 설정 페이지에서 또는 감사 로그 API를 통해 감사 로그에 액세스할 수 있습니다.

UI에서 감사 로그에 액세스

1. _조직 설정_으로 이동합니다.
2. 감사 로그 탭을 선택합니다.

조직 관리자만 감사 로그 메뉴 항목에 액세스할 수 있습니다.

요약 카드

감사 로그 뷰의 맨 위에 있는 요약 카드에는 날짜 선택기에서 선택한 기간에 대한 개수가 표시됩니다:

고위험 이벤트 테이블

필터링된 테이블에는 사용자를 조직 관리자로 승격시키거나 조직 링크 설정 업데이트와 같은 위험도가 높은 보안 이벤트만 표시됩니다. 이 테이블을 검색하고 정렬할 수 있습니다.

제어

API를 통해 감사 로그에 액세스

전체 원시 감사 로그에 프로그래밍 방식으로 액세스하려면 REST API 엔드포인트를 사용하여 원시 감사 로그를 쿼리하고 다운로드하십시오.

조직 비밀 키 획득

API를 사용하기 전에 조직 비밀 키를 요청하십시오. Amplitude 고객 지원팀에 문의하여 조직 ID를 제공하십시오. 지원 부서에서 사용자의 키를 생성한 후에는 이 키를 사용하여 인증하고 감사 로그를 안전하게 다운로드할 수 있습니다.

API 요청 제출

엔드포인트:

POST https://amplitude.com/api/2/audit-logs/<ORG_ID>

요청 예:

curl -X POST "https://amplitude.com/api/2/audit-logs/76273" \
  -H "Authorization: Basic Base64<ORG_API_KEY:ORG_SECRET_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "start_date": "2025-11-01T00:00:00Z",
    "end_date": "2025-11-10T23:59:59Z",
    "filters": {
      "domain": "auth",
      "feature": "auth",
      "action": "login"
    },
    "pagination": {
      "limit": 100
    }
  }'

필수 매개 변수

다른 모든 필드(filters, pagination)는 선택 사항이며 쿼리를 구체화합니다.

API 제한 사항

• 각 요청에 대한 최대 30일의 쿼리 범위입니다.
• 90일 데이터 리텐션: 최근 90일 동안의 감사 로그 데이터에만 액세스할 수 있습니다.