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