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

1. 1.  Scouter Paper란?

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

 

 

---

 

2. 2.  설치파일 다운로드

다운로드 링크

 

 

---

 

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

• 별도의 설치가 필요 없으며, 웹 서버에 다운로드한 정적 파일을 올려서 사용할 수 있음
• 이미 Scouter 다운로드시 내장되어 있는 웹 서버가 있어 Scouter Web API에 Scouter Paper를 업로드하여 바로 사용할 수 있음
• 아래는 Scouter에서 webapp을 콜렉터 서버와 독립적으로 실행하는 경우에 해당됨
  Scouter
      》 extweb : 폴더 하위에 설치한 Scouter Paper 파일들을 전부 복사
      》 conf
      》 lib
      》 logs
• 실행
  • scouter/webapp/startup.sh
  • scouter/webapp/startup.bat
• 중지
  • scouter/webapp/stop.sh
  • scouter/webapp/stop.bat
• 접속 (6188 포트)
  • http://서버IP:6188/extweb/index.html

 

 

---

 

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

• Scouter에서 webapp을 독립 실행하지 않고 콜렉터 서버에 포함(embedded)된 형태로 실행하는 경우에 해당됨
• Scouter webapp은 json 파싱이나 메모리를 많이 사용하는 방식의 bulk성 데이터 처리를 동반하므로, 운영 환경에서 embedded 모드로 webapp을 실행하는 것은 권장되지 않음
  Scouter
      》 server
          》 extweb : 폴더 하위에 설치한 Scouter Paper 파일들을 전부 복사
          》 conf
          》 lib
          》 logs

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

 

---

 

5. 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=6188BASH

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

    net_http_api_auth_ip_enabled=true
    net_http_api_allow_ips=IP1,IP2,IP3,...BASH

  • 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

 

 

---

 

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

• Scouter paper 깃허브 매뉴얼 링크