감사 로그

감사 로그 페이지에서는 조직 내에서 발생한 모든 중요한 이벤트를 조회하고 관리할 수 있습니다. 사용자 활동, 시스템 변경사항, 보안 관련 이벤트 등을 추적하여 조직의 보안 및 컴플라이언스를 강화할 수 있습니다.

감사 로그 조회

로그 목록 보기

감사 로그 페이지에서는 시간순으로 정렬된 이벤트 목록을 확인할 수 있습니다. 각 로그 항목에는 다음 정보가 포함됩니다:

• 시간: 이벤트 발생 시간
• 사용자: 이벤트를 발생시킨 사용자 정보
• 이벤트 정보: 발생한 이벤트의 종류 및 상세 정보

이벤트 타입 필터

특정 유형의 이벤트만 조회할 수 있습니다. 드롭다운 메뉴에서 원하는 이벤트 타입을 선택하면 해당 타입의 로그만 표시됩니다.

이벤트 타입

감사 로그에서 추적하는 이벤트 타입은 다음과 같습니다.

사용자 관리 이벤트

organization.invite.sent

조직 관리자가 새로운 사용자를 조직에 초대할 때 발생하는 이벤트입니다. 초대 이메일이 전송되면 자동으로 기록되며, 초대를 보낸 사용자와 초대받은 이메일 주소 정보가 포함됩니다.

organization.user.added

초대받은 사용자가 초대를 수락하여 조직에 성공적으로 가입했을 때 발생하는 이벤트입니다. 새로운 멤버가 조직에 추가되는 시점을 추적할 수 있습니다.

organization.user.removed

조직 관리자가 기존 사용자를 조직에서 제거할 때 발생하는 이벤트입니다. 제거를 실행한 관리자와 제거된 사용자의 정보가 모두 기록됩니다.

organization.user.role.changed

조직 내에서 사용자의 권한 역할이 변경될 때 발생하는 이벤트입니다. 이전 역할과 새로운 역할 정보가 함께 기록되어 권한 변경 이력을 추적할 수 있습니다.

auth.login.success

사용자가 시스템에 성공적으로 로그인했을 때 발생하는 이벤트입니다. 로그인 시간, IP 주소, 사용자 정보가 기록되어 접근 이력을 관리할 수 있습니다.

auth.logout

사용자가 시스템에서 로그아웃할 때 발생하는 이벤트입니다. 세션 종료 시점과 사용자 정보가 기록됩니다.

auth.password.changed

사용자가 비밀번호를 변경할 때 발생하는 보안 이벤트입니다. 계정 보안 강화를 위한 중요한 활동으로 기록됩니다.

조직 설정 이벤트

organization.name.changed

조직의 이름이 변경될 때 발생하는 이벤트입니다. 조직 설정에서 이름을 수정하면 이전 이름과 새로운 이름이 모두 기록되어 조직 정보 변경 이력을 추적할 수 있습니다.

organization.id.changed

조직의 고유 식별자(ID)가 변경될 때 발생하는 이벤트입니다. 조직 식별자 변경은 중요한 설정 변경으로 관리자 권한이 필요하며, 변경 전후의 ID 정보가 기록됩니다.

organization.owner.changed

조직의 소유권이 다른 사용자에게 이전될 때 발생하는 이벤트입니다. 이전 소유자와 새로운 소유자의 정보가 모두 기록되며, 조직의 최고 권한 변경을 추적합니다.

organization.user.add.failure

사용자를 조직에 추가하려는 시도가 실패했을 때 발생하는 이벤트입니다. 권한 부족, 중복 초대, 시스템 오류 등의 실패 원인과 함께 기록되어 문제 해결에 도움을 제공합니다.

MCP 연동 이벤트

mcp.integration.created

새로운 MCP(Model Context Protocol) 연동이 생성될 때 발생하는 이벤트입니다. 외부 서비스와의 새로운 연결 설정이 완료되면 기록되며, 연동 이름과 설정 정보가 포함됩니다.

mcp.integration.updated

기존 MCP 연동의 설정이 수정될 때 발생하는 이벤트입니다. 연결 정보, 인증 설정, 권한 변경 등 연동 관련 설정이 업데이트되면 변경 내용과 함께 기록됩니다.

mcp.integration.deleted

MCP 연동이 삭제될 때 발생하는 이벤트입니다. 외부 서비스와의 연결을 해제하거나 더 이상 사용하지 않는 연동을 제거할 때 기록되어 연동 관리 이력을 추적합니다.

mcp.preset.created

새로운 MCP 프리셋이 생성될 때 발생하는 이벤트입니다. 자주 사용하는 연동 설정을 템플릿으로 저장할 때 기록되며, 프리셋 이름과 포함된 설정 정보가 기록됩니다.

mcp.preset.updated

기존 MCP 프리셋이 수정될 때 발생하는 이벤트입니다. 프리셋에 포함된 설정이나 이름이 변경되면 수정 내용과 함께 기록되어 프리셋 관리 이력을 추적할 수 있습니다.

mcp.preset.deleted

MCP 프리셋이 삭제될 때 발생하는 이벤트입니다. 더 이상 사용하지 않는 프리셋을 제거할 때 기록되며, 삭제된 프리셋의 정보가 보존됩니다.

LLM 이벤트

llm.credit.limit.exceeded

조직의 LLM 사용 크레딧이 설정된 한도를 초과했을 때 발생하는 이벤트입니다. 과도한 사용을 방지하고 비용 관리를 위해 기록되며, 초과 시점과 사용량 정보가 포함됩니다.

llm.message.failure

LLM에 전송된 메시지 처리가 실패했을 때 발생하는 이벤트입니다. 네트워크 오류, API 한도 초과, 잘못된 요청 등의 실패 원인과 함께 기록되어 문제 진단에 도움을 제공합니다.

llm.message.received

LLM으로부터 응답 메시지를 성공적으로 수신했을 때 발생하는 이벤트입니다. 대화 흐름과 응답 시간을 추적할 수 있으며, 시스템 성능 모니터링에 활용됩니다.

llm.message.sent

사용자의 메시지가 LLM에 성공적으로 전송되었을 때 발생하는 이벤트입니다. 요청 시간과 메시지 정보가 기록되어 사용 패턴을 분석할 수 있습니다.

llm.tool.call.attempted

LLM이 특정 도구나 기능을 호출하려고 시도할 때 발생하는 이벤트입니다. MCP 연동이나 외부 API 호출 등의 도구 사용 시도가 기록되어 시스템 활동을 추적합니다.

llm.tool.call.failure

LLM의 도구 호출이 실패했을 때 발생하는 이벤트입니다. 연동 오류, 권한 부족, 타임아웃 등의 실패 원인과 함께 기록되어 문제 해결에 필요한 정보를 제공합니다.

llm.tool.call.success

LLM의 도구 호출이 성공적으로 완료되었을 때 발생하는 이벤트입니다. 호출된 도구와 실행 결과 정보가 기록되어 성공적인 연동 활동을 추적할 수 있습니다.

로그 포맷 예시

감사 로그는 JSON 형태로 저장되며, 다음과 같은 구조를 가집니다.

사용자 로그인 성공

{
  "auditId": "77f66585-229a-4ff9-86d4-0aa078d5bb29-f65d1255-54ac-481d-9de9-89f7013180a1",
  "time": 2025-07-25T08:08:25Z,
  "actor": {
    "name": "Keira Yoon",
    "ipAddress": "203.0.113.42",
    "role": "owner"
  },
  "event": {
    "eventType": "auth.login.success",
    "name": "Login Success",
    "description": "Keira Yoon succeed to login."
  }
}

사용자 역할 변경

{
  "auditId": "1a1ec237-b5a0-4f7c-b445-0bf2ecb6b270",
  "time": 2025-07-25T08:08:25Z,
  "actor": {
    "name": "Keira Yoon",
    "ipAddress": "203.0.113.42",
    "role": "owner"
  },
  "event": {
    "eventType": "organization.user.role.changed",
    "name": "Organization user's role changed",
    "description": "Keira Yoon changed QueryPie Shared's role from admin to member"
  }
}

MCP Integration 생성

{
  "auditId": "e8720ca3-08eb-45eb-8b74-129042c9e39c",
  "time": 2025-07-25T08:08:25Z,
  "actor": {
    "name": "Keira Yoon",
    "ipAddress": "203.0.113.42",
    "role": "owner"
  },
  "event": {
    "eventType": "mcp.integration.created",
    "name": "Integration created",
    "description": "Keira Yoon created integration Custom SSE"
  }
}