App Usage for Jira

이 문서는 App Usage for Jira 애드온을 활용하여 Jira에서 사용중인 앱 사용현황에 대해 파악하는 가이드를 공유하기 위해 작성되었다.

도구명	Jira Software - App Usage for Jira
버전
OS
비고

개요

앱에서 추가한 사용자 지정 필드, 워크플로, 데이터베이스 테이블, JQL 함수, REST API 사용량, 페이지 보기 및 대시보드를 추적하고 이러한 항목이 Jira 인스턴스에서 어떻게 사용되는지 알아볼 수 있습니다

설치날짜, 라이선스 만료일, 어떤 사용자들이 현재 앱을 사용중인지를 알 수 있습니다.

설치방법

해당 애드온은 무료 애드온으로 라이선스가 필요하지 않습니다. 아래 중 원하는 방식으로 설치합니다.

Jira 인스턴스에서 설치(최신버전 설치)

Administration > Manage apps.
In the Search the Marketplace search box, type app usage.
Select the Install button.
Follow the remaining prompts to install the app.

MarketPlace에서 파일을 다운 받아 설치(특정 버전 선택해서 설치 가능)

Download App Usage

Atlassian MarketPlace 이동(App Usage for Jira page on Atlassian Marketplace)
Get it now 선택 or Version 탭 선택하여 특정 버전 다운로드 선택

Install App Usage

Jira > Administration > Manage apps.
Upload app 선택
위에서 다운받은 파일을 업로드

App Usage 데이터가 추적되는 조건

API 호출 데이터는 APP Usage가 활성화된 경우에만 추적됩니다. 성능을 완화하기 위해 해당 데이터는 예약된 작업에 의해 5분마다 집계되고 업데이트됩니다. 감사 로그에서 앱 사용이 활성화된 시기를 확인할 수 있습니다

App Usage 기능

앱처음 설치하면 대부분의 기능이 자동으로 활성화됩니다. 웹 패널 사용은 일부 앱에서 디스플레이 문제를 일으킬 수 있으므로 기본으로 활성화되지 않습니다.

성능 문제 발생 시 아래 기능에 대해서 끄거나 키거나 할 수 있습니다.

기능 플래그 문자열	묘사
`plugin.app.usage.rest-usage.disabled`	로 설정하면 앱 사용이 REST API 호출 추적을 중지합니다. 플래그가 중지되는 데 최대 5분이 걸릴 수 있습니다. 기본적으로 사용하도록 설정되어 있습니다.
`plugin.app.usage.page-views-usage.disabled`	로 설정하면 앱 사용이 페이지 보기 추적을 중지합니다. 플래그가 중지되는 데 최대 5분이 걸릴 수 있습니다. 기본적으로 사용하도록 설정되어 있습니다.
`plugin.app.usage.web-panels-usage.disabled`	로 설정하면 앱 사용이 웹 패널 보기 추적을 중지합니다. 나는추적을 중지하는 데 최대 5분이 걸릴 수 있습니다. 기본적으로 1.8.0부터 사용하도록 설정됩니다.
`plugin.app.usage.web-panels-usage-clicks.enabled`	이 기능 플래그가 모두 .enabled로 설정되면 앱 사용은 웹 패널에서 클릭을 추적하기 시작합니다. 이는 웹 패널 사용 UI(권장).plugin.app.usage.web-panels-usage를 통해서도 설정할 수 있습니다 이 기능을 주의해서 사용하세요! 추적이 활성화되면 코딩된 방식에 따라 일부 앱 내에서 일관되지 않은 표시가 나타날 수 있습니다. 이 경우 기능 플래그를 사용하지 않도록 설정합니다. 기본적으로 비활성화되어 있습니다.
`plugin.app.usage.dashboard-views-usage.disabled`	disabled로 설정하면 앱 사용 현황이 대시보드를 마지막으로 본 시점에 대한 추적을 중지합니다. 중지하는 데 최대 5분이 걸릴 수 있습니다. 기본적으로 사용하도록 설정되어 있습니다.

APP Usage에서 수집한 데이터로 할 수 있는 일

데이터를 시작점으로 사용하여 팀에 설치된 앱의 중요성과 주요 사용 사례가 무엇인지 알 수 있습니다.
앱이 의도대로 사용되지 않는 이유를 알아 볼 수 있게 팀에서 설치된 앱을 사용유무를 알 수 있습니다.
앱 공급업체와 상의하여 앱의 특정 용도와 관련하여 고려해야 할 다른 데이터를 파악할 수 있습니다.
이 정보를 사용하여 성능 문제 또는 기타 사용 문제를 해결하거나 Atlassian 지원 엔지니어와 함께 추가 참조를 얻을 수 있습니다.

APP Usage 화면 설명

개요 화면

앱 사용현황 화면

일반 사용량 데이터

일반적인 사용 현황 데이터 탭은 다음과 같은 섹션으로 나뉩니다.

REST API 사용
데이터베이스 테이블
JQL 함수

REST API 사용현황

애드온에서 추가한 REST API의 사용량을 추적합니다.

DataBase Table

애드온이 도입한 테이블 수와 현재 행 수의 스냅샷을 확인할 수 있습니다.

JQL 함수

해당 애드온이 도입한 사용자 지정 JQL 함수를 사용하여 만든 검색 필터 수를 간략하게 설명합니다. JQL 함수를 사용한 수동 검색은 추적하지 않습니다.

사용자 상호 작용

사용자 상호 작용 탭은 다음과 같은 섹션으로 나뉩니다.

페이지 모듈 보기
웹 패널

페이지 모듈 보기

앱이 도입한 페이지 중 하나 이상의 조회수가 있는 페이지 수를 보여줍니다.

웹 패널

웹 패널 섹션에는 앱이 도입한 웹 패널과의 사용자 상호 작용이 표시됩니다. 이 섹션은 앱 웹 패널의 채택률과 빈도를 모니터링하는 데 유용하지만 웹 패널이 대화형이 아닌 경우 사용자 상호 작용이 표시되지 않을 수 있습니다.

사용자 지정 필드

애드온에서 제공하는 형식으로 생성한 사용자 지정 필드가 표시됩니다. Jira 및 다른 애드온에서 제공한 형식으로 생성한 사용자 필드는 표시되지 않습니다.

워크플로

워크플로 탭에는 워크플로 목록과 애드온에서 도입한 조건, 유효성 검사기 및 게시 함수가 워크플로에서 사용되는 횟수가 표시됩니다.

대시보드

Dashboards 탭에는 애드온이 도입한 가젯의 이름과 사용 중인 대시보드가 간략하게 표시됩니다. 최신 데이터는 10분마다 수집됩니다.

페이지 트리

개요