[Scouter] 설치 · Tomcat 연동 · Slack 알림 연동!!






1. 사전 준비(공통)

sudo yum install -y java-1.8.0-openjdk-devel
export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")

  • Scouter 릴리스 페이지에서 최신 tar.gz 를 다운로드(또는 GitHub 릴리즈). (아래 예시는 /opt/scouter 기준). GitHub

cd /opt
# 최신 릴리스 파일명 예시: scouter-2025xxxx.tar.gz
sudo wget https://github.com/scouter-project/scouter/releases/download/<TAG>/scouter-<DATE>.tar.gz
sudo tar xzf scouter-<DATE>.tar.gz
sudo mv scouter-<DATE> scouter

2. Scouter Collector / Server 설치 (중앙 서버)

Collector(Server)는 Agent에서 오는 데이터를 받아 저장/전달하는 역할입니다.

  1. 폴더 구조 예시 (설치된 scouter 폴더 안에 collector, server, client가 있습니다). 기본 Collector 포트는 6100 등으로 사용. JM Engineering Blog

  2. Collector(및 server) 실행(간단 테스트)

cd /opt/scouter/collector
# 실행 스크립트(예: start.sh 또는 run.sh)가 있는 경우 사용
./start-collector.sh &

# server (UI/관리 포함)
cd /opt/scouter/server
./start-server.sh &

실무: systemd 단위 파일로 등록해 서비스로 관리하는 것을 권장합니다(아래 systemd 예시 참고).

  1. systemd 예시 (Scouter Collector)
    파일: /etc/systemd/system/scouter-collector.service

[Unit]
Description=Scouter Collector
After=network.target

[Service]
Type=simple
User=scouter
Group=scouter
WorkingDirectory=/opt/scouter/collector
ExecStart=/usr/bin/java -Xms256m -Xmx512m -jar ./scouter-collector.jar
Restart=on-failure
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now scouter-collector
sudo journalctl -u scouter-collector -f

  1. 방화벽: Collector가 수신하는 포트(예: 6100 등)를 허용. (iptables 또는 firewalld에서 설정).

참고: 기본 Quick-Start / Collector 설치 가이드를 참조하세요. GitHub+1

3. (옵션) Host Agent 설치 — OS 지표 수집

/opt/scouter/agent.host 디렉토리에 host agent가 있습니다. 아래 예시로 실행:

cd /opt/scouter/agent.host
./host.sh start
# 또는
nohup ./host.sh > /var/log/scouter-host.log 2>&1 &

conf 디렉토리에서 scouter.conf를 열어 collector 주소(서버 IP/포트)를 지정하세요.

4. Java Agent 설치 — Tomcat 연동 (실습 가이드)

Tomcat에 Scouter Java Agent를 붙여 애플리케이션 트랜잭션을 모니터링합니다.

4.1 준비

  • Scouter Java Agent 파일: /opt/scouter/agent.java/scouter.agent.jar

  • Agent 설정 파일: /opt/scouter/agent.java/conf/scouter.conf (또는 scouter1.conf 등)

4.2 Tomcat 시작 스크립트에 -javaagent 옵션 추가

Tomcat이 설치된 서버에서 catalina.sh(또는 시스템에 따라 /etc/systemd/system/tomcat.service의 JAVA_OPTS)를 수정합니다.

예: /opt/tomcat/bin/catalina.sh (수정 전 백업 권장)

# 아래 3줄을 CATALINA_OPTS 또는 JAVA_OPTS에 추가
export SCOUTER_AGENT_DIR=/opt/scouter/agent.java
export CATALINA_OPTS="$CATALINA_OPTS -javaagent:${SCOUTER_AGENT_DIR}/scouter.agent.jar"
export CATALINA_OPTS="$CATALINA_OPTS -Dscouter.config=${SCOUTER_AGENT_DIR}/conf/scouter.conf"
export CATALINA_OPTS="$CATALINA_OPTS -Dobj_name=tomcat-myapp-01"

또는 systemd 단위 파일 환경에 직접:

Environment="JAVA_OPTS=-javaagent:/opt/scouter/agent.java/scouter.agent.jar -Dscouter.config=/opt/scouter/agent.java/conf/scouter.conf -Dobj_name=tomcat-myapp-01"

중요 포인트

  • -Dobj_name은 UI에서 표시될 객체 이름(서버 식별자)입니다. 환경별로 중복되지 않게 지정하세요. GitHub

4.3 scouter.conf 핵심 설정(예시)

파일: /opt/scouter/agent.java/conf/scouter.conf

# Collector 서버 IP:PORT (예시)
scouter.server.ip=10.0.1.100
scouter.server.port=6100

# Agent 이름 (UI에 표시될 이름)
obj_name=tomcat-myapp-01

# 로그, 전송 간격 등 (기본값이 있음)
net_collector_udp_port=6100
net_tcp_server_port=6108

(※ 실제 키/옵션명은 배포된 버전의 conf 예시를 확인해 적용하세요.) JM Engineering Blog+1

4.4 Tomcat 재시작 / 확인

# Tomcat 재시작
sudo systemctl restart tomcat

# Agent 적용 확인: Scouter Client에서 obj_name 또는 서버 IP로 보이는지 확인
# 또는 로그에서 scouter.agent.jar 로딩 로그 확인
tail -f /opt/tomcat/logs/catalina.out

5. Scouter Client 접속

  • Scouter Client(데스크탑 Java 애플리케이션)를 실행해 Collector/Server 주소(예: 127.0.0.1:6100)와 로그인(admin/admin 기본)을 입력하면 모니터링 화면이 보입니다. GitHub

6. Scouter 알람(Alerts) → Slack 연동 (실습)

Scouter 자체에는 알람 생성 기능이 있고, Slack으로 전송하려면 서버 플러그인을 사용하거나 외부 Webhook을 이용한 연동을 합니다. 오픈소스 커뮤니티에서 제공하는 Slack 플러그인 예시(scouter-plugin-server-alert-slack)가 있습니다. GitHub

6.1 방법 선택지 요약

A. Scouter server plugin (추천 — 서버 레벨에서 알람을 받아 Slack으로 전송)
B. 외부 스크립트/웹훅 연동 (간단: Scouter 알람 로그를 받아서 curl로 Slack Webhook 호출)

아래에 두 방법 모두 단계별로 설명합니다.

6.2 A. Scouter Server Plugin 방식 (GitHub 플러그인 사용 예시)

  1. 플러그인 소스 가져오기

cd /tmp
git clone https://github.com/scouter-contrib/scouter-plugin-server-alert-slack.git
cd scouter-plugin-server-alert-slack

  1. 빌드 (Maven 필요)

# 빌드하여 JAR 생성
mvn clean package
# 생성된 jar 위치: target/*.jar

  1. 플러그인 배포

  • 생성된 JAR 파일을 Scouter Server의 plugins 디렉토리(또는 scouter/server/plugins)에 복사합니다.

sudo cp target/scouter-plugin-server-alert-slack-*.jar /opt/scouter/server/plugins/

  1. Slack Webhook 준비

  • 워크스페이스에서 Incoming Webhook을 생성하고, 전송할 채널과 Webhook URL을 얻습니다. (Slack에서 "앱 추가 → Incoming Webhooks" → Webhook URL 복사)

  1. 플러그인 설정

  • 플러그인에 따라 conf 또는 properties 파일에 Webhook URL을 설정합니다. (플러그인 README에 설정 방식 명시)
    예시 (플러그인 설정 파일 slack.conf 또는 scouter-plugin.properties):

slack.webhook.url=https://hooks.slack.com/services/T00000000/B00000000/xxxxxxxxxxxxxxxxxxxx
slack.channel=#ops-alert
slack.username=ScouterAlert

(정확한 설정 파일/키는 플러그인 문서를 확인 후 적용하세요.) GitHub

  1. Scouter Server 재시작

sudo systemctl restart scouter-collector
# 또는 scouter-server 서비스 재시작

  1. 테스트

  • Scouter Client에서 인위적으로 임계치를 넘기거나(예: CPU 사용량 경고) 플러그인의 테스트 메시지 기능을 사용하여 Slack 채널에 메시지 도착 확인.

장점: 서버 내부에서 바로 전송되므로 안정적이고 실시간성 보장. 플러그인에 따라 지원되는 이벤트(Agent connect/disconnect, CPU/Memory/Disk 경고 등)가 다름. GitHub

6.3 B. 외부 Webhook(간단) 방식 — Scouter Alert 로그를 스크립트로 감지해 Slack에 POST

  1. Slack Webhook 생성(위 A-4와 동일).

  2. 간단한 bash 스크립트 예시: (/opt/scouter/scripts/notify_slack.sh)

#!/bin/bash
WEBHOOK_URL="https://hooks.slack.com/services/XXXX/XXXX/XXXX"
CHANNEL="#ops-alert"
BOTNAME="ScouterBot"

TEXT="$1"

payload=$(jq -n --arg text "$TEXT" --arg channel "$CHANNEL" --arg username "$BOTNAME" '{text:$text,channel:$channel,username:$username}')
curl -s -X POST -H 'Content-type: application/json' --data "$payload" $WEBHOOK_URL

(주의: jq 설치 필요)

  1. Scouter 알람 로그(또는 server 로그)를 tail -F로 모니터링해서 조건이 만족되면 위 스크립트 호출:

tail -F /opt/scouter/server/logs/server.log | while read LINE; do
  echo "$LINE" | grep "ALERT_PATTERN" && /opt/scouter/scripts/notify_slack.sh "$LINE"
done

  • ALERT_PATTERN 은 로그내 경고 문자열(예: agent disconnected, cpu warning)로 조정.

장점: 구현이 간단하고 플러그인 빌드가 필요 없음. 단점: 로그 파싱 방식이라 이벤트 누락/지연 가능.

7. 모니터링/알람 운영 팁

  • Agent obj_name 규칙화: env-app-idx 형태로 표준화(예: prd-web01, stg-api02) — UI와 알람에서 빠르게 식별 가능. GitHub

  • 네트워크/포트: Collector <-> Agent 통신 포트(기본 UDP/TCP 포트)를 방화벽에서 허용.

  • 로그 보존/디스크: Scouter Server가 저장하는 데이터 양을 고려해 디스크 용량/rotation 정책 수립.

  • 알람 임계치 튜닝: 초기에는 완화된 임계치로 테스트 후 점진 축소. 잦은 오탐(노이즈)은 경보무시 설정이나 재조정 필요.

  • 백업: Scouter의 DB/저장 포맷(파일 기반 여부)을 확인해 정기 백업 설정.

8. 문제 발생 시 확인 포인트 / 디버깅

  • Agent 로그 (/opt/scouter/agent.java/log/) — Agent가 Collector에 접속하는지 확인

  • Collector/Server 로그 (/opt/scouter/server/log/) — 포트 충돌, Plugin load 오류 확인

  • Tomcat 로그(catalina.out) — -javaagent 인자로 scouter.agent.jar 로딩 메시지 확인

  • 방화벽/네트워크: Collector IP/포트로 UDP/TCP 패킷이 전달되는지 체크 (ss, netstat, tcpdump)

  • Plugin 빌드 오류: Maven 버전 확인 및 mvn -v 로 JDK 호환성 확인

9. 빠른 체크리스트(핵심 명령 모음)

  • Java 설치 확인:

java -version

  • Scouter 압축 풀기:

tar xzf scouter-<DATE>.tar.gz -C /opt

  • Tomcat에 -javaagent 추가(예시):

export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/opt/scouter/agent.java/scouter.agent.jar -Dscouter.config=/opt/scouter/agent.java/conf/scouter.conf -Dobj_name=tomcat-myapp-01"

  • Scouter Server 실행(예):

cd /opt/scouter/server
./start-server.sh &

  • 플러그인 빌드/배포:

git clone https://github.com/scouter-contrib/scouter-plugin-server-alert-slack.git
cd scouter-plugin-server-alert-slack
mvn clean package
cp target/*.jar /opt/scouter/server/plugins/
systemctl restart scouter-collector

(참고 문서: Scouter 설치/QuickStart 및 plugin repo). GitHub+2GitHub+2




 

댓글

댓글 쓰기

이 블로그의 인기 게시물

[8/9] 1184회 로또 당첨번호 추천!!

이미지
이번주 로또 추천번호 최근 600회차 이력 분석 후, 통계기반 번호 생성으로 파이썬 개발!!    1. 추천 번호 : [1, 6, 18, 31, 37, 42] 2. 추천 번호 : [8, 13, 15, 19, 31, 33] 3. 추천 번호 : [7, 10, 22, 23, 26, 33] 4. 추천 번호 : [12, 19, 21, 27, 37, 41] 5. 추천 번호 : [6, 16, 17, 27, 36, 43]  
Read more »

[AWS] SCP, OU, Policy 사용하기 !!

이미지
AWS Organization 을 활용하여  다수의  aws 계정 을 효율적으로 관리 하는 방법을 설명합니다. 특히  scp ,  ou , Policy 의 개념과 역할을 소개하며, 이를 통해  중앙 집중식 관리,  접근 제어  단순화,  통합 결제 , 보안 및 감사  등 다양한 장점을 얻을 수 있음을 강조합니다. 기업 환경에서  aws 계정  구조를 조직 구조에 맞게 구성 하는 데 중요한 역할을 하는  AWS Organization 의 활용법을 다루고 있습니다. 1. AWS Organization 개요 AWS Organization은 여러 aws 계정 을 관리하는 서비스이다. 엔터프라이즈급 기업은 AWS Organization을 통해 다수의 계정을 연동하고 ou 를 생성하여 관리한다. 2. 주요 용어 설명 SCP (Service Control Policy) ou 또는 aws 계정 에 적용 가능하다. 하위 ou 에 상속된다. ou 마다 다르게 적용할 수 있다. Permission B ou ndary & Policy IAM 사용자에게 적용된다. scp 와 중첩되어야 정책이 적용된다. OU (Organization Unit) aws 계정 의 그룹 단위이다. 하위 ou 를 가질 수 있어 회사 구조를 반영할 수 있다. 하나의 aws 계정 은 오직 하나의 ou 에 속할 수 있다. 최대 5단계의 계층 구조를 가질 수 있다. Management Acc ou nt ou 를 생성한 계정이다. 다른 aws 계정 을 초대하거나 포함 및 제거할 수 있다. 오직 하나의 마스터 계정만 존재하며 scp 의 영향을 받지 않는다. Acc ou nt ou 에 초대된 aws 계정 들이다. 신규 및 기존 aws 계정 모두 ou 에 초대 가능하다. IAM Users aws 계정 에 속하는 IAM 사용자를 의미한다. Permission b ou ndary와 policy에 영향을 받는...
Read more »

[AWS] AWS Activate 스타트업 $1,000 지원 성공

이미지
https://aws.amazon.com/startups/credits 현재 고환율 시대에 서버 개발자에게 금전적 지원은 매우 중요하며, aws activate는 좋은 기회가 될 수 있습니다. 신청 자격 요건이 크게 까다롭지 않고, 링크드인 계정을 통해 간단하게 신청할 수 있습니다. 이 프로그램은 스타트업의 초기 인프라 비용 부담을 줄여주는 데 도움을 줄 수 있습니다. 2년간 $1000, 1년간 $350의 크레딧을 제공하며, 개발자 모드 변경 및 유효기간 관리가 필요합니다. 1. 💰 AWS 스타트업 지원 혜택 aws는 스타트업에게 1350달러를 지원하는 프로그램을 운영하고 있다 . 현재 환율이 매우 높은 상황에서 지원금을 신청하는 것이 유리하다고 판단된다 . 서버 개발자들은 비용에 민감하게 반응해야 하는 상황임을 강조한다 . 2. 💼 AWS Activate 스타트업 지원 자격요건 자격요건은 크게 까다롭지 않아 대부분의 회사가 지원할 수 있다.  3. 📝 신청 절차 및 필요 정보 신청 과정은 크게 어렵지 않으며, 회사 정보와 개인 정보를 입력하면 완료된다.  신청 시 링크드인 계정이 필요하며, 이를 통해 개인정보를 입력해야 한다.  링크드인 계정은 특별한 정보 없이 간단하게 생성할 수 있으며, 생성 후 프로필 주소를 입력하면 된다.  4. 🚀 AWS Activate 스타트업 지원 소요 시간 지원 신청 후 4일 만에 결과를 받았다는 언급이 있다.  5. 📊 AWS Activate 지원 내용 요약 aws activate는 스타트업에게 유효기간 2년 동안 $1000 지원을 제공하며, 이는 자동으로 적용된다.  $350 지원도 있으며, 유효기간은 1년으로, 개발자 모드에서 직접 변경 가능하고, support plan을 Basic에서 Developer로 전환해야 한다.  유효기간이 만료되거나 지원 금액을 모두 사용한 경우, 추가 요금을 결제해야 하며, 사용하지 않을 경우 베이직 플랜으로 전환해야 한다....
Read more »

[Gemini API] 구글 생성형 AI API 모델별 요금 및 청구 방식!!

💡 1. 요금 체계 요약 구글은 모델별로 Free Tier(무료) 및 Pay‑as‑you‑go(종량 요금제)를 제공합니다. Free Tier는 제한된 토큰 수와 요청 수를 제공하며, 유료 요금을 활성화하려면 Google Cloud Billing 계정을 연결해야 합니다 Google One +8 Google AI for Developers +8 Google Cloud +8 . ▶ 무료 요금제: 일부 모델에 대해 입력/출력 토큰 수가 한정된 무료 사용 허용 ▶ 유료 요금제: 더 많은 사용, 높은 속도 제한, 데이터가 제품 개선에 사용되지 않음 등의 혜택 🧠 2. Gemini 모델별 요금표 (2025년 6월 기준) Gemini 2.5 Flash‑Lite (가장 저렴한 옵션) 입력 토큰 (텍스트·이미지·비디오): $0.10 /백만 토큰 출력 토큰(응답 포함): $0.40 /백만 토큰 컨텍스트 캐싱 비용: $0.025 /백만 토큰, 저장: $1.00 /백만 토큰당 시간당 정확한 활성화일은 2025년 6월 Reddit +5 Google AI for Developers +5 Google Cloud +5 Android Central . Gemini 2.5 Flash (일반) 입력: $0.30/백만 토큰 출력: $2.50/백만 토큰 캐싱: $0.075/백만 토큰, 저장: 비슷하게 시간당 계산 Google AI for Developers Gemini 2.5 Pro (고성능 모델) 입력: $1.25 (200K 토큰 이하) 또는 $2.50 (200K 초과)/백만 토큰 출력: $10 / $15 /백만 토큰 캐싱: $0.31 / $0.625 /백만 토큰, 저장: $4.50/백만 토큰∙시간 apidog +7 Google AI for Developers +7 Google Cloud +7 Google Cloud 📦 모델 요약 비교 모델 입력 비용 출력 비용 캐싱 비용 저장 비용 Gemini 2.5...
Read more »

[8/2] 1183회 로또 당첨번호 추천!!

이미지
  이번주 로또 추천번호 최근 600회차 이력 분석 후, 통계기반 번호 생성으로 파이썬 개발!!    1. 추천 번호 : [1, 3, 5, 11, 17, 26] 2. 추천 번호 : [13, 19, 22, 29, 36, 43] 3. 추천 번호 : [7, 10, 13, 19, 23, 24] 4. 추천 번호 : [1, 7, 12, 20, 28, 36] 5. 추천 번호 : [2, 7, 23, 25, 27, 43]      
Read more »

[Shopizer E‑commerce] Shopizer란?

🚀 Shopizer란? Shopizer는 Java 기반 오픈 소스 e‑commerce 플랫폼 으로, Spring Boot , Drools , Hibernate 등을 활용한 Headless, Microservices 아키텍처 를 지원합니다. 2025년 2분기~3분기 정식 출시 예정인 최신 Shopizer Microservices 플랫폼 버전은 Spring Security 기반 보안 , PostgreSQL/JSONB 지원 , Cloud‑agnostic 배포 를 특징으로 합니다 github.com +13 shopizer.com +13 github.com +13 . 기존의 Shopizer Headless 3.2.7 버전도 GitHub에서 다운로드 가능 sourceforge.net +2 shopizer.com +2 github.com +2 . 📌 최신 버전 정보 (2025년 기준) Headless 및 Legacy 버전 현재 다운로드 가능한 안정 버전은 3.2.7 sourceforge.net +10 shopizer.com +10 mvnrepository.com +10 GitHub 릴리즈 기록: 3.2.5(2022‑12‑30), 3.2.2(2022‑09‑06), 3.2.0(2022‑06‑22) github.com 차세대 Microservices 플랫폼 2025년 Q2–Q3 출시 예정 마이크로서비스 아키텍처, 각 서비스 독립 배포, Spring Security , Cloud Agnostic 지원 mvnrepository.com +8 shopizer.com +8 youtube.com +8 💡 핵심 키워드 정리 Shopizer : Java e‑commerce, 오픈 소스, Headless, Microservices Spring Boot : 백엔드 핵심 프레임워크 Drools : 비즈니스 룰 엔진 Hibernate , JPA : ORM, 데이터베이스 연동 Headless Comm...
Read more »

[Vault] 온프레미스 구축 개요!!

Vault는 HashiCorp에서 개발한 비밀(Secret) 및 자격 증명 관리 시스템 으로, 온프레미스 환경에서도 안전하게 구축할 수 있습니다. 이 문서에서는 Vault 서버의 온프레미스 구축 방법 과 권장 아키텍처 를 보안, 가용성, 확장성을 고려하여 구체적으로 설명합니다. 1. Vault 온프레미스 구축 개요 Vault는 민감한 데이터(예: API 키, 데이터베이스 자격증명, 인증 토큰)를 저장하고 제어된 방식으로 접근하게 해주는 솔루션입니다. 온프레미스 구축은 데이터 주권 이나 보안 규제 가 중요한 기업 환경에 적합합니다. 2. Vault 온프레미스 설치 사전 준비 2.1 요구사항 운영체제 : Linux (Ubuntu, CentOS, RHEL 등) 메모리/CPU : 최소 2 vCPU, 4GB RAM 디스크 용량 : 최소 10GB (스토리지 백엔드에 따라 다름) 네트워크 포트 : 기본 HTTP 8200, 클러스터 통신 8201 2.2 주요 구성 요소 Vault 서버 바이너리 스토리지 백엔드 (Consul, Raft, etcd 등) TLS 인증서 systemd 또는 Supervisor 로 서비스 등록 3. Vault 온프레미스 설치 및 설정 3.1 Vault 설치 bash # 1. 바이너리 다운로드 wget https://releases.hashicorp.com/vault/1.16.1/vault_1.16.1_linux_amd64.zip # 2. 압축 해제 및 설치 unzip vault_1.16.1_linux_amd64.zip sudo mv vault /usr/local/bin/ # 3. 버전 확인 vault --version 3.2 스토리지 백엔드 구성 옵션 1: Consul (권장) Consul을 함께 설치한 후 Vault 설정 파일에 아래처럼 지정합니다. hcl storage "consul" { address = "127.0.0.1:85...
Read more »