감사 로그¶
감사 로그 페이지는 /connector-audit 경로에 해당합니다.
애플리케이션이 기록한 내용을 두 탭으로 나누어 보여 줍니다. 커넥터 작업 탭에는 이메일이나 Slack 같은 커넥터를 호출한 기록이 되돌리기 상태와 함께 표시되고, 도구 실행 탭에는 어떤 도구가 어디에서 호출되어 얼마나 걸렸고 어떻게 끝났는지가 표시됩니다.
목록 거르기¶
필터는 각 탭의 도구 줄에 있습니다. 커넥터 작업은 커넥터, 기능 분류(읽기, 쓰기, 삭제/변경), 기간으로 거르고, 도구 실행은 도구, 출처(에이전트, 데스크톱 앱, REST API, MCP 엔드포인트), 결과(성공, 실패, 거부됨), 기간으로 거릅니다. 기간은 오늘, 최근 7일, 최근 30일, 전체 기간 가운데 고르거나, 기간 지정에서 달력으로 시작일과 종료일을 고르면 됩니다. 커넥터 목록과 도구 목록에는 페이지가 지금까지 불러온 이름이 모두 남아 있어서, 하나를 골라도 나머지가 사라지지 않습니다.
펼친 항목에서 이 실행으로 필터를 누르면 도구 줄에 실행 칩이 나타납니다. 실행 필터는 두 탭에 함께 적용되므로, 탭을 바꾸면 같은 실행이 그 탭에서 한 일을 바로 볼 수 있습니다. 실행 기록에서 실행의 상세를 열면 감사 로그 항목에 링크가 있는데, 누르면 그 실행으로 필터가 걸린 채 이 페이지의 도구 실행 탭이 열리고, 필터는 페이지 주소에 들어 있어 새로고침해도 유지됩니다. 칩을 누르면 필터가 풀리고, 지우기는 실행 필터를 포함해 도구 줄의 필터를 모두 초기화합니다.
목록 머리에는 표시된 항목 수가 나오고, 오른쪽 끝의 정렬 아이콘으로 최신 순과 오래된 순을 바꿀 수 있습니다. 커넥터 작업은 50건씩 불러오며 목록 아래의 더 불러오기로 이어서 볼 수 있습니다. 도구 실행은 조건에 맞는 실행 가운데 최근 200건을 보여 주는데, 더 있으면 목록 머리에 최근 200건만 표시 중이라고 나오고 오래된 순 정렬도 이 200건 안에서 적용됩니다.
행 읽기¶
행의 첫 줄에는 무엇이 언제 실행되었는지가 나옵니다. 커넥터 작업이면 커넥터와 작업 이름이, 도구 실행이면 도구와 출처, 속한 실행, 소요 시간이 표시됩니다. 둘째 줄은 정상적으로 성공한 작업과 다른 점이 있을 때만 나타나는데, 실패하거나 거부된 결과(도구 실행은 오류 내용까지), 최선 수준이거나 불가능한 되돌리기, 마스킹된 필드, 채널 대상이 여기에 해당합니다. 되돌릴 수 있는 커넥터 작업은 이 줄에 되돌리기 버튼이 있고, 버튼 이름은 생성된 항목 삭제처럼 되돌리면 일어나는 일을 말합니다.
항목 상세¶
항목을 클릭하면 그 카드가 제자리에서 펼쳐지며 행 아래에 상세가 나타나고, 나머지 목록은 보던 위치 그대로 남습니다. 행을 다시 클릭하면 접히는데, 한 번에 한 항목만 펼쳐지므로 다른 항목을 열면 앞서 펼친 항목은 접힙니다.
커넥터 작업의 상세에는 항목 ID, 기능 분류, 실행, 승인 같은 식별 정보와 매개변수(마스킹된 값은 가려서), 실행 취소 상태, 롤백 결과가 표시됩니다. 도구 실행의 상세에는 결과, 오류, 소요 시간, 실행 ID와 호출 ID, 그리고 백엔드가 마스킹하고 남긴 인자가 표시됩니다. 커넥터 작업의 되돌리기는 목록의 행에서 실행하며, 요청 결과도 그 행에 표시되고 거부되면 기록된 실패 유형을 보여 줍니다.
에이전트 실행에 속한 항목의 상세에는 이 실행으로 필터 버튼이 있습니다. 누르면 위에서 설명한 실행 필터가 걸리고 항목이 접힙니다.
항목 내보내기¶
페이지 머리의 내보내기를 누르면 CSV와 JSON 형식을 고르는 메뉴가 열리고, 지금 보고 있는 탭의 기록을 내보냅니다. 목록이 비어 있으면 누를 수 없습니다. 내보내기에 실패하면 탭 위에 이유가 표시되고 목록은 그대로 유지됩니다. 옆의 새로고침은 지금 보고 있는 탭을 다시 불러옵니다.
커넥터 작업은 화면에 불러온 행만이 아니라 커넥터, 기능 분류, 실행, 기간 필터에 맞는 항목을 모두 내보냅니다. 정렬 아이콘은 적용되지 않아서, 내보낸 항목은 기록된 순서인 오래된 순으로 정렬됩니다. JSON 파일에는 전체 레코드가 담기고, CSV 파일은 id, occurredAt, connectorName, operationId, capability, agentRunId, approvalId, correlationId, outcome, verdict 컬럼으로 줄인 요약입니다. 매개변수, 실행 취소 상태, 마스킹 메타데이터는 JSON 파일에서만 확인할 수 있습니다.
커넥터 작업은 한 번에 최대 25,000건까지 내보낼 수 있습니다. 필터에 맞는 항목이 그보다 많으면 일부만 담긴 파일을 받는 대신 범위를 좁혀 달라는 메시지와 함께 내보내기가 실패하는데, 항목이 조용히 빠진 감사 기록은 아예 실패한 내보내기보다 위험하기 때문입니다. 커넥터, 기능 분류, 실행, 기간 필터로 범위를 줄인 뒤 다시 시도하세요. 기본 보관 정책은 10,000건을 보관하므로, 보관 기간을 늘렸거나 보존 처리한 항목이 많은 환경에서만 이 제한에 걸립니다. 파일 이름은 connector-audit-export-<timestamp>.csv 또는 .json입니다.
도구 실행은 탭에 표시된 최근 200건만이 아니라 도구, 출처, 결과, 실행, 기간 필터에 맞는 실행을 모두 내보냅니다. 커넥터 작업과 마찬가지로 정렬 아이콘은 적용되지 않아서, 내보낸 항목은 오래된 순으로 정렬됩니다. JSON 파일에는 저장된 레코드가 그대로 담기고, CSV 파일의 컬럼은 id, occurredAt, toolName, origin, outcome, durationMs, runId, callId, error, arguments(마스킹된 인자를 JSON으로), redactedFields(마스킹된 경로를 세미콜론으로 구분)입니다. 인자와 오류는 실행이 기록될 때 이미 마스킹되므로, 파일에는 페이지에 표시되는 것과 같은 마스킹된 값이 담깁니다.
도구 실행은 한 번에 최대 25,000건까지 내보낼 수 있고, 그보다 많으면 커넥터 작업과 같은 방식으로 범위를 좁혀 달라는 메시지와 함께 내보내기가 실패합니다. 도구 실행 기록은 정해진 건수가 아니라 30일 동안 보관되므로, 사용량이 많은 환경에서는 보관 기간 안에 기록이 이보다 많아질 수 있습니다. 이럴 때는 기간을 짧게 나눠서 내보내거나 도구, 출처, 결과, 실행으로 범위를 좁히세요. 파일 이름은 tool-execution-audit-export-<timestamp>.csv 또는 .json입니다.
두 CSV 파일 모두 스프레드시트가 수식으로 읽을 값(=, +, -, @로 시작하는 값)에는 앞에 작은따옴표를 붙입니다. 내보낸 감사 데이터는 애플리케이션의 마스킹 경계를 벗어나므로 감사 로그 자체와 같은 수준으로 주의해서 다뤄야 합니다.
이 페이지가 필요한 때¶
커넥터가 실제로 무엇을 했는지 검토하거나 어떤 작업을 되돌릴 수 있는지 확인할 때 감사 로그를 엽니다. 에이전트 실행 하나가 어떤 도구를 호출했고 그중 무엇이 거부되었는지 볼 때도, 승인과 연결된 활동을 추적할 때도 사용할 수 있고, 원시 로그를 열기 전에 커넥터 워크플로우의 문제를 좁히는 데에도 도움이 됩니다.