제품에 대한 각종 요청 시 전달 자료 명세

How To
1

로그프레소 제품을 사용하시면서 여러 상황들에서 문의나 요청을 주시는 경우가 있습니다.

각 요청 케이스마다 어느 정도 정형화된 전달이 필요한 자료들이 있어 이를 정리해서 공유드립니다.

  • 모든 요청 공통 사항

    • Sonar 버전

    • 서버 구성 정보 (이중화 여부, 서버 역할별 구성 현황)

  • 신규 기능 요청

    • 사용자의 사용환경이나 사용하려는 데이터 모양 등 실제 요청자의 사용 패턴

    • 신규 기능의 경우 특히나 요구사항 명세가 명확해야함

      • 원하는 신규 기능 요구사항에 대해 상세한 설명 필요

  • UI SDK를 이용한 custom UI 개발 시 지원 요청

    • UI-SDK 버전, 종류

    • 브라우저 콘솔 에러 로그

    • araqne.log

    • 가이드 외에 구현하거나 수정한 개발 소스 부분

  • 서비스 장애 대응 요청

    • 공통

      • 문제 시점의 araqne log 전체

      • 아래 유형 별 자료들도 문제 시점의 자료가 필요

    • 성능 문제

      • JFR

        • OS Shell> ./jcmd {PID} JFR.start duration=60s settings=profile filename=/path/to/jfr_yyyyMMdd.jfr

    • 힙 부하 or GC 문제

      • 1차 jmap

        • [OS Shell] ./jcmd {PID} GC.class_histogram > /path/to/histogram_yyyyMMdd.txt

      • 2차 힙덤프 (아래 2가지 방법 중 하나로 수행하되 가능한 로그프레소 쉘 사용을 추천)

        • 로그프레소 쉘> sunperf.dumpHeap /path/to/heapdump_yyyyMMdd.hprof true

        • OS 쉘> $JAVA_HOME/bin/jcmd {SONAR_PID} GC.heap_dump -all=true /path/to/heapdump_yyyyMMdd.hprof

    • 수집 중단, 응답 불능 등

      • jstack (아래 2가지 방법 중 하나로 수행하되 가능한 로그프레소 쉘 사용을 추천)

        • 로그프레소 쉘> jstack

        • OS 쉘> $JAVA_HOME/bin/jcmd {SONAR_PID} Thread.print > /path/to/jstack_yyyyMMdd.txt

      • jstack의 경우 10초 간격으로 3차례 정도 생성하여 전달

  • 버그 리포팅

    • 최대한 상세한 재현 시나리오

    • 관련 에러 로그