설치 매뉴얼
개요
Atlassian Confluence Cloud REST API를 주기적으로 호출해 사이트의 감사 로그, 콘텐츠 활동 로그, 콘텐츠 삭제 로그를 수집합니다.
적용 범위
요구 사항
| 항목 | 요구사항 | 비고 |
|---|---|---|
| Confluence 플랜 | 감사 로그 수집은 Free 이외의 플랜에서 사용 가능 | Free 플랜은 감사 로그를 제공하지 않음 |
| 계정 권한 | 감사 로그: Confluence 관리자 전역 권한, 콘텐츠 활동: 수집할 스페이스의 보기 권한 | 볼 수 없는 스페이스·페이지는 수집 제외 |
| 자격증명 | Atlassian 계정 이메일, API 토큰 | API 토큰 만들기 버튼으로 발급한 토큰 |
| 네트워크 허용 | HTTPS/443 (소나 수집 노드 → {서브 도메인}.atlassian.net, Outbound) | HTTP 프록시 경유 가능 |
Atlassian Confluence 설정
수집에는 Atlassian 계정의 이메일과 API 토큰을 사용합니다. 토큰을 발급한 계정의 권한 범위 안에서만 로그를 조회할 수 있으므로, 감사 로그까지 수집하려면 Confluence 관리자 권한이 있는 계정으로 토큰을 발급합니다.
API 토큰 발급
수집에 사용할 Atlassian 계정으로 로그인한 뒤 API 토큰 관리 페이지로 이동하여 API 토큰 만들기 버튼을 클릭합니다.
대화상자에서 아래와 같이 입력하고 만들기 버튼을 클릭합니다.
- Name: 토큰을 식별할 이름 (예:
logpresso) - 만료 날짜: 토큰 만료 날짜. 최대 1년까지 지정 가능
API 토큰이 생성되면 복사 버튼을 클릭해 클립보드에 복사한 뒤 안전한 곳에 보관하고 완료 버튼을 클릭합니다. 이 단계를 완료한 후에는 API 토큰을 다시 확인할 수 없습니다.
새로 만든 토큰이 작동하기까지 최대 1분 정도 걸릴 수 있습니다. API 토큰에는 만료일이 있으므로, 만료일 전에 새 토큰을 발급해 접속 프로파일의 API 토큰을 갱신합니다.
계정 권한 확인
감사 로그를 수집하려면 토큰을 발급한 계정에 Confluence 관리자 전역 권한이 있어야 합니다. 콘텐츠 활동은 계정이 볼 수 있는 스페이스와 페이지만 수집되므로, 수집할 스페이스마다 해당 계정에 보기 권한을 부여합니다. 페이지 제한으로 계정이 볼 수 없는 페이지는 수집되지 않습니다.
로그프레소 접속 프로파일 설정
로그프레소의 시스템 > 접속 프로파일 메뉴에서 추가 버튼을 클릭하고 아래와 같이 설정합니다:
- 이름: 접속 프로파일을 식별할 고유한 이름 (예: Confluence)
- 식별자:
confluence_cloud - 유형:
Confluence - 서브 도메인: 접속 주소가
example.atlassian.net인 경우example - 이메일: API 토큰을 발급한 Atlassian 계정 이메일
- API 토큰: 이전 단계에서 발급한 API 토큰
- HTTP 프록시: 프록시를 경유하는 경우
IP:포트형식으로 입력. 직접 접속하면 비워 둠 - 접속 타임아웃: 30 (초)
- 읽기 타임아웃: 30 (초)
로그프레소 수집 설정
감사 로그, 콘텐츠 활동 로그, 콘텐츠 삭제 로그는 수집기를 각각 등록합니다. 모든 수집기는 앞 단계에서 등록한 접속 프로파일을 함께 사용합니다.
감사 로그 수집 설정
사용자·그룹, 권한, 스페이스, 공개 링크 설정 변경 등 Confluence 감사 로그를 수집합니다. 로그프레소의 수집 > 수집기 메뉴에서 추가 버튼을 클릭하고 아래와 같이 설정합니다:
- 이름: Confluence Audit
- 주기: 60초
- 수집 모델:
Confluence Audit - 테이블:
CONFLUENCE_AUDIT - 접속 프로파일:
confluence_cloud - 초기 수집 일수: 7
초기 수집 일수는 수집기가 처음 실행될 때 소급할 일수이며 1~365일 사이로 지정합니다. 처음 실행된 이후에는 저장된 수집 위치부터 이어서 수집하므로 값을 바꿔도 반영되지 않습니다. Confluence 감사 로그는 기본 1년간 보관되며 사이트 관리자가 1~12개월 사이로 바꿀 수 있으므로, 보존 기간보다 오래된 기록은 수집되지 않습니다.
콘텐츠 활동 로그 수집 설정
페이지·블로그의 게시·수정과 댓글·첨부 파일의 작성·수정 활동을 수집합니다. 로그프레소의 수집 > 수집기 메뉴에서 추가 버튼을 클릭하고 아래와 같이 설정합니다:
- 이름: Confluence Content Activity
- 주기: 60초
- 수집 모델:
Confluence Content Activity - 테이블:
CONFLUENCE_CONTENT_ACTIVITY - 접속 프로파일:
confluence_cloud - 초기 수집 일수: 7
초기 수집 일수는 1~365일 사이로 지정하며, 감사 로그와 마찬가지로 처음 실행될 때만 적용됩니다.
콘텐츠 본문, 댓글 내용, 작성자 이메일은 별도 설정 없이 함께 수집됩니다. 작성자 이메일은 Atlassian 계정의 프로필 공개 설정에 따라 비어 있을 수 있습니다. 페이지 열람 기록과 페이지 제한(권한) 변경은 콘텐츠 활동에 포함되지 않으며, 권한 변경은 감사 로그에서 확인합니다.
콘텐츠 삭제 로그 수집 설정
페이지·블로그를 휴지통으로 이동한 기록을 수집합니다. 로그프레소의 수집 > 수집기 메뉴에서 추가 버튼을 클릭하고 아래와 같이 설정합니다:
- 이름: Confluence Content Trash
- 주기: 60초
- 수집 모델:
Confluence Content Trash - 테이블:
CONFLUENCE_CONTENT_TRASH - 접속 프로파일:
confluence_cloud
설치 후 검증
아래 쿼리로 수집이 실제로 동작하는지 최종 확인합니다. 테이블 이름은 수집기에 지정한 이름으로 바꿔 실행합니다.
table duration=7d CONFLUENCE_AUDIT, CONFLUENCE_CONTENT_ACTIVITY, CONFLUENCE_CONTENT_TRASH
| stats count by _table
- 정상: 감사 로그와 콘텐츠 활동 테이블의 레코드 수가 1 이상. 콘텐츠 삭제 테이블은 수집기 등록 이후 휴지통으로 이동한 페이지·블로그가 있을 때만 기록됩니다.
- 비정상: 결과가 없으면 접속 프로파일의 서브 도메인·이메일·API 토큰과 토큰 만료 여부, 토큰 발급 계정의 권한, 네트워크 도달(HTTPS/443)과 HTTP 프록시 설정을 재확인합니다. 최근 7일간 사이트에 콘텐츠 활동이 없었다면 콘텐츠 활동 테이블은 비어 있을 수 있습니다.
- 수집 오류: 수집기 상태가 오류로 표시되면 수집기의 오류 보기에서 원인을 확인합니다.
HTTP 403: authentication credentials are incorrect or the user does not have permission또는HTTP 404: content not found or the user does not have permission이 표시되면 접속 프로파일의 이메일·API 토큰이 올바른지, 토큰 발급 계정에 해당 권한이 있는지 확인합니다.