감사 로그 JSON 스키마

감사 로그 JSON 스키마는 하나의 이벤트가 감사 로그에 기록될 때 어떤 형태여야 하는지를 필드 이름, 데이터 타입, 객체, 구조까지 일관되게 정의하는 표준 청사진 역할을 합니다.

JSON 감사 로깅 스키마의 개요는 아래와 같습니다. 자세한 내용은 JSON 데이터 모델을 참고하세요.

{
    "timestamp": "",       // Event time
    "status": "",          // Success or failure of the audited event or activity
    "event_name": "",      // Logged event name
    "error": {             // Error if status = fail
        "status_code": 0,
        "description": ""
    },
    "actor": {             // The user performing the action
        "user_id": ""           // Unique identifier of the event user
        "session_id": ""        // Unique session identifier of the event user
        "client": ""            // User agent of the client/platform in use by the event user
        "ip_address": ""        // IPv4/IPv6 IP address of the event user
    },
    "event": {             // Event-specific data
        "parameters": {}        // Map containing parameters of the audited event or activity
        "prior_state": {}       // Pre-event state of the object
        "resulting_state": {}   // Post-event state of the object
        "object_type": ""       // Object targeted by the event or activity
    },
    "meta": {
        "api_path": "",                    // API endpoint interacted with for event or activity
        "cluster_id": ""                   // Unique identifier of the cluster in use by the event user
        "non_channel_member_access": false // true if user accessed channel content without being a member (v11.5.0+)
    }
}

감사 로그 레코드 예시

사용자 환경 설정 업데이트

{
    "timestamp": "2022-08-17 20:37:52.846 +01:00",
    "event_name": "updatePreferences",
    "status": "success",
    "actor": {
        "user_id": "aw8ehkwaziytzry1qqxi9tsqwh",
        "session_id": "kth3jyadc3b1p84kbz6y3o75na",
        "client": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6 Safari/605.1.15",
        "ip_address": "192.168.0.169"
    },
    "event": {
        "parameters": {},
        "prior_state": {},
        "resulting_state": {},
        "object_type": ""
    },
    "meta": {
        "api_path": "/api/v4/users/aw8ehkwaziytzry1qqxi9tsqwh/preferences",
        "cluster_id": "8dxdbfx6fpdwtki1z6n8whtkho"
    },
    "error": {}
}

게시물 작성

{
    "timestamp": "2025-04-30 16:17:44.207 Z",
    "event_name": "createPost",
    "status": "success",
    "actor": {
        "user_id": "i764hi6h5bbz8p1955ed4ahj6y",
        "session_id": "t7894ft76igtpb788nkkej1yoy",
        "client": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",
        "ip_address": "172.19.0.8"
    },
    "event": {
        "parameters": {
            "post": {
                "channel_id": "pfis7ycuy78o7m3zebajmxqeuo",
                "user_id": "i764hi6h5bbz8p1955ed4ahj6y",
                "message": "Sample post content"
            }
        },
        "prior_state": {},
        "resulting_state": {
            "channel_id": "pfis7ycuy78o7m3zebajmxqeuo",
            "create_at": 1746029864145,
            "id": "xpw97hf6kfncirzhqisb5sym7e",
            "user_id": "i764hi6h5bbz8p1955ed4ahj6y"
        },
        "object_type": "post"
    },
    "meta": {
        "api_path": "/api/v4/posts",
        "cluster_id": "i5twhjm3ainatcifiy3oksshae"
    },
    "error": {}
}

시스템 설정 변경

{
    "timestamp": "2025-04-30 16:18:30.803 Z",
    "event_name": "patchConfig",
    "status": "success",
    "actor": {
        "user_id": "i764hi6h5bbz8p1955ed4ahj6y",
        "session_id": "t7894ft76igtpb788nkkej1yoy",
        "client": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",
        "ip_address": "172.19.0.8"
    },
    "event": {
        "parameters": {},
        "prior_state": {
            "config_diffs": [
                {
                    "actual_val": false,
                    "base_val": true,
                    "path": "MetricsSettings.EnableClientMetrics"
                }
            ]
        },
        "resulting_state": {},
        "object_type": "config"
    },
    "meta": {
        "api_path": "/api/v4/config/patch",
        "cluster_id": "i5twhjm3ainatcifiy3oksshae"
    },
    "error": {}
}

감사 이벤트 유형

다음 표는 Mattermost 감사 로그에 기록되는 감사 이벤트 유형(event_name 값)을 빠짐없이 정리한 것입니다.

사용자 관리 이벤트

채널 관리 이벤트

팀 관리 이벤트

게시물 및 콘텐츠 이벤트

인증 및 보안 이벤트

시스템 관리 이벤트

파일 관리 이벤트

OAuth 애플리케이션 이벤트

웹훅 이벤트

슬래시 명령어 이벤트

플러그인 이벤트

그룹 및 LDAP 이벤트

원격 클러스터 이벤트

데이터 보존 이벤트

작업 이벤트

라이선스 이벤트

봇 관리 이벤트

사용자 지정 이모지 이벤트

브랜딩 이벤트

검색 이벤트

역할 및 스킴 이벤트

환경 설정 이벤트

채널 카테고리 이벤트

내보내기 및 가져오기 이벤트

접근 제어 이벤트

사용자 속성 이벤트

아웃고잉 OAuth 연결 이벤트

서비스 약관 이벤트

컴플라이언스 및 감사 이벤트

로컬 작업 이벤트

AI 요약(Recap) 이벤트

요약(Recap) 이벤트에는 이벤트 파라미터에 channel_id가 포함되며, 요약 작업 중 어느 채널의 콘텐츠에 접근했는지를 나타냅니다. 컴플라이언스 또는 접근 모니터링 목적으로 감사 로그를 검토할 때 이 필드를 활용하세요.

JSON 데이터 모델

EventData

EventActor

EventMeta

EventError