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

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

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

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

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

1. 1대시보드에서 설정 → 서버 관리 → 서버 추가를 누르고 서버 이름을 입력하면 설치 명령어가 자동 생성됩니다. 명령어 위의 Linux / Windows 탭 중 서버 OS에 맞는 쪽을 골라 복사합니다.
2. 2모니터링할 서버에 접속(Linux는 SSH, Windows는 원격 데스크톱)한 뒤 복사한 명령어를 붙여넣고 실행합니다. Windows는 반드시 관리자 PowerShell에서 실행하세요.
3. 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 을 붙이면 서비스와 설치 폴더가 삭제됩니다.

3. 대시보드 보는 법

데이터베이스 심층 모니터링 (선택)

DB(MySQL·PostgreSQL 등)는 기본적으로 가용성·응답이 모니터링됩니다. 연결 수·처리량·용량 같은 심층 지표까지 보려면, DB에 접속해 상태만 읽는 읽기 전용 모니터링 계정을 만들어 등록합니다(고객사에서 직접 생성하는 영역).

MySQL / MariaDB — 읽기 전용 계정

CREATE USER 'sentibel'@'%' IDENTIFIED BY '강력한_비밀번호';
GRANT PROCESS, REPLICATION CLIENT ON *.* TO 'sentibel'@'%';
FLUSH PRIVILEGES;

접속 범위를 좁히려면 '%' 대신 에이전트 서버의 IP를 지정하세요(같은 서버면 'localhost').

PostgreSQL — 읽기 전용 계정

CREATE ROLE sentibel WITH LOGIN PASSWORD '강력한_비밀번호';
GRANT pg_monitor TO sentibel;   -- PostgreSQL 10 이상

agent.yaml 에 등록

/etc/sentibel/agent.yaml 의 collectors.middleware.db 아래에 대상 DB를 추가하고 에이전트를 재시작하면, 30초~1분 내 미들웨어 계층에 DB 카드가 나타나고 연결 수·용량 지표가 갱신됩니다.

collectors:
  middleware:
    enabled: true
    db:
      # type: mysql · mariadb · postgresql
      - type: mysql
        host: 127.0.0.1
        port: 3306
        name: main-db
        user: sentibel
        password: "강력한_비밀번호"
        database: ""

sudo systemctl restart sentibel-agent

4. 알림 채널 설정

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

5. 팀원 초대

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

6. 요금제 업그레이드

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

모든 가격은 VAT 별도입니다. 결제 시 부가세 10%가 더해집니다.

문제 해결 (트러블슈팅)

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

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

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

톰캣(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

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

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

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

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

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