Debian 12에 Prometheus 및 Node Exporter 설치하는 방법

Prometheus는 오픈 소스 모니터링 및 경고 플랫폼입니다. 원래 Prometheus는 2012년 Soundcloud에 의해 만들어졌습니다. 그 이후로 Prometheus 프로젝트는 유명한 몇몇 회사에 의해 채택되어 매우 활발한 개발자와 커뮤니티가 있는 더 큰 프로젝트가 되었습니다. 2016년, Prometheus 프로젝트는 Cloud Native Computing Foundation (CNCF) 아래에서 졸업했습니다.

이 가이드는 Debian 12 서버에 Prometheus 및 Node Exporter를 설치하는 방법을 보여줍니다.

전제 조건

시작하려면 다음 사항을 확인하십시오:

Debian 12 서버.
sudo 관리자 권한이 있는 비루트 사용자.

알아야 할 기본 개념

기본적으로 Prometheus는 대상 서버의 HTTP 엔드포인트를 통해 데이터와 메트릭을 수집한 다음 모든 데이터를 시계열로 저장합니다. Prometheus에서 시계열 데이터는 메트릭 이름과 키/값 쌍으로 식별됩니다.

Prometheus는 Prometheus Query Language (PromQL)를 통해 유연성을 제공합니다. PromQL을 사용하여 Prometheus 시계열 데이터베이스를 쿼리할 수 있습니다.

대상 서버에서는 모든 데이터와 메트릭을 Prometheus에 노출하는 ‘exporter’ 애플리케이션을 설치해야 합니다. ‘Node Exporter’는 Linux 머신을 모니터링하기 위해 일반적으로 사용되는 exporter입니다.

Node Exporter는 Linux 머신의 하드웨어 및 커널 관련 메트릭을 노출합니다. 이는 Prometheus 서버에 데이터와 메트릭을 노출하는 단일 바이너리 파일로 제공됩니다.

Prometheus 및 Node Exporter 설치하기

Prometheus는 시스템 메트릭을 수집하기 위한 오픈 소스 모니터링 시스템입니다. Prometheus는 시스템 메트릭을 수집하기 위해 exporter를 사용하며, Node Exporter는 시스템 메트릭을 수집할 수 있게 해줍니다.

최신 Debian 버전에서는 Prometheus와 Node Exporter가 모두 저장소에 있으며 APT 패키지 관리자를 사용하여 설치할 수 있습니다.

먼저, 다음 명령을 실행하여 Debian 패키지 인덱스를 업데이트하고 새로 고칩니다.

sudo apt update

update repo

이제 아래의 apt 명령을 통해 Prometheus와 Node Exporter를 설치합니다. Debian 저장소는 Prometheus 2.42.0과 Node Exporter 1.5.0을 제공합니다.

sudo apt install prometheus prometheus-node-exporter

설치를 진행하려면 Y를 입력하십시오.

install prometheus and node exporter

설치가 완료되면 Prometheus와 Node Exporter는 systemd 서비스로 실행되며 자동으로 활성화됩니다. Prometheus는 prometheus 서비스를 가지며, Node Exporter는 prometheus-node-exporter 서비스를 가집니다.

다음 명령을 사용하여 prometheus 서비스를 확인하십시오.

sudo systemctl is-enabled prometheus  
sudo systemctl status prometheus

아래에 표시된 출력은 prometheus 서비스가 실행 중이며 활성화되어 있음을 나타냅니다. 기본적으로 9090 포트에서 실행되고 있습니다.

verify prometheus service

이제 다음 명령을 실행하여 prometheus-node-exporter 서비스를 확인하십시오.

sudo systemctl is-enabled prometheus-node-exporter  
sudo systemctl status prometheus-node-exporter

표시된 출력은 prometheus-node-exporter 서비스가 실행 중이며 활성화되어 있음을 나타냅니다. Node Exporter의 기본 포트는 9100입니다.

verify node exporter service

다음으로, 아래의 prometheus 명령을 실행하여 Prometheus 버전을 확인하십시오.

prometheus --version

그런 다음, promtool의 바이너리 경로와 버전을 다음과 같이 확인하십시오. promtool은 Prometheus 모니터링 시스템을 관리하기 위한 명령줄 도구입니다.

which promtool  
promtool --version

표시된 출력에 따르면 Prometheus와 promtool 2.42.0이 설치되어 있습니다.

check prometheus and promtool

마지막으로, 다음 명령을 사용하여 Node Exporter 바이너리 경로 prometheus-node-exporter와 그 버전을 확인하십시오.

which prometheus-node-exporter  
prometheus-node-exporter --version

아래에 표시된 출력은 Node Exporter 1.5가 설치되어 있음을 확인합니다.

check node exporter version

Prometheus 구성하기

Prometheus와 Node Exporter를 설치한 후, 다음 단계는 기본 구성 파일 prometheus.yml을 편집하여 Prometheus를 구성하는 것입니다. 이 파일은 prometheus 구성 디렉토리 /etc/prometheus에 위치해 있습니다.

다음 nano 편집기 명령을 사용하여 기본 Prometheus 구성 /etc/prometheus/prometheus.yml을 엽니다.

sudo nano /etc/prometheus/prometheus.yml

scrape_configs 섹션 내에, 대상 엔드포인트 192.168.10.15:9090와 함께 새로운 작업 prometheus를 추가합니다. 이는 Prometheus 서버 자체입니다.

# A scrape configuration containing exactly one endpoint to scrape:  
# Here it's Prometheus itself.  
scrape_configs:  
  # The job name is added as a label `job=` to any timeseries scraped from this config.  
  - job_name: "prometheus"  
   
    # metrics_path defaults to '/metrics'  
    # scheme defaults to 'http'.  
  
    static_configs:  
      - targets: ["192.168.10.15:9090"]

파일을 저장하고 편집기를 종료하십시오.

이제 아래의 systemctl 명령을 실행하여 prometheus 서비스를 재시작하고 변경 사항을 적용하십시오.

sudo systemctl restart prometheus

이제 웹 브라우저를 열고 http://192.168.10.15:9090와 같은 Prometheus 설치를 방문하십시오. 모든 것이 제대로 작동하면 다음 명령에서 Prometheus 대시보드를 볼 수 있어야 합니다.

prometheus dashboard

메뉴 Status > Targets를 클릭하여 대상 모니터링 시스템의 엔드포인트 목록을 가져옵니다. prometheus 엔드포인트가 상태 Up으로 표시되어야 합니다.

target endpoints

마지막으로, http://192.168.10.15:9090/metrics와 같은 경로 URL을 방문하여 Prometheus 메트릭을 확인할 수 있습니다. Prometheus에 의해 생성된 유사한 메트릭 데이터를 볼 수 있어야 합니다.

metrics prometheus

Node Exporter를 Prometheus에 추가하기

이제 Prometheus를 구성했으므로 다음 단계는 Node Exporter를 Prometheus 설치에 추가하는 것입니다. Node Exporter는 서버에서 메트릭을 수집합니다. 이를 달성하기 위해 다음을 완료해야 합니다:

Node Exporter 상태 확인: 이는 Node Exporter가 오류 없이 실행되고 있는지 확인합니다.
Prometheus에 새로운 작업 추가: 이는 Prometheus에 대상 모니터링 시스템을 추가하는 방법을 보여줍니다.

이제 시작해 보겠습니다.

Node Exporter 상태 확인하기

Node Exporter를 Prometheus에 추가하기 전에 Node Exporter가 오류 없이 실행되고 있는지 확인해야 합니다. 이는 prometheus-node-exporter 서비스 상태를 확인하고, Node Exporter가 사용하는 포트 9100을 확인하며, 브라우저에서 Node Exporter 메트릭에 접근하여 확인할 수 있습니다.

다음 명령을 실행하여 prometheus-node-exporter 서비스 상태를 확인하십시오.

sudo systemctl status prometheus-node-exporter

실행 중이라면 prometheus-node-exporter 서비스 상태는 다음과 같아야 합니다:

node exporter service

이제 아래 명령을 실행하여 Node Exporter가 사용하는 포트 9100이 LISTEN 상태인지 확인하십시오.

ss -tulpn | grep 9100

다음 출력은 Node Exporter가 포트 9100을 사용하고 있음을 확인합니다.

마지막으로, 웹 브라우저를 열고 http://192.168.10.15:9100/metrics와 같은 Node Exporter 메트릭 URL을 방문하십시오. 다음과 같이 Node Exporter에 의해 생성된 메트릭을 볼 수 있어야 합니다:

node exporter metrics

Prometheus에 새로운 작업 추가하기

이제 Node Exporter가 실행 중이므로 Node Exporter를 Prometheus에 추가할 준비가 되었습니다.

다음 nano 편집기 명령을 사용하여 Prometheus 구성 /etc/prometheus/prometheus.yml을 엽니다.

sudo nano /etc/prometheus/prometheus.yml

scrape_configs 섹션 내에, Node Exporter 메트릭의 엔드포인트와 함께 새로운 작업 prometheus-node-exporter를 추가합니다.

  - job_name: 'prometheus-node-exporter'  
    scrape_interval: 5s  
    static_configs:  
      - targets: ['192.168.10.15:9100']

파일을 저장하고 편집기를 종료하십시오.

다음으로, 아래의 systemctl 명령을 실행하여 prometheus 서비스를 재시작하고 변경 사항을 적용하십시오.

sudo systemctl restart prometheus

마지막으로, Prometheus 대시보드로 돌아가서 Status > Targets 메뉴를 클릭하십시오. 모든 것이 잘 진행되었다면, 대상 엔드포인트에서 Node Exporter를 볼 수 있어야 합니다.

node exporter added to prometheus

Prometheus 대시보드의 기본 사용법

이 섹션에서는 Prometheus와 Node Exporter의 기본 쿼리를 배우게 되며, 이는 Prometheus 대시보드에서 실행할 수 있습니다.

쿼리 node_os_info를 입력하고 Execute 버튼을 클릭하십시오. node_os_info는 운영 체제 세부 정보를 확인하기 위해 Node Exporter에서 제공하는 쿼리 언어입니다.

Console 섹션에서 다음과 같은 자세한 호스트 정보를 볼 수 있어야 합니다:

check os info

다음으로, node_memory_Active_bytes와 같은 다른 쿼리를 입력하여 대상 서버의 활성 메모리를 확인하십시오. Graph 섹션에서 다음과 유사한 결과를 볼 수 있어야 합니다:

check memory usage

또한, PromQL (Prometheus Query Language)을 사용하여 특정 데이터를 가져올 수 있습니다. 예를 들어, node_memory_Active_bytes[5]는 지난 5분 동안의 데이터를 보여줍니다.

결론

마무리하자면, Debian 12 서버에 Prometheus와 Node Exporter를 단계별로 설치하는 작업을 완료했습니다. 공식 Debian 저장소에서 APT를 통해 Prometheus와 Node Exporter를 설치했습니다. 또한 쿼리 테스트를 위한 Prometheus 대시보드의 기본 사용법도 배웠습니다. 이제 모니터링 시스템에 Alert Manager와 Grafana와 같은 추가 구성 요소를 설치할 수 있습니다.