“이슈가 생성되었는데도 보드나 보고서에 나타나지 않는다”, “Sprint View에 이슈가 표시되지 않아 누락된 것으로 보인다”, “사람마다 보이는 이슈가 다르다”와 같은 문제가 발생할 때, 프로젝트 팀은 혼란과 불안감을 겪는다. 이는 개발/QA/운영 팀이 Jira를 통해 작업을 체계적으로 관리해야 할 때 가장 기본적인 기능이 작동하지 않을 때 생기는 대표적인 증상임. 특히 2025년 이후 Jira의 UI 및 기능이 지속 개선되고 있음에도 불구하고, 여전히 이슈 누락 문제는 빈번한 이슈로 보고되고 있다.
실제로 이슈가 보드나 보고서에서 보이지 않는 상황은 단순한 시각적 오류가 아니라 팀의 의사결정, 일정 관리, QA 및 릴리즈 품질에 직접 악영향을 미친다. 이는 누락된 이슈가 실제로는 존재하지만 시스템의 필터, 권한, 맵핑, 인덱싱 문제로 인해 숨겨지거나 아예 노출되지 않는 현상으로, Jira를 실무 도구로 적극 활용하는 조직에서 매우 큰 위험으로 간주된다.
심층 분석: 왜 Jira에서 이슈가 추적되지 않는가?
Jira의 이슈 트래킹은 필터(Permissions + JQL 쿼리), 보드 및 보고서 설정, 필드 구성, 인덱스 상태 등의 여러 구성 요소가 상호작용하여 이뤄진다. 한 요소라도 잘못 설정되어 있으면 이슈가 “시스템에는 존재”하나 “가시적으로 드러나지 않는” 현상이 발생한다. 이는 워크플로우나 필드 변경 및 최근 튜닝된 Jira Software 2025 버전에서도 여전히 빈번히 발생한다.
주요 기술적 이유는 다음과 같다:
- 보드 필터(Filter) 및 Quick Filter: 보드가 표시하는 이슈는 필터의 JQL 쿼리에 의해 결정된다. 잘못된 필터 조건은 의도치 않게 일부 이슈를 걸러낼 수 있다.
- 권한 셋팅(Permissions): 특정 이슈에 대한 읽기/보기 권한이 없으면 해당 사용자는 이슈를 볼 수 없다.
- 상태(Status)와 컬럼(Column) 맵핑: 보드 설정에서 특정 상태가 컬럼에 맵핑되지 않으면 그 이슈는 보드에서 사라진다.
- 인덱스 오류(재인덱싱 필요): Jira 검색 인덱스가 손상되거나 최신 상태로 업데이트되지 않으면 이슈가 검색·표시에 누락될 수 있다.
- 이슈 유형/상태 필드(Search Template) 설정 누락: Sprint나 Advanced Roadmaps 설정에서 필드 구성이 올바르지 않으면 이슈가 표시되지 않는다.
해결 솔루션 & 데이터: 이슈 추적 문제 해결을 위한 단계적 가이드
다음 표는 이슈 누락 유형별 주요 원인과 해결법을 정리한 것이다.
| 문제 유형 | 주요 원인 | 해결 방법 | 예상 소요 시간 |
|---|---|---|---|
| 보드에 이슈 누락 | 필터 설정 오류 | 보드 필터 JQL 재검토 및 수정 | 5~15분 |
| 권한 부족 이슈 | 사용자 권한 미설정 | Admin 권한으로 프로젝트 권한 확인 및 할당 | 10~20분 |
| 상태 컬럼 맵핑 누락 | 상태가 보드에 매핑 안 됨 | Columns 설정에서 상태 추가 | 5~10분 |
| 검색 인덱스 오류 | 인덱스 오래된 상태 | Full Reindex 수행 | 최대 30분 |
| Advanced Roadmaps 누락 | Resolution/Scope 설정 | Find your issue 기능으로 원인 분석 | 10~25분 |
다음 단계별 체크리스트를 순차적으로 수행함으로써 대부분의 이슈 누락 문제를 해결할 수 있다:
- 보드의 기본 필터(JQL)를 열어 현재 포함 대상 프로젝트 및 상태를 확인. 필터 예:
project = ABC AND status in (To Do, "In Progress", Done). - Quick Filter가 활성화 되어 있으면 모든 Quick Filter를 비활성화하여 기본 보드 상태로 확인.
- 프로젝트 관리자 권한으로 사용자 권한 스킴(Permissions Scheme)을 검토하고 필요한 “Browse Projects” 권한을 할당.
- 보드 설정 → Columns 메뉴로 이동하여 모든 Status가 올바른 Column에 매핑되어 있는지 확인.
- 관리자(Admin) 권한으로 System → Indexing → Full Reindex를 수행하여 검색 인덱스를 최신 상태로 유지.
- Advanced Roadmaps 이용 시, 문제가 지속된다면 “Find your issue” 기능을 통해 누락 이슈의 구체 원인을 진단.
전문가 조언 & 팩트체크: 잘못된 상식과 주의사항
- “이슈가 없는 것처럼 보인다면 무조건 삭제되었다”는 것은 잘못된 상식이다. 많은 경우 단순히 필터/맵핑 이슈로 숨겨진 것이다.
- 보드 필터를 수정할 때는 반드시 JQL 쿼리 문법을 정확히 검토해야 하며, 프로젝트 키 변경 시 필터 쿼리를 업데이트해야 한다.
- Sub-Task 이슈는 Scrum 보드 백로그에서 기본적으로 표시되지 않는 설계가 있으며 보드 Active Sprint 탭에서만 보인다.
- Full Reindex는 서버 성능에 영향을 줄 수 있으므로 프로젝트 규모에 따라 야간 또는 비작업 시간대에 수행하는 것이 권장된다.
- Advanced Roadmaps에서 완료된 이슈가 30일 이상 지난 경우 기본적으로 표시되지 않는다. 필요 시 설정 변경을 검토하라.
안내해드린 내용 참고가 되었길 바랍니다.