오픈소스 APM Scouter Paper 클라이언트 설치

❓ Scouter Paper란?

• 오픈소스 APM Scouter WEB API를 활용하여, 성능 데이터를 웹을 통해 확인할 수 있도록 제공하는 대시보드 소프트웨어
• 설치형 클라이언트의 접근성을 개선시키기 위해 다양한 디바이스에서 접근 가능토록 한 웹 클라이언트

1. 설치파일 다운로드

다운로드 링크

2. 설치 - 방법1(독립 실행, 추천됨!)

• 별도의 설치가 필요 없으며, 웹 서버에 다운로드한 정적 파일을 올려서 사용할 수 있음
• 이미 Scouter 다운로드시 내장되어 있는 웹 서버가 있어 Scouter Web API에 Scouter Paper를 업로드하여 바로 사용할 수 있음
• 아래는 Scouter에서 webapp을 콜렉터 서버와 독립적으로 실행하는 경우에 해당됨

scouter
   └ webapp
      └ conf
      └ extweb <-- 폴더 하위에 SCOUTER PAPER 파일을 복사합니다.
      └ lib
      └ logs

• 실행
  • scouter/webapp/startup.sh
  • scouter/webapp/startup.bat
• 중지
  • scouter/webapp/stop.sh
  • scouter/webapp/stop.bat
• 접속 (6188 포트)
  • http://서버주소:6188/extweb/index.html
    

3. 설치 - 방법2(임베디드 실행)

• Scouter에서 webapp을 독립 실행하지 않고 콜렉터 서버에 포함(embedded)된 형태로 실행하는 경우에 해당됨
• Scouter webapp은 json 파싱이나 메모리를 많이 사용하는 방식의 bulk성 데이터 처리를 동반하므로, 운영 환경에서 embedded 모드로 webapp을 실행하는 것은 권장되지 않음

scouter
   └ server
      └ conf
      └ extweb <-- 폴더 하위에 SCOUTER PAPER 파일을 복사합니다.
      └ lib
      └ logs

• 실행
  • 스카우터 콜렉터 서버와 같이 실행되고 중지됨
• 접속 (6180 포트)
  • http://서버주소:6180/extweb/index.html

4. 설정

• 설치 방법에 따른 설정 파일 수정
  • 독립 webapp : scouter/webapp/conf/scouter.conf 수정
  • 임베디드 : scouter/server/conf/scouter.conf 수정
• 기본 설정

# 웹 API 활성화
net_http_server_enabled=true
net_http_api_enabled=true
net_http_port=6188 or 6180

• 인증 관련 설정
  • IP 기반 인증

    net_http_api_auth_ip_enabled=true
    net_http_api_allow_ips={ip1},{ip2},...

  • ID / PW 기반 인증 + 쿠키
    • Scouter Paper > Settings > Authentification configuration에서 반드시 cookie 선택

    net_http_api_auth_session_enabled=true
    net_http_api_cors_allow_credentials=true

  • ID / PW 기반 인증 + 토큰
    • Scouter Paper > Settings > Authentification configuration에서 반드시 token 선택

    net_http_api_auth_bearer_token_enabled=true

🚀 상세 설정 및 대시보드 사용법

Scouter paper 깃허브 매뉴얼 링크