NGINX Plus Metrics 모듈과 NGINX Agent 시작

NGINX Plus Metrics 모듈을 설치하고 NGINX Agent를 구성하여 Application 중심 Metrics을 NGINX Management Suite로 Push하려면 해당 포스트 가이드의 단계를 따르세요.

목차

1. NGINX Plus Metrics 개요
2. NGINX Plus Metrics 모듈 설치를 시작하기 전에
3. NGINX Agent 프로세스 중지
4. NGINX Plus Metrics 모듈 설치
 4-1. NGINX Management Suite 패키지 리포지토리에서 설치
 4-2. NGINX Management Suite에서 설치
5. NGINX Plus에서 Advanced Metrics를 사용하도록 NGINX Agent 구성
6. NGINX Agent 시작

1. NGINX Plus Metrics 개요

NGINX Plus Metrics 모듈은 NGINX Plus Data Plane 인스턴스에 설치할 수 있는 동적 모듈입니다.
“Application name”이나 “Gateway”와 같은 고급 앱 중심 메트릭 및 차원을 NGINX Agent에 보고하며, NGINX Agent는 이 데이터를 집계하고 NGINX Management Suite로 게시합니다.
Advanced App 중심 NGINX Plus Metrics 은 API Connectivity Manager와 같은 특정 NGINX Management Suite 모듈에서 HTTP 요청과 관련된 기능에 사용됩니다.

2. NGINX Plus Metrics 모듈 설치를 시작하기 전에

해당 포스트의 가이드를 진행하기 전에 다음 사전 요구 사항을 완료하세요. 이 가이드는 NGINX Management Suite가 설치되어 구성되어 있다고 가정합니다.

NGINX Data Plane 인스턴스가 NGINX Plus R24 이상을 실행 중인지 확인하세요.

인스턴스에서 실행 중인 NGINX Plus 버전을 확인하려면 다음 명령을 실행하세요.

ps aux | grep nginx

NGINX Plus 메트릭 모듈은 다음 Linux 배포판에서 작동합니다.

DistributionVersion(s)
Amazon Linux2 LTS
CentOS7.4 and later in the 7.x family
Debian10 buster-slim, 11 bullseye-slim
RHEL8.x and later in the 8.x family
Ubuntu18.08, 20.04, 22.04
  • 각 NGINX Plus 인스턴스에 NGINX Agent가 설치되어 있는지 확인합니다.

3. NGINX Agent 프로세스 중지

모듈을 설치하기 전에 Data Plane 인스턴스에서 NGINX Agent 프로세스를 중지해야 합니다. nginx-agent 프로세스가 중지된 동안 영향을 받는 인스턴스나 해당 인스턴스를 포함하는 인스턴스 그룹에 구성 변경을 push 하지 마세요.

1. Data Plane 호스트에 SSH 연결을 열고 로그인하세요.

2. 다음 명령을 실행하여 NGINX Agent가 실행 중인지 확인하세요.

ps aux | grep nginx-agent

3. 다음 명령을 실행하여 NGINX Agent를 중지하세요.

sudo systemctl stop nginx-agent

4. NGINX Plus Metrics 모듈 설치

4-1. NGINX Management Suite 패키지 리포지토리에서 설치

사용 중인 Linux 배포판과 일치하는 탭을 선택한 다음, NGINX Management Suite 리포지토리를 추가하는 지침을 따르세요.

CentOS, RHEL, RPM 기반

NGINX Management Suite 저장소를 추가하세요.

  • CentOS/RHEL
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nms.repo
  • RHEL 8
sudo yum module disable nginx:1.14
sudo yum module enable nginx:1.20
  • Amazon Linux 2
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nms-amazon2.repo

해당하는 운영 체제에 맞는 명령을 사용하여 NGINX Plus Metrics 모듈을 설치하세요.

  • CentOS, RHEL, RPM 기반
sudo yum update

sudo yum install nginx-plus-module-metrics
  • Debian, Ubuntu, Deb 기반
sudo apt update
sudo apt install nginx-plus-module-metrics
Debian, Ubuntu, Deb 기반

NGINX Management Suite 리포지토리를 추가하세요.

  • Debian
printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/nms/debian lsb_release -cs nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nms.list
printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/adm/debian lsb_release -cs nginx-plus\n" | sudo tee -a /etc/apt/sources.list.d/nms.list
sudo wget -q -O /etc/apt/apt.conf.d/90pkgs-nginx https://cs.nginx.com/static/files/90pkgs-nginx
  • Ubuntu
printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/nms/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nms.list

printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/adm/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee -a /etc/apt/sources.list.d/nms.list

sudo wget -q -O /etc/apt/apt.conf.d/90pkgs-nginx https://cs.nginx.com/static/files/90pkgs-nginx

해당하는 운영 체제에 맞는 명령을 사용하여 NGINX Plus Metrics 모듈을 설치하세요.

  • CentOS, RHEL, RPM 기반
sudo yum update
sudo yum install nginx-plus-module-metrics
  • Debian, Ubuntu, Deb 기반
sudo apt update

sudo apt install nginx-plus-module-metrics

4-2. NGINX Management Suite에서 설치

NGINX Management Suite에서Metrics 모듈을 설치하려면 curl 또는 wget과 같은 명령줄 도구를 사용하세요.

NGINX Agent와 NGINX Management Suite 간의 모든 트래픽을 암호화하는 것을 강력히 권장합니다. 암호화된 Agent 통신 가이드에서 지침을 찾을 수 있습니다.

NGINX Management Suite 배포가 non-production 환경이며 유효한 TLS 인증서가 없는 경우 도구의 “insecure” 옵션을 사용하여 설치를 완료해야 합니다.

제공된 예제에서는 명령이 NGINX Management Suite 호스트에서 패키지를 다운로드한 다음 설치 스크립트를 실행합니다. 보안 예제에서는 –skip-verify false 플래그를 사용하여 NGINX Agent가 mTLS에 사용되는 인증서의 유효성을 확인하도록 지시합니다.

  • 보안 연결 (권장)
curl https://<NMS_FQDN>/install/nginx-plus-module-metrics | sudo sh -s -- --skip-verify false
  • 비보안 연결
curl --insecure https://<NMS_FQDN>/install/nginx-plus-module-metrics | sudo sh

5. NGINX Plus에서 Advanced Metrics를 사용하도록 NGINX Agent 구성

NGINX Plus의 Advanced 메트릭은 NGINX Agent가 수집하는 애플리케이션 중심 Metrics 입니다.

고급 메트릭을 활성화하려면 /etc/nginx-agent/nginx-agent.conf 파일을 편집하고 다음 지시문을 추가하세요.

extensions:

  - advanced-metrics

advanced_metrics:

  socket_path: /var/run/nginx-agent/advanced-metrics.sock

  aggregation_period: 1s

  publishing_period: 3s

  table_sizes_limits:

    staging_table_max_size: 1000

    staging_table_threshold: 1000

    priority_table_max_size: 1000

    priority_table_threshold: 1000

6. NGINX Agent 시작

NGINX Plus 메트릭 모듈을 설치한 후, 다음 명령을 실행하여 NGINX Agent를 시작하세요.

sudo systemctl start nginx-agent

이 가이드의 단계를 완료한 후에는 NGINX Management Suite 사용자 인터페이스에서 앱 중심 Metrics이 표시됩니다. 또한 REST API를 사용하여 Metrics을 수집할 수도 있습니다. 자세한 내용은 “NGINX Management Suite Metrics API 사용하기“를 참조하세요.

아래 뉴스레터를 구독하고 NGINX와 NGINX STORE의 최신 정보들을 빠르게 전달 받아보세요.

NGINX STORE를 통한 솔루션 도입 및 기술지원 무료 상담 신청

* indicates required