ServiceWatch Agent 설치하기

사용자는 Virtual Server에 ServiceWatch Agent를 설치하여 사용자 정의 지표와 로그를 수집할 수 있습니다.

ServiceWatch Agent

Virtual Server에 ServiceWatch의 사용자 정의 지표 및 로그 수집을 위해 설치해야 하는 Agent는 크게 2가지로 나눌 수 있습니다. Prometheus Exporter와 Open Telemetry Collector 입니다.

Virtual Server를 위한 Prometheus Exporter 설치 (for Linux)

Linux 서버에서 사용하기 위해 Prometheus Exporter를 아래의 순서에 따라 설치합니다.

Node Exporter 설치

아래의 순서에 따라 Node Exporter를 설치합니다.

1. Node Exporter User 생성
2. Node Exporter 설정

Node Exporter User 생성

Node Exporter 프로세스를 안전하게 격리하기 위한 전용 사용자를 생성합니다.

sudo useradd --no-create-home --shell /bin/false node_exporter

sudo useradd --no-create-home --shell /bin/false node_exporter

Node Exporter 설정

1. Node Exporter 설치를 위해 다운로드합니다. 해당 가이드에서는 아래 버전으로 안내합니다.
   • 다운로드 경로: /tmp
   • 설치 버전: 1.7.0
     Sample Code Download

     Copy Code

     배경색 변경

     cd /tmp
     wget https://github.com/prometheus/node_exporter/releases/download/v1.7.0/node_exporter-1.7.0.linux-amd64.tar.gz

     cd /tmp
     wget https://github.com/prometheus/node_exporter/releases/download/v1.7.0/node_exporter-1.7.0.linux-amd64.tar.gz

2. 다운로드 받은 Node Exporter 설치하고 실행 파일에 권한을 부여합니다.

   Sample Code Download

   Copy Code

   배경색 변경

   cd /tmp
   sudo tar -xvf node_exporter-1.7.0.linux-amd64.tar.gz -C /usr/local/bin --strip-components=1 node_exporter-1.7.0.linux-amd64/node_exporter

   cd /tmp
   sudo tar -xvf node_exporter-1.7.0.linux-amd64.tar.gz -C /usr/local/bin --strip-components=1 node_exporter-1.7.0.linux-amd64/node_exporter

   Sample Code Download

   Copy Code

   배경색 변경

   sudo chown node_exporter:node_exporter /usr/local/bin/node_exporter

   sudo chown node_exporter:node_exporter /usr/local/bin/node_exporter

3. 서비스 파일 생성 Node Exporter를 메모리 메트릭(meminfo) 또는 블록 스토리지 메트릭(filesystem) 수집하도록 설정합니다.

   Sample Code Download

   Copy Code

   배경색 변경

   sudo vi /etc/systemd/system/node_exporter.service

   sudo vi /etc/systemd/system/node_exporter.service

   Sample Code Download

   Copy Code

   배경색 변경

   [Unit]
   Description=Prometheus Node Exporter (meminfo only)
   Wants=network-online.target
   After=network-online.target
    
   [Service]
   User=node_exporter
   Group=node_exporter
   Type=simple
   ExecStart=/usr/local/bin/node_exporter \
     --collector.disable-defaults \    # 기본 제공 메트릭 비활성화
     --collector.meminfo \             # 메모리 메트릭 활성화
     --collector.filesystem            # Block Storage 파일 시스템 메트릭 활성화
    
   Restart=on-failure
    
   [Install]
   WantedBy=multi-user.target

   [Unit]
   Description=Prometheus Node Exporter (meminfo only)
   Wants=network-online.target
   After=network-online.target
    
   [Service]
   User=node_exporter
   Group=node_exporter
   Type=simple
   ExecStart=/usr/local/bin/node_exporter \
     --collector.disable-defaults \    # 기본 제공 메트릭 비활성화
     --collector.meminfo \             # 메모리 메트릭 활성화
     --collector.filesystem            # Block Storage 파일 시스템 메트릭 활성화
    
   Restart=on-failure
    
   [Install]
   WantedBy=multi-user.target

4. 서비스 활성화 및 시작 Node Exporter 서비스를 등록하고 등록된 서비스와 설정한 메트릭을 확인합니다.
   Sample Code Download

   Copy Code

   배경색 변경

   sudo systemctl daemon-reload
   sudo systemctl enable --now node_exporter

   sudo systemctl daemon-reload
   sudo systemctl enable --now node_exporter

   Sample Code Download

   Copy Code

   배경색 변경

   sudo systemctl status node_exporter

   sudo systemctl status node_exporter

   Sample Code Download

   Copy Code

   배경색 변경

   curl http://localhost:9100/metrics | grep node_memory

   curl http://localhost:9100/metrics | grep node_memory

Virtual Server를 위한 Prometheus Exporter 설치 (for Windows)

Windows 서버에서 Prometheus Exporter를 사용하기 위해 아래의 순서에 따라 설치합니다.

Windows Exporter 설치

아래의 순서에 따라 Windows Exporter를 설치합니다.

1. Windows Exporter 설정

Windows Exporter 설정

1. Windows Exporter 설치를 위해 설치 파일을 다운로드합니다.
   • 다운로드 경로: C:\Temp
   • 테스트 버전: 0.31.3
     Sample Code Download

     Copy Code

     배경색 변경

     $ mkdir /Temp
     $ Invoke-WebRequest -Uri "https://github.com/prometheus-community/windows_exporter/releases/download/v0.31.3/windows_exporter-0.31.3-amd64.exe" -OutFile "C:\Temp\windows_exporter-0.31.3-amd64.exe"

     $ mkdir /Temp
     $ Invoke-WebRequest -Uri "https://github.com/prometheus-community/windows_exporter/releases/download/v0.31.3/windows_exporter-0.31.3-amd64.exe" -OutFile "C:\Temp\windows_exporter-0.31.3-amd64.exe"

2. Windows Exporter 실행 테스트
   Windows Exporter는 기본적으로 모든 컬렉터를 활성화하지만, 원하는 메트릭만 수집하려면 다음 컬렉터를 활성화해야 합니다. 다음은 사용자가 지정한 컬렉터를 활성화하는 예제입니다.
   • 메모리 메트릭: memory
   • 블록 스토리지 메트릭: local_disk
   • Host name: os
     Sample Code Download

     Copy Code

     배경색 변경

     $ cd C:\Temp
     $ .\windows_exporter-0.31.3-amd64.exe --collectors.enabled memory,logical_disk,os

     $ cd C:\Temp
     $ .\windows_exporter-0.31.3-amd64.exe --collectors.enabled memory,logical_disk,os

3. 서비스 등록 및 확인 Windows Exporter의 서비스를 등록하고 설정한 메트릭을 확인합니다.

   Sample Code Download

   Copy Code

   배경색 변경

   $ sc.exe create windows_exporter binPath= "C:\Temp\windows_exporter-0.31.3-amd64.exe --collectors.enabled memory,logical_disk,os" DisplayName= "Prometheus Windows Exporter" start= auto
   $ Start-Service windows_exporter

   $ sc.exe create windows_exporter binPath= "C:\Temp\windows_exporter-0.31.3-amd64.exe --collectors.enabled memory,logical_disk,os" DisplayName= "Prometheus Windows Exporter" start= auto
   $ Start-Service windows_exporter

   Sample Code Download

   Copy Code

   배경색 변경

   # 서비스 확인
   $ Get-Service windows_exporter
    
   # 메트릭 확인
   $ Invoke-WebRequest -Uri "http://localhost:9182/metrics" | Select-String memory

   # 서비스 확인
   $ Get-Service windows_exporter
    
   # 메트릭 확인
   $ Invoke-WebRequest -Uri "http://localhost:9182/metrics" | Select-String memory

4. 구성 파일 설정

   • –config.file 옵션을 사용하여 YAML 구성 파일을 사용하도록 설정할 수 있습니다.
     Sample Code Download

     Copy Code

     배경색 변경

     $ .\windows_exporter.exe --config.file=config.yml 
     $ .\windows_exporter.exe --config.file="C:\Program Files\windows_exporter\config.yml" # 절대 경로를 사용하는 경우 경로를 따옴표로 묶어야 합니다. 

     $ .\windows_exporter.exe --config.file=config.yml 
     $ .\windows_exporter.exe --config.file="C:\Program Files\windows_exporter\config.yml" # 절대 경로를 사용하는 경우 경로를 따옴표로 묶어야 합니다. 

     Sample Code Download

     Copy Code

     배경색 변경

     collectors:
       enabled: cpu,net,service
     collector:
       service:
         include: windows_exporter
     log:
       level: warn

     collectors:
       enabled: cpu,net,service
     collector:
       service:
         include: windows_exporter
     log:
       level: warn

   • Windows Exporter > 구성 파일 공식 예시 파일을 참고하세요.
     Sample Code Download

     Copy Code

     배경색 변경

     ---
     # Note this is not an exhaustive list of all configuration values
     collectors:
       enabled: cpu,logical_disk,net,os,service,system
     collector:
       service:
         include: "windows_exporter"
       scheduled_task:
         include: /Microsoft/.+
     log:
       level: debug
     scrape:
       timeout-margin: 0.5
     telemetry:
       path: /metrics
     web:
       listen-address: ":9182"

     ---
     # Note this is not an exhaustive list of all configuration values
     collectors:
       enabled: cpu,logical_disk,net,os,service,system
     collector:
       service:
         include: "windows_exporter"
       scheduled_task:
         include: /Microsoft/.+
     log:
       level: debug
     scrape:
       timeout-margin: 0.5
     telemetry:
       path: /metrics
     web:
       listen-address: ":9182"

   • 구성 파일을 이용하여 서비스 등록하기 위해서 아래를 참고하세요.
     Sample Code Download

     Copy Code

     배경색 변경

     $ sc.exe create windows_exporter binPath= "C:\Temp\windows_exporter-0.31.3-amd64.exe --config.file=C:\Temp\config.yml" DisplayName= "Prometheus Windows Exporter" start= auto
     $ Start-Service windows_exporter

     $ sc.exe create windows_exporter binPath= "C:\Temp\windows_exporter-0.31.3-amd64.exe --config.file=C:\Temp\config.yml" DisplayName= "Prometheus Windows Exporter" start= auto
     $ Start-Service windows_exporter

Node Exporter 지표

Node Exporter 주요 지표

아래는 Node Exporter를 통해 확인할 수 있는 Collector와 지표 정보입니다. Collector로 설정할 수도 있고, 특정 지표만 활성화할 수 있습니다.

Node Exporter Collector 및 지표 수집 설정

Node Exporter는 기본적으로 대부분의 collector가 활성화되지만, 원하는 collector만 활성화/비활성화 설정할할 수 있습니다.

특정 Collector만 활성화

• 메모리, 파일 시스템 Collector만 사용하고 싶을 때:
  Sample Code Download

  Copy Code

  배경색 변경

  ./node_exporter
    --collector.meminfo            # 메모리 Collector 활성화
    --collector.filesystem         # 파일 시스템 Collector 활성화

  ./node_exporter
    --collector.meminfo            # 메모리 Collector 활성화
    --collector.filesystem         # 파일 시스템 Collector 활성화

• Default 설정은 모두 해제하고 메모리, 파일 시스템 Collector만 사용하고 싶을 때:
  Sample Code Download

  Copy Code

  배경색 변경

  ./node_exporter
    --collector.disable-defaults    # 기본 제공 메트릭 비활성화
    --collector.meminfo             # 메모리 Collector 활성화
    --collector.filesystem          # 파일 시스템 Collector 활성화

  ./node_exporter
    --collector.disable-defaults    # 기본 제공 메트릭 비활성화
    --collector.meminfo             # 메모리 Collector 활성화
    --collector.filesystem          # 파일 시스템 Collector 활성화

• 특정 마운트 지점에 대한 파일 시스템 Collector 활성화
  Sample Code Download

  Copy Code

  배경색 변경

  ./node_exporter
    --collector.disable-defaults    # 기본 제공 메트릭 비활성화
    --collector.filesystem.mount-points-include="/|/data"          # /(Root)와 /data 마운트 지점에 대한 파일 시스템 Collector 활성화

  ./node_exporter
    --collector.disable-defaults    # 기본 제공 메트릭 비활성화
    --collector.filesystem.mount-points-include="/|/data"          # /(Root)와 /data 마운트 지점에 대한 파일 시스템 Collector 활성화

• 특정 마운트 지점을 제외한 파일 시스템 Collector 활성화
  Sample Code Download

  Copy Code

  배경색 변경

  ./node_exporter
    --collector.disable-defaults    # 기본 제공 메트릭 비활성화
    --collector.filesystem.mount-points-exclude="/boot|/var/log"    # /boot와 /var/log 마운트 지점에 대한 파일 시스템 Collector 활성화

  ./node_exporter
    --collector.disable-defaults    # 기본 제공 메트릭 비활성화
    --collector.filesystem.mount-points-exclude="/boot|/var/log"    # /boot와 /var/log 마운트 지점에 대한 파일 시스템 Collector 활성화

특정 Collector 비활성화 (no-collector)

파일 시스템 collector를 사용하고 싶지 않을때:

./node_exporter --no-collector.filesystem

./node_exporter --no-collector.filesystem

Systemd 서비스로 Collector 구성 (권장)

[Unit]
Description=Node Exporter
After=network-online.target

[Service]
User=nodeexp
ExecStart=/usr/local/bin/node_exporter
  --collector.disable-defaults # 기본 제공 메트릭 collector 모두 비활성화
  --collector.meminfo
  --collector.filesystem

[Install]
WantedBy=multi-user.target

[Unit]
Description=Node Exporter
After=network-online.target

[Service]
User=nodeexp
ExecStart=/usr/local/bin/node_exporter
  --collector.disable-defaults # 기본 제공 메트릭 collector 모두 비활성화
  --collector.meminfo
  --collector.filesystem

[Install]
WantedBy=multi-user.target

특정 지표만 필터링하는 방법

Open Telemetry Collector 설정을 통해서 Node Exporter로부터 수집한 지표 중 필요한 것만 선택해서 수집하도록 설정할 수 있습니다. Node Exporter의 특정 Collector에서 제공하는 지표 중에 특정 지표만 수집하고자 할 때, ServiceWatch를 위한 Open Telemetry Collector 사전 설정을 참고할 수 있습니다.

Windows Exporter 지표

Windows Exporter 주요 지표

아래는 Windows Exporter를 통해 확인할 수 있는 Collector와 지표 정보입니다. Collector로 설정할 수도 있고, 특정 지표만 활성화할 수 있습니다.

Windows Exporter Collector 및 지표 수집 설정

Windows Exporter는 기본적으로 대부분의 collector가 활성화되지만, 원하는 collector만 설정할할 수 있습니다.

특정 Collector만 활성화

CPU, 메모리, 논리 디스크만 사용하고 싶을 때:

# --collector.enabled 옵션은 기본값을 비활성화하고, 표기한 Collector만 활성화
.\windows_exporter.exe --collectors.enabled="memory,logical_disk" 

# --collector.enabled 옵션은 기본값을 비활성화하고, 표기한 Collector만 활성화
.\windows_exporter.exe --collectors.enabled="memory,logical_disk" 

서비스로 Collector 구성 (권장)

# windows_exporter 를 서비스로 등록
sc.exe create windows_exporter binPath= "C:\Temp\windows_exporter-0.31.3-amd64.exe --config.file=C:\Temp\config.yml" DisplayName= "Prometheus Windows Exporter" start= auto
# 서비스 시작
Start-Service windows_exporter

# windows_exporter 를 서비스로 등록
sc.exe create windows_exporter binPath= "C:\Temp\windows_exporter-0.31.3-amd64.exe --config.file=C:\Temp\config.yml" DisplayName= "Prometheus Windows Exporter" start= auto
# 서비스 시작
Start-Service windows_exporter

# Note this is not an exhaustive list of all configuration values
collectors:
  enabled: logical_disk,memory # 활성화할 collector 설정
collector:
  service:
    include: "windows_exporter"
  scheduled_task:
    include: /Microsoft/.+
log:
  level: debug
scrape:
  timeout-margin: 0.5
telemetry:
  path: /metrics
web:
  listen-address: ":9182"

# Note this is not an exhaustive list of all configuration values
collectors:
  enabled: logical_disk,memory # 활성화할 collector 설정
collector:
  service:
    include: "windows_exporter"
  scheduled_task:
    include: /Microsoft/.+
log:
  level: debug
scrape:
  timeout-margin: 0.5
telemetry:
  path: /metrics
web:
  listen-address: ":9182"

특정 지표만 필터링하는 방법

Open Telemetry Collector 설정을 통해서 Windows Exporter로부터 수집한 지표 중 필요한 것만 선택해서 수집하도록 설정할 수 있습니다. Windows Exporter의 특정 Collector에서 제공하는 지표 중에 특정 지표만 수집하고자 할 때, ServiceWatch를 위한 Open Telemetry Collector 사전 설정을 참고할 수 있습니다.