고객 사용 가이드 — 설치부터 알림까지 5분

최종 업데이트: 2026-06-27

PDF 다운로드

설치부터 알림 설정까지, 5분이면 서버 모니터링이 시작됩니다. 회원가입 → 에이전트 설치 → 대시보드·알림 순서로 안내합니다.

1. 회원가입 및 워크스페이스 생성

1sentibel.com 에 접속해 무료로 시작하기를 클릭합니다.
2이메일과 비밀번호를 입력하고 회원가입합니다.
3가입 후 이메일로 발송된 인증 메일의 링크를 클릭합니다.
4로그인하면 워크스페이스가 자동 생성되고 14일 무료체험이 시작됩니다. 체험 기간에는 전체 기능을 제한 없이 사용할 수 있습니다.

2. 에이전트 설치 (서버에 한 번만)

1대시보드에서 설정 → 서버 관리 → 서버 추가를 누르고 서버 이름을 입력하면 설치 명령어가 자동 생성됩니다. 명령어 위의 Linux / Windows 탭 중 서버 OS에 맞는 쪽을 골라 복사합니다.
2모니터링할 서버에 접속(Linux는 SSH, Windows는 원격 데스크톱)한 뒤 복사한 명령어를 붙여넣고 실행합니다. Windows는 반드시 관리자 PowerShell에서 실행하세요.
3설치가 완료되면 1~2분 내에 대시보드에 데이터가 표시됩니다.

curl -sSL https://sentibel.com/install.sh | sudo bash -s -- \
  --api-key <API_KEY> --server <SERVER_URL> --agent-id <AGENT_ID>

Windows Server 설치 (PowerShell)

Windows Server 2016/2019/2022 에서 동작합니다. 설정 → 서버 관리 → 서버 추가에서 Windows 탭을 선택하면 아래 형태의 명령이 자동 생성됩니다. 복사해 관리자 권한 PowerShell(시작 버튼 우클릭 → Windows PowerShell(관리자))에 붙여넣고 실행하세요.

Set-ExecutionPolicy Bypass -Scope Process -Force
iwr https://sentibel.com/install.ps1 -OutFile $env:TEMP\sentibel.ps1
& $env:TEMP\sentibel.ps1 -ApiKey <API_KEY>

설치가 끝나면 에이전트가 SentibelAgent 라는 Windows 서비스로 등록돼 컴퓨터를 켤 때마다 자동 시작됩니다. CPU·메모리·디스크·네트워크·보안과 Tomcat 같은 WAS를 자동 수집합니다.

최신 버전 업데이트: 위 명령에서 -ApiKey <API_KEY> 부분만 빼고 다시 실행하면 됩니다(설정 보존). 제거: 명령 끝에 -Uninstall 을 붙이면 서비스와 설치 폴더가 삭제됩니다.

서버마다 별도의 명령어가 생성됩니다. 서버 10대를 모니터링하려면 각 서버에서 각각의 명령어를 실행하세요.

3. 대시보드 보는 법

7계층 모니터링

OS·네트워크·미들웨어·애플리케이션·보안·Kubernetes·GPU를 한 화면에서. 각 계층 카드를 클릭하면 상세 지표를 봅니다.

실시간 메트릭

CPU·메모리·디스크 사용률이 실시간 갱신됩니다. 임계값 초과 시 자동으로 알림이 발송됩니다.

알림 심각도

긴급 즉시 조치 필요 / 경고 성능 저하 주의 / 정보 참고 사항.

AI 근본 원인 분석

알림 발생 시 AI가 계층 간 인과관계를 분석해 원인과 즉시 실행 가능한 조치 명령어를 제시합니다.

4. 알림 채널 설정

설정 → 알림 채널에서 장애 발생 시 알림 받을 채널을 등록합니다. 여러 채널을 동시에 쓸 수 있습니다.

Slack

Slack 앱 연동(OAuth)

카카오톡 알림톡

수신 전화번호 입력

이메일

수신 이메일 입력

Webhook

사내 시스템 연동 URL

5. 팀원 초대

1설정 → 팀에서 팀원 이메일을 입력하고 역할을 선택해 초대합니다.
2초대받은 팀원에게 이메일이 발송됩니다. 링크를 클릭하면 가입 후 바로 워크스페이스에 합류합니다.

Owner

전체 권한. 결제·팀원관리·서버·알림 모두 가능.

Admin

결제 제외 전체 권한. 서버 추가·알림 설정 가능.

Viewer

대시보드·알림 조회만 가능. 설정 변경 불가.

6. 요금제 업그레이드

14일 무료체험 종료 후 설정 → 요금제에서 플랜을 선택합니다. 카드 등록만으로 자동 결제되며, 언제든지 해지 가능합니다.

Starter · 월 7만원

서버 5대 · 팀원 5명

Growth · 월 29만원

서버 20대 · 팀원 20명

Scale · 월 59만원

서버 무제한 · 팀원 무제한

서버 대수가 플랜 한도에 가까워지면 미리 업그레이드하는 것을 권장합니다.

문제 해결 (트러블슈팅)

설치했는데 대시보드에 안 보이거나 "연결 끊김"으로 표시돼요

에이전트는 서버에서 바깥으로 나가는 HTTPS(아웃바운드 TCP 443) 연결만 사용합니다. 들어오는 포트(인바운드)는 열 필요가 없습니다. 사내 방화벽이 있다면 아래 두 대상으로의 아웃바운드 443을 허용하세요.

① 메트릭 전송용

sentibel.com → TCP 443(HTTPS) 아웃바운드 허용

② 설치·업데이트 다운로드용

sentibel-downloads-446503125520.s3.ap-northeast-2.amazonaws.com → TCP 443 아웃바운드 허용

sudo systemctl status sentibel-agent   # 서비스 실행 확인
sudo journalctl -u sentibel-agent -f   # 실시간 로그(오류 확인)
curl -sS https://sentibel.com/health   # 정상 응답이면 방화벽 OK

"데이터 수신 중" → "연결 끊김"은 마지막 데이터 수신 후 약 3분이 지나면 표시됩니다(순간적인 끊김을 거르는 정상 유예입니다).

톰캣(WAS)이 모니터링되지 않아요

에이전트가 catalina 프로세스를 찾아 실제 동작 포트를 자동 탐지합니다. 톰캣을 root로 실행하는 등 자동 탐지가 어려운 환경에서는, /etc/sentibel/agent.yaml 에 포트를 직접 지정한 뒤 재시작하세요.

sudo nano /etc/sentibel/agent.yaml
# collectors.middleware.was 아래에 추가:
#   was:
#     - type: tomcat
#       port: 8080      # 톰캣이 실제 듣는 포트
#       name: my-tomcat
sudo systemctl restart sentibel-agent

업데이트(--update)는 기존 설정을 보존하므로, 이미 설치된 서버는 위 파일을 직접 편집해야 합니다.

애플리케이션 URL(엔드포인트)을 추가/삭제했는데 반영이 안 돼요

설정 → 서버 관리의 🌐 아이콘에서 URL을 추가하거나 제거한 뒤, 반드시 "저장" 버튼을 눌러야 반영됩니다(목록에서 빼기만 하면 저장되지 않습니다). 저장 후 에이전트에 적용되기까지 약 30초~1분 걸립니다.

웹 화면에서 서버를 지웠는데 에이전트가 계속 실행돼요

설정 → 서버 관리의 🗑(삭제)는 웹 대시보드의 서버 목록·기록만 지웁니다. 그 서버에서 에이전트 프로그램 자체도 제거하려면 해당 서버에 접속해 아래를 실행하세요.

curl -sSL https://sentibel.com/install.sh | sudo bash -s -- --uninstall

위로 해결되지 않으면 journalctl -u sentibel-agent -f 로그와 함께 business.app0826@gmail.com 으로 문의해 주세요.

Sentibel로 5분 만에 시작하세요

7계층을 한 번에 모니터링하고 장애의 근본 원인까지 추적합니다. 14일 무료로 시작하세요.

무료로 시작하기