InfoGrab DocsInfoGrab Docs

AI 이벤트 감사

요약

이 기능은 베타입니다. AI 감사 이벤트 보고서는 GitLab Duo 에이전트 활동의 통합되고 탐색 가능한 기록을 제공합니다. AI 감사 이벤트는 AI Gateway에서 생성됩니다. GitLab은 MCP 클라이언트가 AI Gateway를 거치지 않고 GitLab MCP 서버에 직접 수행한 도구 호출을 기록합니다.

히스토리
  • GitLab 19.1에서 agent_artifacts_page라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.2에서 기본적으로 활성화되었습니다.
  • 탭별 권한이 GitLab 19.6에서 도입되었습니다.
  • 기능 플래그 agent_artifacts_page가 GitLab 19.6에서 제거되었습니다.
Warning

이 기능은 베타입니다. 사전 고지 없이 변경될 수 있습니다. 자세한 내용은 GitLab 테스트 계약을 참조합니다.

AI 감사 이벤트 보고서는 GitLab Duo 에이전트 활동의 통합되고 탐색 가능한 기록을 제공합니다. 각 에이전트 세션은 직접 확인할 수 있는 포괄적인 감사 아티팩트를 생성합니다.

AI 감사 이벤트는 AI Gateway에서 생성됩니다.

  • GitLab.com에서는 에이전트 세션이 GitLab 관리형 AI Gateway를 거치며, 이 AI Gateway가 AI 감사 이벤트를 GitLab.com으로 전달합니다.
  • GitLab Self-Managed에서는 에이전트 세션이 GitLab 관리형 AI Gateway 또는 자체 호스팅 AI Gateway를 거칠 수 있습니다. 자체 AI Gateway를 사용하는 경우 AI 감사 이벤트를 GitLab 인스턴스로 전달하도록 구성합니다. 그렇지 않으면 대시보드에 이벤트가 기록되지 않습니다. 이벤트를 전달하려면 AI Gateway에서 AIGW_AUDIT_EVENT__ENABLED 환경 변수를 true로 설정합니다.

GitLab은 MCP 클라이언트가 AI Gateway를 거치지 않고 GitLab MCP 서버에 직접 수행한 도구 호출을 기록합니다. 자세한 내용은 GitLab MCP 서버의 감사 이벤트를 참조합니다.

AI 감사 이벤트 보기#

AI 감사 이벤트는 Governance 페이지의 Audit events 탭에서 확인할 수 있습니다.

사전 요구 사항:

  • 최상위 그룹 또는 프로젝트에서 Owner 또는 Security Manager 권한이 있거나, read_agent_artifacts 권한이 있는 사용자 지정 역할이 있어야 합니다. 권한이 없으면 Audit events 탭에 이벤트 대신 메시지가 표시됩니다.

그룹의 AI 감사 이벤트를 보려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. Audit events 탭을 선택합니다.

이 탭에는 에이전트 세션 목록이 표시됩니다. 각 행에는 다음이 표시됩니다.

  • 에이전트 유형(워크플로 정의)
  • 세션이 실행된 프로젝트
  • 세션의 감사 이벤트 수
  • 세션 시작 시간

세션 필터링#

세션 목록을 필터링하여 결과를 좁힐 수 있습니다.

  • Project: 프로젝트 경로로 필터링하거나 특정 프로젝트를 제외합니다.
  • Date range: 특정 날짜 이후 또는 이전에 생성된 세션을 필터링합니다.
  • Triggered by: 세션을 트리거한 사용자로 필터링하거나 특정 사용자를 제외합니다.
  • Flow type: 플로 유형으로 필터링하거나 특정 플로 유형을 제외합니다.

세션 세부 정보 보기#

세션 안의 이벤트를 확인하려면 다음을 수행합니다.

  1. 세션 행을 선택하여 세션 세부 정보 패널을 엽니다. 이 패널에는 세션 메타데이터와 시간순 감사 이벤트 목록이 표시됩니다.
  2. 개별 이벤트를 선택하면 엔터티 및 대상 정보를 포함한 전체 세부 정보를 볼 수 있습니다.

비즈니스 로직 스캔 같은 일부 플로는 세션에 대한 메타데이터만 보관합니다. 이런 플로에서는 감사 이벤트가 상태, 타이밍, 모델, 도구 이름 같은 메타데이터만 기록하며, 프롬프트, 응답, 도구 콘텐츠는 기록하지 않습니다.

AI 감사 이벤트 저장 활성화#

히스토리
  • GitLab 19.2에서 도입되었습니다.
  • audit_json.log에 AI 감사 이벤트를 기록하는 동작이 이 설정을 따르도록 GitLab 19.6에서 변경되었습니다.

AI 감사 이벤트 저장은 기본적으로 비활성화되어 있습니다. 에이전트 세션 데이터가 데이터베이스나 ClickHouse 또는 audit_json.log 파일에 기록되기 전에 저장을 명시적으로 활성화해야 합니다. 저장을 비활성화해도 AI 감사 이벤트의 실시간 스트리밍에는 영향을 주지 않습니다.

이 설정은 인스턴스에서 그룹, 프로젝트로 계단식으로 적용됩니다.

  • 그룹 수준에서 비활성화되고 잠기면, 해당 그룹의 프로젝트는 이를 재정의할 수 없습니다.
  • 그룹 수준에서 활성화되고 잠기면, 해당 그룹의 모든 프로젝트에서 저장이 활성화되며 비활성화할 수 없습니다.

사전 요구 사항:

  • 그룹 또는 프로젝트에서 Owner 권한 또는 Security Manager 권한이 있어야 합니다.

그룹의 저장 활성화#

  1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Data and privacy 섹션에서 Store AI audit events를 선택합니다.
  5. Save changes를 선택합니다.
  1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab Duo 섹션을 확장합니다.
  4. Data and privacy 섹션에서 Store AI audit events를 선택합니다.
  5. Save changes를 선택합니다.

프로젝트의 저장 활성화#

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. Settings > General을 선택합니다.
  3. GitLab Duo 섹션을 확장합니다.
  4. Store AI audit events 토글을 켭니다.
  5. Save changes를 선택합니다.

상위 그룹에서 설정이 잠겨 있으면 컨트롤이 비활성화되며 프로젝트 수준에서 변경할 수 없습니다.

GitLab MCP 서버의 감사 이벤트#

히스토리
Feature flag

이 기능의 가용성은 기능 플래그에 의해 제어됩니다. 자세한 내용은 기록을 참조합니다.

GitLab은 MCP 클라이언트가 GitLab MCP 서버에 수행하는 도구 호출마다 AI 감사 이벤트를 기록합니다. 이 이벤트를 사용하여 Claude Code, Cursor, Codex 같은 외부 에이전트가 GitLab에서 수행하는 작업을 확인할 수 있습니다. 서버가 이벤트를 기록하므로 클라이언트에 추적 기능을 추가할 필요가 없습니다.

사전 요구 사항:

  • Audit events 탭에 이벤트가 표시되려면, 이벤트를 받는 그룹 또는 프로젝트에서 AI 감사 이벤트 저장을 켜야 합니다.

기록되는 이벤트#

이벤트 기록 시점
ai_agent_session_started 클라이언트가 새 세션에서 첫 번째 호출을 수행할 때입니다.
ai_tool_invoked 클라이언트가 도구를 호출할 때이며, 실패한 호출이나 도구 거버넌스 규칙이 차단한 호출도 포함합니다.
ai_tool_execution_failed 도구 호출이 실패할 때이며, Always Deny가 차단한 호출도 포함합니다. 실패한 호출은 이 이벤트와 ai_tool_invoked를 함께 기록합니다.
ai_agent_session_ended 세션이 종료될 때입니다.

호출을 세션으로 묶는 방식#

MCP 프로토콜에는 세션 식별자가 없으므로 GitLab이 세션을 추론합니다. 같은 사용자가 같은 OAuth 애플리케이션을 통해 같은 프로젝트 또는 그룹을 대상으로 하는 호출은 같은 세션에 속합니다.

세션은 다음과 같습니다.

  • 호출 없이 15분이 지나면 종료됩니다.
  • 최대 30분 동안 지속됩니다. 클라이언트가 계속 호출하면 GitLab이 새 세션을 시작합니다.

5분마다 실행되는 예약된 잡이 종료된 세션을 닫습니다. GitLab은 잡이 실행된 시간이 아니라 세션이 만료된 시간을 종료 시간으로 기록합니다.

GitLab이 세션을 추론하므로, 하나의 세션이 클라이언트의 하나의 대화와 일치하지 않을 수 있습니다.

이벤트를 받는 그룹#

GitLab은 도구 호출이 인수(예: project_id)에 지정한 프로젝트 또는 그룹에 대해 각 이벤트를 기록합니다. 이 선택에 따라 어느 그룹의 AI 감사 이벤트와 이벤트 스트림이 해당 이벤트를 받는지 결정됩니다.

  • 사용자가 해당 프로젝트 또는 그룹에서 Guest, Planner, Reporter, Security Manager, Developer, Maintainer, Owner 권한을 가지고 있으면 GitLab은 그곳에 이벤트를 기록합니다. 인스턴스 관리자와 조직 소유자는 멤버로 간주됩니다.
  • 그렇지 않으면 GitLab은 사용자의 기본 GitLab Duo 네임스페이스에, 기본값이 없으면 개인 네임스페이스에 이벤트를 기록합니다. 이는 프로젝트나 그룹을 지정하지 않는 호출에도 적용됩니다. 호출 대상이 된 프로젝트 또는 그룹의 소유자는 이 이벤트를 볼 수 없습니다.

이벤트 세부 정보#

별도로 명시하지 않는 한 각 이벤트의 details 객체에는 다음 필드가 있습니다. 세션 이벤트에는 도구, 결과, 오류, 인수 필드가 포함되지 않습니다. ai_agent_session_ended 이벤트에는 OAuth 애플리케이션, via, token_id 필드도 없습니다. 예약된 잡이 클라이언트 요청과 무관하게 이 이벤트를 기록하기 때문입니다.

필드 설명
mcp_server 항상 core이며, GitLab MCP 서버를 식별합니다.
agent_initiated 항상 true입니다.
agent_name OAuth 애플리케이션 이름을 기준으로 한 에이전트이며 claude-code, opencode, cursor, codex, unknown 중 하나입니다. 개인 액세스 토큰으로 인증한 호출처럼 OAuth 애플리케이션을 사용하지 않는 호출은 unknown입니다. GitLab은 클라이언트가 선언한 애플리케이션 이름을 검증하지 않으므로, 이 필드는 인가가 아니라 출처 표시 용도로만 사용합니다.
oauth_application_id 및 oauth_application_name 클라이언트가 사용한 OAuth 애플리케이션이며, 이름은 저장된 그대로입니다. 개인 액세스 토큰으로 인증한 호출에서는 생략됩니다.
tool_name 클라이언트가 호출한 도구입니다.
dispatched_tool_name 호출된 도구가 호출을 전달한 도구입니다. 예를 들어 save_merge_request는 update_merge_request로 전달할 수 있습니다. 도구가 전달하지 않으면 생략됩니다.
outcome success 또는 error입니다.
failure_reason 호출이 실패한 이유입니다. 예를 들어 도구 거버넌스 규칙이 차단한 호출은 unauthorized입니다. 성공한 호출에서는 생략됩니다.
duration_s 호출에 걸린 시간(초)입니다.
error_class 및 error_message 실패한 호출의 오류입니다. GitLab은 메시지를 255자로 자릅니다.
arguments 클라이언트가 보낸 인수입니다. GitLab은 토큰 같은 민감한 값을 [FILTERED]로 대체합니다. 인수가 10KB보다 크면 GitLab은 인수가 생략되었다는 안내로 대체합니다.
via 및 token_id 호출이 GitLab Duo Agent Platform에 발급된 토큰을 사용했으면 via는 duo_agent_platform이고, token_id는 해당 토큰의 ID입니다. 이런 호출은 GitLab Duo Agent Platform의 이벤트에도 나타날 수 있으므로, 이 필드로 둘을 대응시킬 수 있습니다.

MCP 서버 세션 보기#

사전 요구 사항:

  • 최상위 그룹에서 Owner 권한이 있어야 합니다.

MCP 서버 세션을 보려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. Audit events 탭을 선택합니다.
  4. 세션을 선택하여 세션 세부 정보 패널을 엽니다.

MCP 서버 세션은 다른 에이전트의 세션과 함께 표시됩니다. AI Item 열과 세션 세부 정보 패널에서 GitLab은 에이전트를 인식하면 클라이언트의 이름을 표시합니다. 인식하지 못하면 GitLab MCP server를 표시합니다.

복합 ID를 사용한 이벤트 귀속#

히스토리
  • GitLab 19.3에서 도입되었습니다.

에이전트 세션이 에이전트 세션의 기본 ID인 복합 ID로 실행되면, 세션의 AI 감사 이벤트는 서비스 계정에 귀속됩니다. author_id 필드에는 서비스 계정의 사용자 ID가 들어 있으며, 서비스 계정이 이벤트 작성자로 표시됩니다.

이벤트 details 필드에는 세션을 시작한 사용자가 기록됩니다.

필드 설명
human_author_id 사용자의 ID
human_author_name 사용자의 이름
human_author_username 사용자의 사용자 이름

세션이 사용자 본인의 토큰으로 인증되면 해당 사용자가 이벤트 작성자가 되며 human_author_* 필드는 추가되지 않습니다.

관련 항목#

AI 이벤트 감사

GitLab v19.6
Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

이 기능은 베타입니다. AI 감사 이벤트 보고서는 GitLab Duo 에이전트 활동의 통합되고 탐색 가능한 기록을 제공합니다. AI 감사 이벤트는 AI Gateway에서 생성됩니다. GitLab은 MCP 클라이언트가 AI Gateway를 거치지 않고 GitLab MCP 서버에 직접 수행한 도구 호출을 기록합니다.

히스토리
  • GitLab 19.1에서 agent_artifacts_page라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.2에서 기본적으로 활성화되었습니다.
  • 탭별 권한이 GitLab 19.6에서 도입되었습니다.
  • 기능 플래그 agent_artifacts_page가 GitLab 19.6에서 제거되었습니다.
Warning

이 기능은 베타입니다. 사전 고지 없이 변경될 수 있습니다. 자세한 내용은 GitLab 테스트 계약을 참조합니다.

AI 감사 이벤트 보고서는 GitLab Duo 에이전트 활동의 통합되고 탐색 가능한 기록을 제공합니다. 각 에이전트 세션은 직접 확인할 수 있는 포괄적인 감사 아티팩트를 생성합니다.

AI 감사 이벤트는 AI Gateway에서 생성됩니다.

  • GitLab.com에서는 에이전트 세션이 GitLab 관리형 AI Gateway를 거치며, 이 AI Gateway가 AI 감사 이벤트를 GitLab.com으로 전달합니다.
  • GitLab Self-Managed에서는 에이전트 세션이 GitLab 관리형 AI Gateway 또는 자체 호스팅 AI Gateway를 거칠 수 있습니다. 자체 AI Gateway를 사용하는 경우 AI 감사 이벤트를 GitLab 인스턴스로 전달하도록 구성합니다. 그렇지 않으면 대시보드에 이벤트가 기록되지 않습니다. 이벤트를 전달하려면 AI Gateway에서 AIGW_AUDIT_EVENT__ENABLED 환경 변수를 true로 설정합니다.

GitLab은 MCP 클라이언트가 AI Gateway를 거치지 않고 GitLab MCP 서버에 직접 수행한 도구 호출을 기록합니다. 자세한 내용은 GitLab MCP 서버의 감사 이벤트를 참조합니다.

AI 감사 이벤트 보기#

AI 감사 이벤트는 Governance 페이지의 Audit events 탭에서 확인할 수 있습니다.

사전 요구 사항:

  • 최상위 그룹 또는 프로젝트에서 Owner 또는 Security Manager 권한이 있거나, read_agent_artifacts 권한이 있는 사용자 지정 역할이 있어야 합니다. 권한이 없으면 Audit events 탭에 이벤트 대신 메시지가 표시됩니다.

그룹의 AI 감사 이벤트를 보려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. Audit events 탭을 선택합니다.

이 탭에는 에이전트 세션 목록이 표시됩니다. 각 행에는 다음이 표시됩니다.

  • 에이전트 유형(워크플로 정의)
  • 세션이 실행된 프로젝트
  • 세션의 감사 이벤트 수
  • 세션 시작 시간

세션 필터링#

세션 목록을 필터링하여 결과를 좁힐 수 있습니다.

  • Project: 프로젝트 경로로 필터링하거나 특정 프로젝트를 제외합니다.
  • Date range: 특정 날짜 이후 또는 이전에 생성된 세션을 필터링합니다.
  • Triggered by: 세션을 트리거한 사용자로 필터링하거나 특정 사용자를 제외합니다.
  • Flow type: 플로 유형으로 필터링하거나 특정 플로 유형을 제외합니다.

세션 세부 정보 보기#

세션 안의 이벤트를 확인하려면 다음을 수행합니다.

  1. 세션 행을 선택하여 세션 세부 정보 패널을 엽니다. 이 패널에는 세션 메타데이터와 시간순 감사 이벤트 목록이 표시됩니다.
  2. 개별 이벤트를 선택하면 엔터티 및 대상 정보를 포함한 전체 세부 정보를 볼 수 있습니다.

비즈니스 로직 스캔 같은 일부 플로는 세션에 대한 메타데이터만 보관합니다. 이런 플로에서는 감사 이벤트가 상태, 타이밍, 모델, 도구 이름 같은 메타데이터만 기록하며, 프롬프트, 응답, 도구 콘텐츠는 기록하지 않습니다.

AI 감사 이벤트 저장 활성화#

히스토리
  • GitLab 19.2에서 도입되었습니다.
  • audit_json.log에 AI 감사 이벤트를 기록하는 동작이 이 설정을 따르도록 GitLab 19.6에서 변경되었습니다.

AI 감사 이벤트 저장은 기본적으로 비활성화되어 있습니다. 에이전트 세션 데이터가 데이터베이스나 ClickHouse 또는 audit_json.log 파일에 기록되기 전에 저장을 명시적으로 활성화해야 합니다. 저장을 비활성화해도 AI 감사 이벤트의 실시간 스트리밍에는 영향을 주지 않습니다.

이 설정은 인스턴스에서 그룹, 프로젝트로 계단식으로 적용됩니다.

  • 그룹 수준에서 비활성화되고 잠기면, 해당 그룹의 프로젝트는 이를 재정의할 수 없습니다.
  • 그룹 수준에서 활성화되고 잠기면, 해당 그룹의 모든 프로젝트에서 저장이 활성화되며 비활성화할 수 없습니다.

사전 요구 사항:

  • 그룹 또는 프로젝트에서 Owner 권한 또는 Security Manager 권한이 있어야 합니다.

그룹의 저장 활성화#

  1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Data and privacy 섹션에서 Store AI audit events를 선택합니다.
  5. Save changes를 선택합니다.
  1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab Duo 섹션을 확장합니다.
  4. Data and privacy 섹션에서 Store AI audit events를 선택합니다.
  5. Save changes를 선택합니다.

프로젝트의 저장 활성화#

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. Settings > General을 선택합니다.
  3. GitLab Duo 섹션을 확장합니다.
  4. Store AI audit events 토글을 켭니다.
  5. Save changes를 선택합니다.

상위 그룹에서 설정이 잠겨 있으면 컨트롤이 비활성화되며 프로젝트 수준에서 변경할 수 없습니다.

GitLab MCP 서버의 감사 이벤트#

히스토리
Feature flag

이 기능의 가용성은 기능 플래그에 의해 제어됩니다. 자세한 내용은 기록을 참조합니다.

GitLab은 MCP 클라이언트가 GitLab MCP 서버에 수행하는 도구 호출마다 AI 감사 이벤트를 기록합니다. 이 이벤트를 사용하여 Claude Code, Cursor, Codex 같은 외부 에이전트가 GitLab에서 수행하는 작업을 확인할 수 있습니다. 서버가 이벤트를 기록하므로 클라이언트에 추적 기능을 추가할 필요가 없습니다.

사전 요구 사항:

  • Audit events 탭에 이벤트가 표시되려면, 이벤트를 받는 그룹 또는 프로젝트에서 AI 감사 이벤트 저장을 켜야 합니다.

기록되는 이벤트#

이벤트 기록 시점
ai_agent_session_started 클라이언트가 새 세션에서 첫 번째 호출을 수행할 때입니다.
ai_tool_invoked 클라이언트가 도구를 호출할 때이며, 실패한 호출이나 도구 거버넌스 규칙이 차단한 호출도 포함합니다.
ai_tool_execution_failed 도구 호출이 실패할 때이며, Always Deny가 차단한 호출도 포함합니다. 실패한 호출은 이 이벤트와 ai_tool_invoked를 함께 기록합니다.
ai_agent_session_ended 세션이 종료될 때입니다.

호출을 세션으로 묶는 방식#

MCP 프로토콜에는 세션 식별자가 없으므로 GitLab이 세션을 추론합니다. 같은 사용자가 같은 OAuth 애플리케이션을 통해 같은 프로젝트 또는 그룹을 대상으로 하는 호출은 같은 세션에 속합니다.

세션은 다음과 같습니다.

  • 호출 없이 15분이 지나면 종료됩니다.
  • 최대 30분 동안 지속됩니다. 클라이언트가 계속 호출하면 GitLab이 새 세션을 시작합니다.

5분마다 실행되는 예약된 잡이 종료된 세션을 닫습니다. GitLab은 잡이 실행된 시간이 아니라 세션이 만료된 시간을 종료 시간으로 기록합니다.

GitLab이 세션을 추론하므로, 하나의 세션이 클라이언트의 하나의 대화와 일치하지 않을 수 있습니다.

이벤트를 받는 그룹#

GitLab은 도구 호출이 인수(예: project_id)에 지정한 프로젝트 또는 그룹에 대해 각 이벤트를 기록합니다. 이 선택에 따라 어느 그룹의 AI 감사 이벤트와 이벤트 스트림이 해당 이벤트를 받는지 결정됩니다.

  • 사용자가 해당 프로젝트 또는 그룹에서 Guest, Planner, Reporter, Security Manager, Developer, Maintainer, Owner 권한을 가지고 있으면 GitLab은 그곳에 이벤트를 기록합니다. 인스턴스 관리자와 조직 소유자는 멤버로 간주됩니다.
  • 그렇지 않으면 GitLab은 사용자의 기본 GitLab Duo 네임스페이스에, 기본값이 없으면 개인 네임스페이스에 이벤트를 기록합니다. 이는 프로젝트나 그룹을 지정하지 않는 호출에도 적용됩니다. 호출 대상이 된 프로젝트 또는 그룹의 소유자는 이 이벤트를 볼 수 없습니다.

이벤트 세부 정보#

별도로 명시하지 않는 한 각 이벤트의 details 객체에는 다음 필드가 있습니다. 세션 이벤트에는 도구, 결과, 오류, 인수 필드가 포함되지 않습니다. ai_agent_session_ended 이벤트에는 OAuth 애플리케이션, via, token_id 필드도 없습니다. 예약된 잡이 클라이언트 요청과 무관하게 이 이벤트를 기록하기 때문입니다.

필드 설명
mcp_server 항상 core이며, GitLab MCP 서버를 식별합니다.
agent_initiated 항상 true입니다.
agent_name OAuth 애플리케이션 이름을 기준으로 한 에이전트이며 claude-code, opencode, cursor, codex, unknown 중 하나입니다. 개인 액세스 토큰으로 인증한 호출처럼 OAuth 애플리케이션을 사용하지 않는 호출은 unknown입니다. GitLab은 클라이언트가 선언한 애플리케이션 이름을 검증하지 않으므로, 이 필드는 인가가 아니라 출처 표시 용도로만 사용합니다.
oauth_application_id 및 oauth_application_name 클라이언트가 사용한 OAuth 애플리케이션이며, 이름은 저장된 그대로입니다. 개인 액세스 토큰으로 인증한 호출에서는 생략됩니다.
tool_name 클라이언트가 호출한 도구입니다.
dispatched_tool_name 호출된 도구가 호출을 전달한 도구입니다. 예를 들어 save_merge_request는 update_merge_request로 전달할 수 있습니다. 도구가 전달하지 않으면 생략됩니다.
outcome success 또는 error입니다.
failure_reason 호출이 실패한 이유입니다. 예를 들어 도구 거버넌스 규칙이 차단한 호출은 unauthorized입니다. 성공한 호출에서는 생략됩니다.
duration_s 호출에 걸린 시간(초)입니다.
error_class 및 error_message 실패한 호출의 오류입니다. GitLab은 메시지를 255자로 자릅니다.
arguments 클라이언트가 보낸 인수입니다. GitLab은 토큰 같은 민감한 값을 [FILTERED]로 대체합니다. 인수가 10KB보다 크면 GitLab은 인수가 생략되었다는 안내로 대체합니다.
via 및 token_id 호출이 GitLab Duo Agent Platform에 발급된 토큰을 사용했으면 via는 duo_agent_platform이고, token_id는 해당 토큰의 ID입니다. 이런 호출은 GitLab Duo Agent Platform의 이벤트에도 나타날 수 있으므로, 이 필드로 둘을 대응시킬 수 있습니다.

MCP 서버 세션 보기#

사전 요구 사항:

  • 최상위 그룹에서 Owner 권한이 있어야 합니다.

MCP 서버 세션을 보려면 다음을 수행합니다.

  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. Audit events 탭을 선택합니다.
  4. 세션을 선택하여 세션 세부 정보 패널을 엽니다.

MCP 서버 세션은 다른 에이전트의 세션과 함께 표시됩니다. AI Item 열과 세션 세부 정보 패널에서 GitLab은 에이전트를 인식하면 클라이언트의 이름을 표시합니다. 인식하지 못하면 GitLab MCP server를 표시합니다.

복합 ID를 사용한 이벤트 귀속#

히스토리
  • GitLab 19.3에서 도입되었습니다.

에이전트 세션이 에이전트 세션의 기본 ID인 복합 ID로 실행되면, 세션의 AI 감사 이벤트는 서비스 계정에 귀속됩니다. author_id 필드에는 서비스 계정의 사용자 ID가 들어 있으며, 서비스 계정이 이벤트 작성자로 표시됩니다.

이벤트 details 필드에는 세션을 시작한 사용자가 기록됩니다.

필드 설명
human_author_id 사용자의 ID
human_author_name 사용자의 이름
human_author_username 사용자의 사용자 이름

세션이 사용자 본인의 토큰으로 인증되면 해당 사용자가 이벤트 작성자가 되며 human_author_* 필드는 추가되지 않습니다.

관련 항목#