InfoGrab DocsInfoGrab Docs

외부 연결 에이전트(ECA)를 AI Governance 대시보드에 연결

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. Claude Code, OpenCode, Cursor, Codex 같은 코딩 에이전트가 개발자의 컴퓨터에서 실행되면, AI Governance 대시보드는 GitLab CLI(glab)를 통해 이들을 외부 연결 에이전트(Externally Connected Agen...

히스토리
  • 코딩 에이전트의 세션 캡처가 GitLab 19.3에서 ai_agent_session_tracking이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • Cursor 및 Codex 세션이 GitLab 19.5에서 도입되었습니다.
  • GitLab 19.5에서 기본적으로 활성화되었습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

Claude Code, OpenCode, Cursor, Codex 같은 코딩 에이전트가 개발자의 컴퓨터에서 실행되면, AI Governance 대시보드는 GitLab CLI(glab)를 통해 이들을 외부 연결 에이전트(Externally Connected Agents, ECA)로 표시할 수 있습니다.

GitLab CLI(glab)는 각 에이전트의 로컬 트랜스크립트를 읽고, 세션과 그 이벤트를 에이전트가 작업한 GitLab 프로젝트로 전송합니다. 이후 세션은 다음 위치에 표시됩니다.

Warning

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

glab은 에이전트가 실행된 폴더의 Git 리모트에서 프로젝트를 찾습니다.

  • Claude Code와 OpenCode에서는 glab이 다른 명령과 같은 방식으로 리모트를 선택합니다. 즉, glab repo set-default로 설정한 리모트를 사용하고, 없으면 upstream, gitlab, origin 순서로 사용합니다. 포크 체크아웃에서는 Claude Code와 OpenCode 세션이 업스트림 프로젝트로 전송됩니다.
  • Codex에서는 glab이 Codex가 기록한 리포지터리 URL을 사용하고, 없으면 origin을 사용합니다.
  • Cursor에서는 glab이 origin을 사용합니다.

리모트는 glab이 로그인되어 있는 GitLab 인스턴스를 가리켜야 합니다. 이러한 리모트가 없는 폴더의 세션은 전송되지 않습니다.

사전 요구 사항#

  • 최상위 그룹에 GitLab Duo Agent Platform이 포함된 GitLab Premium 또는 Ultimate.
  • GitLab 인스턴스에 로그인된 glab. 필요한 버전은 에이전트와 명령 이름에 따라 다릅니다.
    • Claude Code, Cursor, Codex는 1.122.0 이상.
    • OpenCode는 1.125.0 이상이며, OpenCode 1.4 이상이 필요합니다.
    • glab govern을 대체한 glab minder 명령은 1.129.0 이상.
  • 프로젝트에 대한 Developer 이상의 권한.
  • 최상위 그룹에서 Allow external agents가 켜져 있어야 합니다. 기본적으로 켜져 있습니다. 이 설정은 CI/CD 파이프라인에서 실행되는 AI 카탈로그 외부 에이전트에 속하며, 세션 캡처도 제어합니다. 이 설정을 끄면 로컬 코딩 에이전트의 세션도 중단됩니다.
  • 그룹에 AI Governance가 켜져 있어야 합니다. 기본적으로 꺼져 있습니다. 이 사전 요구 사항은 ai_governance_session_gate 기능 플래그가 활성화된 경우에만 적용되며, 이 플래그는 기본적으로 활성화되어 있지 않습니다.
  • GitLab.com에서는 그룹에 속한 프로젝트여야 합니다. 개인 네임스페이스의 프로젝트에 대한 세션은 기록되지 않습니다.
  • 그룹 또는 프로젝트에 Store AI audit events가 켜져 있어야 합니다. 이 설정이 없으면 세션만 기록되고 이벤트와 도구 호출은 기록되지 않습니다. 이 설정은 기본적으로 꺼져 있습니다. 변경하려면 Owner 또는 Security Manager 권한이 필요합니다.
  • macOS 또는 Linux를 실행하는 컴퓨터.

AI Governance 켜기#

히스토리
  • ai_governance_enabled 요구 사항이 GitLab 19.6에서 ai_governance_session_gate라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 사전 요구 사항의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 플래그가 비활성화되어 있으면 GitLab은 최상위 그룹의 Allow external agents만 확인하며, 세션을 캡처하기 위해 AI Governance를 켤 필요는 없습니다.

AI Governance는 기본적으로 꺼져 있습니다. ai_governance_session_gate 기능 플래그가 활성화되어 있으면 AI Governance를 켤 때까지 GitLab이 glab이 보내는 세션을 거부합니다.

그룹에 대해 켭니다. 이 설정은 모든 하위 그룹과 프로젝트에 백그라운드에서 적용되며, 몇 분이 걸릴 수 있습니다. GitLab.com에서는 개인 네임스페이스의 프로젝트가 지원되지 않습니다.

사전 요구 사항:

  • 그룹에 대한 Owner 권한.

그룹 API를 사용해 ai_governance_enabled를 true로 설정합니다.

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "ai_governance_enabled=true" \
  --url "https://gitlab.example.com/api/v4/groups/<group_id>"

하위 그룹 Owner가 이 설정을 끄지 못하게 하려면 lock_ai_governance_enabled도 true로 설정합니다.

세션 캡처 설정#

에이전트를 실행하는 컴퓨터마다 사용자 계정별로 한 번씩 세션 캡처를 설정합니다. 이 절의 명령은 glab minder 참조에 문서화되어 있습니다.

--agents로 캡처할 에이전트를 선택합니다. 이 옵션이 없으면 glab minder setup은 이전 실행에서 설정한 에이전트를 설정하고, 없으면 Claude Code를 설정합니다. glab이 확인을 요청합니다. 스크립트에서 glab을 호출한다면 --yes를 전달합니다.

실행할 때마다 이전 실행에서 설정한 에이전트에 추가됩니다. 예를 들어 Cursor와 Codex 세션을 캡처하는 중이라면 glab minder setup --agents opencode를 실행합니다. OpenCode가 이들에 추가됩니다. 에이전트 캡처를 중단하려면 glab minder setup --uninstall을 실행한 다음, 원하는 에이전트를 다시 설정합니다.

Claude Code 세션 캡처#

Claude Code 세션은 훅을 통해 캡처되며, 훅에서 glab이 로그인할 수 있으면 훅이 응답마다 세션을 전송합니다. 훅이 놓친 항목은 백그라운드 작업이 전송합니다.

Claude Code 세션을 캡처하려면 다음을 실행합니다.

glab minder setup --agents claude-code

이 명령은 다음을 설치합니다.

  • ~/.claude/settings.json의 Stop 훅과 SessionEnd 훅. 훅은 응답할 때마다 세션을 전송하고, 세션이 끝나면 완료로 표시합니다.
  • 30분마다 실행되는 백그라운드 작업. 이 작업은 훅이 놓친 항목을 전송하고, 24시간 동안 활동이 없는 세션을 완료로 표시합니다. macOS에서는 이 작업이 launchd 에이전트이고, Linux에서는 systemd 사용자 타이머입니다.

명령을 실행하기 전에 종료된 세션은 전송되지 않습니다.

OpenCode 세션 캡처#

OpenCode 세션은 플러그인을 통해 캡처되며, 플러그인은 OpenCode가 응답을 마칠 때마다 세션을 전송합니다. 플러그인이 놓친 항목은 백그라운드 작업이 전송합니다.

OpenCode 세션을 캡처하려면 다음을 실행합니다.

glab minder setup --agents opencode

이 명령은 다음을 설치합니다.

  • 백그라운드 작업.
  • ~/.config/opencode/plugins/glab-govern.js 또는 (XDG_CONFIG_HOME이 설정된 경우) $XDG_CONFIG_HOME/opencode/plugins/glab-govern.js의 플러그인. glab이 설치하지 않은 파일이 이미 그 경로에 있으면 명령이 아무것도 변경하지 않고 중단됩니다. 해당 파일을 제거하거나 이름을 바꾼 다음 명령을 다시 실행합니다.

OpenCode는 모든 프로젝트의 모든 세션에 대해 플러그인을 로드합니다. 플러그인을 최신 상태로 유지하려면 glab minder setup을 다시 실행합니다.

명령을 실행하기 전에 종료된 세션은 전송되지 않습니다. OpenCode 세션은 24시간 동안 활동이 없으면 완료로 표시됩니다.

Cursor 및 Codex 세션 캡처#

glab은 Cursor와 Codex용 훅을 설치하지 않습니다. 백그라운드 작업이 30분마다 ~/.cursor/projects와 ~/.codex/sessions를 스캔해 이들의 세션을 찾습니다.

Cursor와 Codex 세션을 캡처하려면 다음을 실행합니다.

glab minder setup --agents codex,cursor

이 작업은 명령을 실행하기 전의 세션도 전송합니다. 단, 최근 89일 이내에 활동이 있었고 glab이 로그인된 GitLab 인스턴스의 프로젝트에 속한 세션이어야 합니다. 세션은 24시간 동안 활동이 없으면 완료로 표시됩니다. 사용자 지정 CODEX_HOME 폴더에 저장된 Codex 세션은 찾지 못합니다.

Cursor와 Codex 세션 캡처를 중단하려면 glab minder setup --uninstall을 실행한 다음, 원하는 에이전트를 다시 설정합니다.

설정 확인#

세션 캡처가 올바르게 구성되었는지 확인하려면 다음을 실행합니다.

glab minder doctor

이 명령은 다음을 수행합니다.

  • glab이 기본 GitLab 호스트에 로그인되어 있고 PATH에 있는지 확인합니다.
  • Claude Code 훅이 ~/.claude/settings.json에 있는지, GitLab API에 접근할 수 있는지 확인합니다.
  • OpenCode 플러그인이 설치되어 있고 최신 상태인지 확인합니다.
  • 백그라운드 작업이 설치되어 있는지, 마지막 실행 결과가 어땠는지 보고합니다.
  • 실패한 각 확인 항목에 대해 해결 방법을 설명합니다.

마지막 실행 줄에는 다음이 나열됩니다.

  • 세션 캡처가 활성화되지 않은 프로젝트.
  • GitLab이 거부한 에이전트 유형.
  • glab이 건너뛴 Cursor 세션.

이 명령은 전역 ~/.claude/settings.json만 읽습니다. 프로젝트의 .claude 폴더에 있는 훅은 누락된 것으로 보고되며, 전역 Stop 훅이 없는 동안에는 백그라운드 작업이 Claude Code 세션을 건너뜁니다.

백그라운드 작업을 기다리지 않고 지금 세션을 전송하려면 다음을 실행합니다.

glab minder audit sync --all

전송되는 데이터#

glab은 각 세션에 대해 다음을 전송합니다.

  • 입력한 프롬프트. 8KB를 넘는 프롬프트는 잘립니다. 첫 번째 프롬프트는 세션의 목표(goal)가 되기도 합니다.
  • 명령, 파일 경로, 편집 내용 같은 인수를 포함한 각 도구 호출. 8KB를 넘는 인수는 표식으로 대체됩니다.
  • 각 도구 호출의 결과, 소요 시간, 오류 메시지. 오류 메시지는 255자에서 잘립니다.
  • 각 응답의 모델과 토큰 사용량.
  • 세션이 완료되면 트랜스크립트 파일의 체크섬.

도구 출력과 응답 텍스트는 전송되지 않습니다. 단, 실패한 도구 호출의 출력 중 처음 255자는 오류 메시지로 전송됩니다. 컴퓨터를 식별하기 위해 glab은 해시된 머신 ID를 전송합니다.

에이전트마다 기록하는 세부 정보가 다릅니다.

에이전트 Claude Code와의 차이
OpenCode 프롬프트가 전송되지 않으며, 응답의 모델과 토큰 사용량도 전송되지 않습니다. 첫 번째 프롬프트는 여전히 세션의 목표가 됩니다. 도구 호출의 결과는 glab이 처음 전송했을 때 호출이 끝난 상태였던 경우에만 전송됩니다.
Codex Codex는 성공 여부를 기록하지 않으므로 모든 도구 호출의 결과가 오류 메시지 없이 완료로 기록됩니다.
Cursor Cursor는 결과, 토큰 사용량, 타임스탬프를 기록하지 않으므로 프롬프트와 도구 호출만 전송됩니다. 이벤트 시각은 트랜스크립트의 마지막 수정 시각으로 정해집니다.

ECA 세션 보기#

Show 컨트롤이 All agents(기본값) 또는 Connected로 설정되어 있으면 외부 연결 에이전트(ECA)의 세션이 AI Governance 대시보드에 표시됩니다.

  • Recent agent sessions 카드는 각 세션에 에이전트 이름을 붙입니다. 예를 들어 Cursor (glab) 또는 **Claude (glab)**입니다.
  • Most used agents 카드는 연결된 각 에이전트를 실행한 머신 수와 사용자 수와 함께 나열합니다. 예를 들어 2 machines · 2 users입니다.
  • KPI 타일과 다른 카드는 GitLab Duo Agent Platform 세션과 함께 세션과 도구 호출을 집계합니다.

세션과 그 이벤트는 AI 감사 이벤트 보고서에도 나열됩니다.

  • Claude Code 세션은 첫 번째 응답 직후에 표시되며, 에이전트를 종료하면 종료됨으로 표시됩니다. 종료 훅이 실행되지 않았다면 24시간 동안 활동이 없을 때 백그라운드 작업이 세션을 종료됨으로 표시합니다.
  • OpenCode 세션은 첫 번째 응답 직후에 표시되며, 24시간 동안 활동이 없으면 종료됨으로 표시됩니다.
  • Cursor 및 Codex 세션은 컴퓨터가 켜져 있고 로그인된 상태라면 보통 에이전트를 사용한 뒤 30분 이내에 표시됩니다. macOS에서는 백그라운드 작업의 첫 번째 실행이 설정 30분 후입니다. 이 세션은 24시간 동안 활동이 없으면 종료됨으로 표시됩니다.
  • 대시보드 수치는 약간의 지연 후 갱신됩니다.

연결된 에이전트 보기#

히스토리
  • GitLab 19.6에서 ai_governance_connected_agents_tab이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

Connected agents 탭에는 에이전트 연결이 하나씩 나열됩니다. 연결은 사용자가 한 컴퓨터에서 glab으로 프로젝트에 연결한 에이전트를 말합니다. 예를 들어 두 사용자가 같은 프로젝트에 Claude Code를 연결하면 행이 둘로 표시됩니다. 한 사용자가 두 컴퓨터에서 연결해도 마찬가지입니다.

사전 요구 사항:

  • 최상위 그룹에 대한 Owner 권한이 있거나, read_agent_artifacts 기능이 있는 사용자 지정 역할이 있어야 합니다.

연결된 에이전트를 보려면 다음을 수행합니다.

  1. 상단 바에서 Search or go to를 선택하고 최상위 그룹 또는 그 안의 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. Connected agents 탭을 선택합니다.

탭은 각 연결에 대해 다음을 표시합니다.

칼럼 설명
Agent 에이전트입니다. 예: Claude Code 또는 Cursor.
Connected by 에이전트를 연결한 사용자입니다.
Project 에이전트가 연결된 프로젝트입니다. 그룹에서만 표시됩니다.
First connected 사용자가 에이전트를 프로젝트에 처음 연결한 시각입니다.
Last active glab이 연결을 마지막으로 동기화한 시각이며, GitLab에 동기화 기록이 없으면 Never입니다.
Sessions 해당 연결에 대해 전송된 세션 수입니다. 1,000을 넘으면 **1,000+**로 표시됩니다.
Status 연결이 취소되었으면 Revoked입니다. 그렇지 않으면 최근 30일 이내에 glab이 연결을 동기화했거나 연결 생성 후 30일이 지나지 않았고 아직 동기화되지 않았으면 Active입니다. 그 밖의 모든 연결은 Inactive입니다.

연결은 Last active 기준으로 가장 최근 항목부터 나열됩니다. 일부 연결만 표시하려면 에이전트, 사용자, 상태로 필터링합니다.

세션 캡처 중단#

세션 캡처를 중단하려면 다음을 실행합니다.

glab minder setup --uninstall

이 명령은 백그라운드 작업과 OpenCode 플러그인을 제거하고 Cursor 및 Codex 세션 캡처를 중단합니다. glab 1.124.0 이상에서는 Claude Code 훅도 제거합니다. ~/.claude/settings.json의 다른 훅과 다른 OpenCode 플러그인은 변경되지 않습니다.

이전 버전의 glab에서는 Claude Code 훅이 그대로 남습니다. Claude Code 세션 캡처를 중단하려면 ~/.claude/settings.json의 hooks 섹션에서 glab govern audit sync 항목 두 개를 제거합니다. Stop 훅이 없으면 백그라운드 작업도 Claude Code 세션을 건너뜁니다.

이미 GitLab으로 전송된 세션은 대시보드에 남습니다.

문제 해결#

문제 원인 해결 방법
glab minder doctor가 실패한 확인 항목을 보고합니다. 이 컴퓨터의 설정이 완료되지 않았습니다. 확인 항목이 출력하는 해결 방법을 따릅니다.
glab minder doctor의 마지막 실행 줄에 프로젝트의 거버넌스가 활성화되지 않았다고 표시됩니다. 그룹 또는 프로젝트에 AI Governance가 켜져 있지 않거나, 프로젝트가 GitLab.com의 개인 네임스페이스에 있습니다. GitLab은 ai_governance_session_gate 기능 플래그가 활성화된 경우에만 이를 보고합니다. 그룹 Owner에게, GitLab Self-Managed와 GitLab Dedicated에서는 관리자에게 켜 달라고 요청합니다. GitLab.com의 개인 네임스페이스에 있는 프로젝트는 지원되지 않습니다.
glab minder audit sync --all이 403 Forbidden 경고를 출력하거나, glab minder doctor가 마지막 실행의 오류로 이를 표시합니다. 프로젝트에 대한 권한이 Developer 미만이거나, 그룹에 GitLab Duo Agent Platform이 없거나, 최상위 그룹에서 Allow external agents가 꺼져 있거나, 프로젝트가 GitLab.com의 개인 네임스페이스에 있습니다(둘 다 ai_governance_session_gate 기능 플래그가 비활성화된 경우). 또는 그룹 Owner가 이 컴퓨터의 에이전트 ID를 취소했습니다. 포크 체크아웃의 Claude Code와 OpenCode에서는 세션이 업스트림 프로젝트로 전송되었습니다. 그룹 Owner에게, GitLab Self-Managed와 GitLab Dedicated에서는 관리자에게 권한과 설정을 확인합니다. 포크 체크아웃에서는 glab repo set-default를 실행하고 세션을 전송할 프로젝트를 선택합니다.
세션은 표시되지만 이벤트나 도구 호출이 없습니다. 그룹 또는 프로젝트에서 Store AI audit events가 꺼져 있습니다. 이 설정을 켭니다. Owner 또는 Security Manager 권한이 필요합니다. 변경 전의 이벤트는 기록되지 않습니다.
세션이 전송되었지만 대시보드에 없습니다. 대시보드가 백그라운드에서 처리되는 데이터를 읽고 있거나, 필터가 세션을 제외합니다. Show를 All agents 또는 Connected로 설정하고 날짜 범위를 확인한 다음, 몇 분 기다렸다가 페이지를 새로 고칩니다.
에이전트가 프로젝트를 만든 뒤처럼, 세션이 전혀 전송되지 않습니다. 에이전트가 실행된 폴더(예: 홈 폴더)에 glab이 로그인된 GitLab 인스턴스를 가리키는 리모트가 없습니다. glab은 에이전트가 만들거나 포크하거나 클론한 프로젝트가 아니라 해당 폴더의 프로젝트로 세션을 전송합니다. 세션이 속해야 하는 GitLab 프로젝트의 클론에서 에이전트를 시작합니다.
Cursor 세션이 전혀 전송되지 않습니다. glab이 세션이 실행된 폴더를 확인하지 못했습니다. 폴더를 옮겼거나, 다른 폴더의 경로가 문장부호만 다른 경우(예: code/cli-docs와 code/cli/docs), 또는 세션이 건드린 모든 파일이 폴더 밖에 있는 경우에 발생합니다. 폴더에 origin 리모트가 없는 경우에도 발생합니다. glab minder doctor를 실행해 "not synced" 이유를 확인합니다. 세션이 실행되었을 때의 위치에 폴더를 그대로 두고, 경로가 문장부호만 다른 폴더의 이름을 바꾸고, 폴더에 origin 리모트가 있는지 확인합니다.
glab minder doctor가 에이전트 유형을 GitLab이 아직 지원하지 않는다고 표시합니다. glab이 세션을 처음 찾았을 때 GitLab이 해당 에이전트 유형을 받아들이지 않았습니다. 이러한 세션은 전송되지 않습니다. GitLab이 에이전트 유형을 받아들인 뒤에 glab이 찾은 세션은 전송됩니다. 메시지가 계속 표시되면 GitLab Support에 문의합니다.

관련 주제#

외부 연결 에이전트(ECA)를 AI Governance 대시보드에 연결

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

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. Claude Code, OpenCode, Cursor, Codex 같은 코딩 에이전트가 개발자의 컴퓨터에서 실행되면, AI Governance 대시보드는 GitLab CLI(glab)를 통해 이들을 외부 연결 에이전트(Externally Connected Agen...

히스토리
  • 코딩 에이전트의 세션 캡처가 GitLab 19.3에서 ai_agent_session_tracking이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • Cursor 및 Codex 세션이 GitLab 19.5에서 도입되었습니다.
  • GitLab 19.5에서 기본적으로 활성화되었습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

Claude Code, OpenCode, Cursor, Codex 같은 코딩 에이전트가 개발자의 컴퓨터에서 실행되면, AI Governance 대시보드는 GitLab CLI(glab)를 통해 이들을 외부 연결 에이전트(Externally Connected Agents, ECA)로 표시할 수 있습니다.

GitLab CLI(glab)는 각 에이전트의 로컬 트랜스크립트를 읽고, 세션과 그 이벤트를 에이전트가 작업한 GitLab 프로젝트로 전송합니다. 이후 세션은 다음 위치에 표시됩니다.

Warning

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

glab은 에이전트가 실행된 폴더의 Git 리모트에서 프로젝트를 찾습니다.

  • Claude Code와 OpenCode에서는 glab이 다른 명령과 같은 방식으로 리모트를 선택합니다. 즉, glab repo set-default로 설정한 리모트를 사용하고, 없으면 upstream, gitlab, origin 순서로 사용합니다. 포크 체크아웃에서는 Claude Code와 OpenCode 세션이 업스트림 프로젝트로 전송됩니다.
  • Codex에서는 glab이 Codex가 기록한 리포지터리 URL을 사용하고, 없으면 origin을 사용합니다.
  • Cursor에서는 glab이 origin을 사용합니다.

리모트는 glab이 로그인되어 있는 GitLab 인스턴스를 가리켜야 합니다. 이러한 리모트가 없는 폴더의 세션은 전송되지 않습니다.

사전 요구 사항#

  • 최상위 그룹에 GitLab Duo Agent Platform이 포함된 GitLab Premium 또는 Ultimate.
  • GitLab 인스턴스에 로그인된 glab. 필요한 버전은 에이전트와 명령 이름에 따라 다릅니다.
    • Claude Code, Cursor, Codex는 1.122.0 이상.
    • OpenCode는 1.125.0 이상이며, OpenCode 1.4 이상이 필요합니다.
    • glab govern을 대체한 glab minder 명령은 1.129.0 이상.
  • 프로젝트에 대한 Developer 이상의 권한.
  • 최상위 그룹에서 Allow external agents가 켜져 있어야 합니다. 기본적으로 켜져 있습니다. 이 설정은 CI/CD 파이프라인에서 실행되는 AI 카탈로그 외부 에이전트에 속하며, 세션 캡처도 제어합니다. 이 설정을 끄면 로컬 코딩 에이전트의 세션도 중단됩니다.
  • 그룹에 AI Governance가 켜져 있어야 합니다. 기본적으로 꺼져 있습니다. 이 사전 요구 사항은 ai_governance_session_gate 기능 플래그가 활성화된 경우에만 적용되며, 이 플래그는 기본적으로 활성화되어 있지 않습니다.
  • GitLab.com에서는 그룹에 속한 프로젝트여야 합니다. 개인 네임스페이스의 프로젝트에 대한 세션은 기록되지 않습니다.
  • 그룹 또는 프로젝트에 Store AI audit events가 켜져 있어야 합니다. 이 설정이 없으면 세션만 기록되고 이벤트와 도구 호출은 기록되지 않습니다. 이 설정은 기본적으로 꺼져 있습니다. 변경하려면 Owner 또는 Security Manager 권한이 필요합니다.
  • macOS 또는 Linux를 실행하는 컴퓨터.

AI Governance 켜기#

히스토리
  • ai_governance_enabled 요구 사항이 GitLab 19.6에서 ai_governance_session_gate라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 사전 요구 사항의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 플래그가 비활성화되어 있으면 GitLab은 최상위 그룹의 Allow external agents만 확인하며, 세션을 캡처하기 위해 AI Governance를 켤 필요는 없습니다.

AI Governance는 기본적으로 꺼져 있습니다. ai_governance_session_gate 기능 플래그가 활성화되어 있으면 AI Governance를 켤 때까지 GitLab이 glab이 보내는 세션을 거부합니다.

그룹에 대해 켭니다. 이 설정은 모든 하위 그룹과 프로젝트에 백그라운드에서 적용되며, 몇 분이 걸릴 수 있습니다. GitLab.com에서는 개인 네임스페이스의 프로젝트가 지원되지 않습니다.

사전 요구 사항:

  • 그룹에 대한 Owner 권한.

그룹 API를 사용해 ai_governance_enabled를 true로 설정합니다.

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "ai_governance_enabled=true" \
  --url "https://gitlab.example.com/api/v4/groups/<group_id>"

하위 그룹 Owner가 이 설정을 끄지 못하게 하려면 lock_ai_governance_enabled도 true로 설정합니다.

세션 캡처 설정#

에이전트를 실행하는 컴퓨터마다 사용자 계정별로 한 번씩 세션 캡처를 설정합니다. 이 절의 명령은 glab minder 참조에 문서화되어 있습니다.

--agents로 캡처할 에이전트를 선택합니다. 이 옵션이 없으면 glab minder setup은 이전 실행에서 설정한 에이전트를 설정하고, 없으면 Claude Code를 설정합니다. glab이 확인을 요청합니다. 스크립트에서 glab을 호출한다면 --yes를 전달합니다.

실행할 때마다 이전 실행에서 설정한 에이전트에 추가됩니다. 예를 들어 Cursor와 Codex 세션을 캡처하는 중이라면 glab minder setup --agents opencode를 실행합니다. OpenCode가 이들에 추가됩니다. 에이전트 캡처를 중단하려면 glab minder setup --uninstall을 실행한 다음, 원하는 에이전트를 다시 설정합니다.

Claude Code 세션 캡처#

Claude Code 세션은 훅을 통해 캡처되며, 훅에서 glab이 로그인할 수 있으면 훅이 응답마다 세션을 전송합니다. 훅이 놓친 항목은 백그라운드 작업이 전송합니다.

Claude Code 세션을 캡처하려면 다음을 실행합니다.

glab minder setup --agents claude-code

이 명령은 다음을 설치합니다.

  • ~/.claude/settings.json의 Stop 훅과 SessionEnd 훅. 훅은 응답할 때마다 세션을 전송하고, 세션이 끝나면 완료로 표시합니다.
  • 30분마다 실행되는 백그라운드 작업. 이 작업은 훅이 놓친 항목을 전송하고, 24시간 동안 활동이 없는 세션을 완료로 표시합니다. macOS에서는 이 작업이 launchd 에이전트이고, Linux에서는 systemd 사용자 타이머입니다.

명령을 실행하기 전에 종료된 세션은 전송되지 않습니다.

OpenCode 세션 캡처#

OpenCode 세션은 플러그인을 통해 캡처되며, 플러그인은 OpenCode가 응답을 마칠 때마다 세션을 전송합니다. 플러그인이 놓친 항목은 백그라운드 작업이 전송합니다.

OpenCode 세션을 캡처하려면 다음을 실행합니다.

glab minder setup --agents opencode

이 명령은 다음을 설치합니다.

  • 백그라운드 작업.
  • ~/.config/opencode/plugins/glab-govern.js 또는 (XDG_CONFIG_HOME이 설정된 경우) $XDG_CONFIG_HOME/opencode/plugins/glab-govern.js의 플러그인. glab이 설치하지 않은 파일이 이미 그 경로에 있으면 명령이 아무것도 변경하지 않고 중단됩니다. 해당 파일을 제거하거나 이름을 바꾼 다음 명령을 다시 실행합니다.

OpenCode는 모든 프로젝트의 모든 세션에 대해 플러그인을 로드합니다. 플러그인을 최신 상태로 유지하려면 glab minder setup을 다시 실행합니다.

명령을 실행하기 전에 종료된 세션은 전송되지 않습니다. OpenCode 세션은 24시간 동안 활동이 없으면 완료로 표시됩니다.

Cursor 및 Codex 세션 캡처#

glab은 Cursor와 Codex용 훅을 설치하지 않습니다. 백그라운드 작업이 30분마다 ~/.cursor/projects와 ~/.codex/sessions를 스캔해 이들의 세션을 찾습니다.

Cursor와 Codex 세션을 캡처하려면 다음을 실행합니다.

glab minder setup --agents codex,cursor

이 작업은 명령을 실행하기 전의 세션도 전송합니다. 단, 최근 89일 이내에 활동이 있었고 glab이 로그인된 GitLab 인스턴스의 프로젝트에 속한 세션이어야 합니다. 세션은 24시간 동안 활동이 없으면 완료로 표시됩니다. 사용자 지정 CODEX_HOME 폴더에 저장된 Codex 세션은 찾지 못합니다.

Cursor와 Codex 세션 캡처를 중단하려면 glab minder setup --uninstall을 실행한 다음, 원하는 에이전트를 다시 설정합니다.

설정 확인#

세션 캡처가 올바르게 구성되었는지 확인하려면 다음을 실행합니다.

glab minder doctor

이 명령은 다음을 수행합니다.

  • glab이 기본 GitLab 호스트에 로그인되어 있고 PATH에 있는지 확인합니다.
  • Claude Code 훅이 ~/.claude/settings.json에 있는지, GitLab API에 접근할 수 있는지 확인합니다.
  • OpenCode 플러그인이 설치되어 있고 최신 상태인지 확인합니다.
  • 백그라운드 작업이 설치되어 있는지, 마지막 실행 결과가 어땠는지 보고합니다.
  • 실패한 각 확인 항목에 대해 해결 방법을 설명합니다.

마지막 실행 줄에는 다음이 나열됩니다.

  • 세션 캡처가 활성화되지 않은 프로젝트.
  • GitLab이 거부한 에이전트 유형.
  • glab이 건너뛴 Cursor 세션.

이 명령은 전역 ~/.claude/settings.json만 읽습니다. 프로젝트의 .claude 폴더에 있는 훅은 누락된 것으로 보고되며, 전역 Stop 훅이 없는 동안에는 백그라운드 작업이 Claude Code 세션을 건너뜁니다.

백그라운드 작업을 기다리지 않고 지금 세션을 전송하려면 다음을 실행합니다.

glab minder audit sync --all

전송되는 데이터#

glab은 각 세션에 대해 다음을 전송합니다.

  • 입력한 프롬프트. 8KB를 넘는 프롬프트는 잘립니다. 첫 번째 프롬프트는 세션의 목표(goal)가 되기도 합니다.
  • 명령, 파일 경로, 편집 내용 같은 인수를 포함한 각 도구 호출. 8KB를 넘는 인수는 표식으로 대체됩니다.
  • 각 도구 호출의 결과, 소요 시간, 오류 메시지. 오류 메시지는 255자에서 잘립니다.
  • 각 응답의 모델과 토큰 사용량.
  • 세션이 완료되면 트랜스크립트 파일의 체크섬.

도구 출력과 응답 텍스트는 전송되지 않습니다. 단, 실패한 도구 호출의 출력 중 처음 255자는 오류 메시지로 전송됩니다. 컴퓨터를 식별하기 위해 glab은 해시된 머신 ID를 전송합니다.

에이전트마다 기록하는 세부 정보가 다릅니다.

에이전트 Claude Code와의 차이
OpenCode 프롬프트가 전송되지 않으며, 응답의 모델과 토큰 사용량도 전송되지 않습니다. 첫 번째 프롬프트는 여전히 세션의 목표가 됩니다. 도구 호출의 결과는 glab이 처음 전송했을 때 호출이 끝난 상태였던 경우에만 전송됩니다.
Codex Codex는 성공 여부를 기록하지 않으므로 모든 도구 호출의 결과가 오류 메시지 없이 완료로 기록됩니다.
Cursor Cursor는 결과, 토큰 사용량, 타임스탬프를 기록하지 않으므로 프롬프트와 도구 호출만 전송됩니다. 이벤트 시각은 트랜스크립트의 마지막 수정 시각으로 정해집니다.

ECA 세션 보기#

Show 컨트롤이 All agents(기본값) 또는 Connected로 설정되어 있으면 외부 연결 에이전트(ECA)의 세션이 AI Governance 대시보드에 표시됩니다.

  • Recent agent sessions 카드는 각 세션에 에이전트 이름을 붙입니다. 예를 들어 Cursor (glab) 또는 **Claude (glab)**입니다.
  • Most used agents 카드는 연결된 각 에이전트를 실행한 머신 수와 사용자 수와 함께 나열합니다. 예를 들어 2 machines · 2 users입니다.
  • KPI 타일과 다른 카드는 GitLab Duo Agent Platform 세션과 함께 세션과 도구 호출을 집계합니다.

세션과 그 이벤트는 AI 감사 이벤트 보고서에도 나열됩니다.

  • Claude Code 세션은 첫 번째 응답 직후에 표시되며, 에이전트를 종료하면 종료됨으로 표시됩니다. 종료 훅이 실행되지 않았다면 24시간 동안 활동이 없을 때 백그라운드 작업이 세션을 종료됨으로 표시합니다.
  • OpenCode 세션은 첫 번째 응답 직후에 표시되며, 24시간 동안 활동이 없으면 종료됨으로 표시됩니다.
  • Cursor 및 Codex 세션은 컴퓨터가 켜져 있고 로그인된 상태라면 보통 에이전트를 사용한 뒤 30분 이내에 표시됩니다. macOS에서는 백그라운드 작업의 첫 번째 실행이 설정 30분 후입니다. 이 세션은 24시간 동안 활동이 없으면 종료됨으로 표시됩니다.
  • 대시보드 수치는 약간의 지연 후 갱신됩니다.

연결된 에이전트 보기#

히스토리
  • GitLab 19.6에서 ai_governance_connected_agents_tab이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

Connected agents 탭에는 에이전트 연결이 하나씩 나열됩니다. 연결은 사용자가 한 컴퓨터에서 glab으로 프로젝트에 연결한 에이전트를 말합니다. 예를 들어 두 사용자가 같은 프로젝트에 Claude Code를 연결하면 행이 둘로 표시됩니다. 한 사용자가 두 컴퓨터에서 연결해도 마찬가지입니다.

사전 요구 사항:

  • 최상위 그룹에 대한 Owner 권한이 있거나, read_agent_artifacts 기능이 있는 사용자 지정 역할이 있어야 합니다.

연결된 에이전트를 보려면 다음을 수행합니다.

  1. 상단 바에서 Search or go to를 선택하고 최상위 그룹 또는 그 안의 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Governance를 선택합니다.
  3. Connected agents 탭을 선택합니다.

탭은 각 연결에 대해 다음을 표시합니다.

칼럼 설명
Agent 에이전트입니다. 예: Claude Code 또는 Cursor.
Connected by 에이전트를 연결한 사용자입니다.
Project 에이전트가 연결된 프로젝트입니다. 그룹에서만 표시됩니다.
First connected 사용자가 에이전트를 프로젝트에 처음 연결한 시각입니다.
Last active glab이 연결을 마지막으로 동기화한 시각이며, GitLab에 동기화 기록이 없으면 Never입니다.
Sessions 해당 연결에 대해 전송된 세션 수입니다. 1,000을 넘으면 **1,000+**로 표시됩니다.
Status 연결이 취소되었으면 Revoked입니다. 그렇지 않으면 최근 30일 이내에 glab이 연결을 동기화했거나 연결 생성 후 30일이 지나지 않았고 아직 동기화되지 않았으면 Active입니다. 그 밖의 모든 연결은 Inactive입니다.

연결은 Last active 기준으로 가장 최근 항목부터 나열됩니다. 일부 연결만 표시하려면 에이전트, 사용자, 상태로 필터링합니다.

세션 캡처 중단#

세션 캡처를 중단하려면 다음을 실행합니다.

glab minder setup --uninstall

이 명령은 백그라운드 작업과 OpenCode 플러그인을 제거하고 Cursor 및 Codex 세션 캡처를 중단합니다. glab 1.124.0 이상에서는 Claude Code 훅도 제거합니다. ~/.claude/settings.json의 다른 훅과 다른 OpenCode 플러그인은 변경되지 않습니다.

이전 버전의 glab에서는 Claude Code 훅이 그대로 남습니다. Claude Code 세션 캡처를 중단하려면 ~/.claude/settings.json의 hooks 섹션에서 glab govern audit sync 항목 두 개를 제거합니다. Stop 훅이 없으면 백그라운드 작업도 Claude Code 세션을 건너뜁니다.

이미 GitLab으로 전송된 세션은 대시보드에 남습니다.

문제 해결#

문제 원인 해결 방법
glab minder doctor가 실패한 확인 항목을 보고합니다. 이 컴퓨터의 설정이 완료되지 않았습니다. 확인 항목이 출력하는 해결 방법을 따릅니다.
glab minder doctor의 마지막 실행 줄에 프로젝트의 거버넌스가 활성화되지 않았다고 표시됩니다. 그룹 또는 프로젝트에 AI Governance가 켜져 있지 않거나, 프로젝트가 GitLab.com의 개인 네임스페이스에 있습니다. GitLab은 ai_governance_session_gate 기능 플래그가 활성화된 경우에만 이를 보고합니다. 그룹 Owner에게, GitLab Self-Managed와 GitLab Dedicated에서는 관리자에게 켜 달라고 요청합니다. GitLab.com의 개인 네임스페이스에 있는 프로젝트는 지원되지 않습니다.
glab minder audit sync --all이 403 Forbidden 경고를 출력하거나, glab minder doctor가 마지막 실행의 오류로 이를 표시합니다. 프로젝트에 대한 권한이 Developer 미만이거나, 그룹에 GitLab Duo Agent Platform이 없거나, 최상위 그룹에서 Allow external agents가 꺼져 있거나, 프로젝트가 GitLab.com의 개인 네임스페이스에 있습니다(둘 다 ai_governance_session_gate 기능 플래그가 비활성화된 경우). 또는 그룹 Owner가 이 컴퓨터의 에이전트 ID를 취소했습니다. 포크 체크아웃의 Claude Code와 OpenCode에서는 세션이 업스트림 프로젝트로 전송되었습니다. 그룹 Owner에게, GitLab Self-Managed와 GitLab Dedicated에서는 관리자에게 권한과 설정을 확인합니다. 포크 체크아웃에서는 glab repo set-default를 실행하고 세션을 전송할 프로젝트를 선택합니다.
세션은 표시되지만 이벤트나 도구 호출이 없습니다. 그룹 또는 프로젝트에서 Store AI audit events가 꺼져 있습니다. 이 설정을 켭니다. Owner 또는 Security Manager 권한이 필요합니다. 변경 전의 이벤트는 기록되지 않습니다.
세션이 전송되었지만 대시보드에 없습니다. 대시보드가 백그라운드에서 처리되는 데이터를 읽고 있거나, 필터가 세션을 제외합니다. Show를 All agents 또는 Connected로 설정하고 날짜 범위를 확인한 다음, 몇 분 기다렸다가 페이지를 새로 고칩니다.
에이전트가 프로젝트를 만든 뒤처럼, 세션이 전혀 전송되지 않습니다. 에이전트가 실행된 폴더(예: 홈 폴더)에 glab이 로그인된 GitLab 인스턴스를 가리키는 리모트가 없습니다. glab은 에이전트가 만들거나 포크하거나 클론한 프로젝트가 아니라 해당 폴더의 프로젝트로 세션을 전송합니다. 세션이 속해야 하는 GitLab 프로젝트의 클론에서 에이전트를 시작합니다.
Cursor 세션이 전혀 전송되지 않습니다. glab이 세션이 실행된 폴더를 확인하지 못했습니다. 폴더를 옮겼거나, 다른 폴더의 경로가 문장부호만 다른 경우(예: code/cli-docs와 code/cli/docs), 또는 세션이 건드린 모든 파일이 폴더 밖에 있는 경우에 발생합니다. 폴더에 origin 리모트가 없는 경우에도 발생합니다. glab minder doctor를 실행해 "not synced" 이유를 확인합니다. 세션이 실행되었을 때의 위치에 폴더를 그대로 두고, 경로가 문장부호만 다른 폴더의 이름을 바꾸고, 폴더에 origin 리모트가 있는지 확인합니다.
glab minder doctor가 에이전트 유형을 GitLab이 아직 지원하지 않는다고 표시합니다. glab이 세션을 처음 찾았을 때 GitLab이 해당 에이전트 유형을 받아들이지 않았습니다. 이러한 세션은 전송되지 않습니다. GitLab이 에이전트 유형을 받아들인 뒤에 glab이 찾은 세션은 전송됩니다. 메시지가 계속 표시되면 GitLab Support에 문의합니다.

관련 주제#