사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

감사 로그 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+)
        "user_access_token_id": ""         // Unique identifier of the Personal Access Token used to authenticate the request (v11.11.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 값)을 나열합니다.

사용자 관리 이벤트#

채널 관리 이벤트#

팀 관리 이벤트#

게시물 및 콘텐츠 이벤트#

게시물 전달 이벤트#

Mattermost v12.0에서는 메시지 콘텐츠가 사용자 또는 연동에 전달될 때마다 이를 기록하는 postDelivered 감사 로그 이벤트가 도입되었습니다. 이 이벤트는 게시물 전달 감사 로깅을 활성화한 경우에만 발생하며, 이 기능은 기본적으로 비활성화되어 있습니다. 이 페이지의 다른 감사 로그 이벤트와 달리 postDelivered는 전용 audit-delivery 로그 수준에서 발생하므로 별도의 감사 로그 타깃이 필요합니다. 레코드 형식, 페이로드 필드, 전체 전달 메커니즘은 해당 페이지를 참조하세요.

인증 및 보안 이벤트#

시스템 관리 이벤트#

파일 관리 이벤트#

OAuth 애플리케이션 이벤트#

웹훅 이벤트#

슬래시 명령어 이벤트#

플러그인 이벤트#

그룹 및 LDAP 이벤트#

원격 클러스터 이벤트#

데이터 보존 이벤트#

작업 이벤트#

라이선싱 이벤트#

봇 관리 이벤트#

커스텀 이모지 이벤트#

브랜딩 이벤트#

검색 이벤트#

역할 및 스킴 이벤트#

환경설정 이벤트#

채널 카테고리 이벤트#

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

액세스 제어 이벤트#

사용자 속성 이벤트#

아웃고잉 OAuth 연결 이벤트#

서비스 약관 이벤트#

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

로컬 작업 이벤트#

AI 요약 이벤트#

요약 이벤트는 이벤트 매개변수에 channel_id를 포함하며, 이는 요약 작업 중 액세스된 채널의 콘텐츠를 나타냅니다. 컴플라이언스 또는 액세스 모니터링을 위해 감사 로그를 검토할 때 이 필드를 사용하세요.

JSON 데이터 모델#

### EventData

EventActor#

EventMeta#

EventError#