사용 매뉴얼
개요
대상 사용자: Atlassian Jira Cloud를 사용하는 조직의 보안·감사 담당자와 Jira 관리자
Atlassian Jira 앱으로 다음 업무를 수행할 수 있습니다.
- 권한, 사용자·그룹, 프로젝트, 필드·화면·워크플로 구성 변경과 이슈 삭제 이력 점검
- 이슈 생성, 필드 변경, 댓글 작성·수정 이력 추적
- 수집기 없이 jira-audit-logs 명령어로 감사 로그 조회
기본 개념·용어
| 용어 | 의미 | 관련 리소스 |
|---|---|---|
| 감사 로그 | Jira 사이트의 설정·권한 변경과 이슈 삭제 이력 | jira-audit |
| 이슈 활동 | 이슈 생성, 필드 변경, 댓글 작성·수정 이력. 필드 변경은 변경 이력 1건이 1행으로 기록됩니다 | jira-issue-activity |
| 변경사항 | 변경된 필드마다 필드명(field_name), 변경 전 값(changed_from), 변경 후 값(changed_to)을 담은 목록(changes) | 감사 로그, 이슈 활동 스키마 |
| 작업자 계정 ID | 감사 로그에서 작업을 수행한 Atlassian 계정의 ID(author_account_id). 이슈 활동 로그의 user와 같은 값입니다 | 감사 로그 스키마 |
| jira-audit-logs | Atlassian Jira에서 감사 로그 목록을 조회합니다 | jira-audit-logs |
| 접속 프로파일 | Jira Cloud REST API 연결에 필요한 자격증명(서브 도메인, 이메일, API 토큰)을 저장하는 소나 객체 | 설치 매뉴얼 참고 |
주요 화면·메뉴 경로
| 기능 | 경로 |
|---|---|
| 앱 관리 | 앱 |
| 접속 프로파일 | 시스템 > 접속 프로파일 |
| 수집기 상태·오류 확인 | 수집 > 수집기 |
| 로그 조회·명령어 실행 | 분석 > 쿼리 |
| 쿼리 정기 실행 | 분석 > 예약된 쿼리 |
작업 시나리오
시나리오 1: 삭제된 이슈와 삭제한 사용자 확인
목적: 이슈가 삭제됐을 때 어떤 이슈를 누가 언제 삭제했는지 확인합니다. 감사 로그에는 작업자 계정 ID만 있으므로, 이슈 활동 로그의 계정 정보와 연결해 이름과 이메일을 함께 봅니다.
사전 조건:
- 설치 매뉴얼의 감사 로그 수집 설정과 이슈 활동 로그 수집 설정이 완료되어 있어야 합니다.
- 토큰을 발급한 계정에 Jira 관리(Administer Jira) 전역 권한이 있어야 합니다.
수행 절차:
- 아래 쿼리를 분석 > 쿼리에서 실행합니다.
table duration=7d JIRA_AUDIT
| search summary == "Deleted Jira issue"
| fields _time, object_name, author_account_id, src_ip
| join type=left author_account_id [
table duration=30d JIRA_ISSUE_ACTIVITY
| sort limit=1 -_time by user
| fields user, user_name, user_email
| rename user as author_account_id ]
| sort -_time
| fields - author_account_id
- 작업자 계정 ID를 함께 보려면 마지막 줄(fields - author_account_id)을 지웁니다.
결과 확인:
| _time | object_name | src_ip | user_name | user_email |
|---|---|---|---|---|
| 2026-10-19 15:31:40 | PROJ-3 | 홍길동 | user@example.com | |
| 2026-10-13 17:19:05 | PROJ-6 | 203.0.113.10 | 홍길동 | user@example.com |
- object_name은 삭제된 이슈의 키입니다.
- src_ip는 기록되지 않는 경우가 있어 비어 있을 수 있습니다.
실패 대응:
| 증상 | 원인 | 해결 |
|---|---|---|
| 쿼리 결과 0건 | 조회 기간 안에 삭제된 이슈가 없음 | duration을 늘려 다시 조회 |
| user_name이 비어 있음 | 조회 기간(30일) 안에 그 사용자의 이슈 활동 기록이 없음 | 대괄호 안 duration을 늘리거나, 작업자 계정 ID로 Atlassian 관리 화면에서 확인 |
| 감사 로그 테이블이 비어 있음 | 모든 Jira 앱이 Free 플랜이거나 토큰 발급 계정에 관리 권한 없음 | 설치 매뉴얼 요구 사항의 플랜·계정 권한 확인 |
| 수집기 상태가 오류로 표시됨 | API 토큰 오류 또는 만료 | 수집기의 오류 보기 확인 후 설치 매뉴얼 "설치 후 검증"의 수집 오류 항목 참조 |
시나리오 2: 특정 이슈의 변경 이력 조회
목적: 특정 이슈의 담당자, 상태, 우선순위 등이 언제 누구에 의해 바뀌었는지, 어떤 댓글이 달렸는지 시간순으로 확인합니다.
사전 조건:
- 설치 매뉴얼의 이슈 활동 로그 수집 설정이 완료되어 있어야 합니다.
- 토큰을 발급한 계정이 해당 프로젝트의 이슈를 볼 수 있어야 합니다.
수행 절차:
- 확인할 이슈의 키를 정합니다. 예: PROJ-2
- 아래 쿼리를 분석 > 쿼리에서 실행합니다.
table duration=7d JIRA_ISSUE_ACTIVITY
| search issue_key == "PROJ-2"
| sort _time
| fields _time, action, user_name, changes, content
결과 확인:
| _time | action | user_name | changes | content |
|---|---|---|---|---|
| 2026-10-19 15:29:22 | issue_created | 홍길동 | 본문입니다. | |
| 2026-10-19 15:30:21 | issue_updated | 홍길동 | assignee: (없음) → 홍길동 | |
| 2026-10-19 15:31:27 | issue_updated | 홍길동 | status: Open → Triaged | |
| 2026-10-19 15:39:06 | issue_updated | 홍길동 | priority: Medium → High |
- 위 표에서는 changes를 "필드: 변경 전 → 변경 후"로 줄여 표시했습니다.
- 이슈 생성의 content는 이슈 설명이고, 댓글 작성·수정의 content는 댓글 내용입니다.
실패 대응:
| 증상 | 원인 | 해결 |
|---|---|---|
| 쿼리 결과 0건 | 조회 기간 안에 변경이 없거나 이슈 키가 다름 | duration을 늘리거나 이슈 키를 확인해 다시 조회 |
| 삭제된 이슈의 새 이력이 없음 | 삭제된 이슈는 Jira에서 더 이상 조회되지 않음 | 삭제 전에 수집된 이력은 테이블에 남아 있음. 삭제 기록은 시나리오 1로 확인 |
| 수집기 상태가 오류로 표시됨 | API 토큰 오류 또는 만료 | 수집기의 오류 보기 확인 후 설치 매뉴얼 "설치 후 검증"의 수집 오류 항목 참조 |
주의사항
- 분류(category) 값의 언어: 감사 로그의 category는 토큰 발급 계정의 언어 설정으로 번역되어 기록됩니다. 쿼리 조건에는 영문으로 기록되는 summary를 쓰는 것이 안전합니다.
- 감사 로그 보존 기간: Jira 감사 로그는 사이트 관리자가 설정한 보존 기간(최대 6개월) 동안만 보관되므로, 그보다 오래된 기록은 수집·조회되지 않습니다.
- 조회 가능 범위: 이슈 활동은 토큰 발급 계정이 볼 수 있는 프로젝트의 이슈만 수집됩니다.
- 댓글 수정·삭제: 댓글 수정 이벤트에는 수정 후 내용만 기록되고, 댓글 삭제는 수집 대상이 아닙니다. 이슈 삭제는 이슈 활동이 아닌 감사 로그에 기록됩니다.
- jira-audit-logs와 접속 프로파일: 명령어는 등록된 Jira 접속 프로파일을 모두 조회하므로, 토큰이 잘못되거나 만료된 프로파일이 하나라도 있으면 쿼리 전체가 실패합니다.
관련 문서
- 설치 매뉴얼 — API 토큰 발급, 접속 프로파일, 수집기 설정
- jira-audit-logs — 감사 로그 조회 명령어
- jira-audit — 감사 로그 스키마
- jira-issue-activity — 이슈 활동 로그 스키마