New Relic 플러그인을 통한 NGINX 및 NGINX Plus 모니터링

New Relic용 NGINX 및 NGINX Plus 플러그인 버전 2의 새로운 기능(더 편리해진 편의성, 더 많은 지표, 더 풍부한 가시성)을 확인해 보세요.

2013년 3월, New Relic은 NGINX Open Source 소프트웨어 및 NGINX Plus 의 New Relic 모니터링을 위한 “nginx 웹 서버” 플러그인의 첫 번째 버전을 출시했습니다. 그 이후로 사용자들로부터 많은 관심을 받아 대단히 감사하게 생각합니다! 이 플러그인은 몇 가지 개선할 점이 있음에도 불구하고 여전히 New Relic 플러그인 중 가장 인기 있는 플러그인 중 하나입니다. 아직 New Relic 계정이 없으시다면 지금 바로 가입하세요.

New Relic 플랫폼 자체가 Ruby로 작성되어 있고, API가 아직 공개되지 않았으며, 많은 것들이 빠르게 변화하고 있었기 때문에 오리지널 플러그인의 기본 언어로 Ruby를 선택했습니다.

이후 New Relic 플랫폼 출시 후, 사용자들의 피드백과 자체 비전을 바탕으로 NGINX 모니터링 플러그인의 전반적인 사용성을 개선하기 위해 여러 가지 개선 사항을 추가하는 작업을 계속해왔으며, 추가 변경이 필요하다는 것을 깨달았습니다.

목차

1. 새로운 기능
2. 설치
3. 플러그인 구성
4. 플러그인 실행
5. 대시보드 예시
5-1. Overview
5-2. Connections
5-3. Requests
5-4. Upstreams (NGINX Plus 만 해당)
5-5. Servers (NGINX Plus 만 해당)
5-6. Cache (NGINX Plus 만 해당)

1. 새로운 기능

다음과 같은 변경 사항이 포함된 New Relic용 NGINX 플러그인 버전 2.0의 주요 업데이트입니다.

• 플러그인이 Python으로 재작성되었습니다. 더 이상 Ruby를 설치할 필요가 없습니다.
• 플러그인이 마침내 패키지화되었습니다. RHEL/CentOS 기반 및 Debian/Ubuntu 기반 시스템용 패키지가 미리 빌드되어 있습니다. 포함된 초기화 스크립트를 통해 플러그인의 자동 시작을 쉽게 설정할 수 있습니다.
• Live Activity Monitoring 대시보드에는 NGINX Plus 고객을 위한 두 개의 새로운 섹션이 있습니다.
  • Servers – server 구성 블록에 status_zone 지시문이 포함된 가상 서버에 대한 추가 요약 카운터
  • Cache – 구성된 모든 캐시에 대한 누적 통계
• 상세 로깅은 기본값으로 활성화되어 있습니다.

2. 설치

플러그인 및 설치 지침을 다운로드하세요.

3. 플러그인 구성

NGINX 플러그인의 구성 파일은 /etc/nginx-nr-agent/nginx-nr-agent.ini입니다. 최소 구성에는 다음이 포함됩니다.

• global 섹션의 newrelic_license_key 문에 New Relic 라이선스 키를 입력합니다.
• 하나 이상의 source 섹션. 섹션의 이름은 로그 항목에만 사용되며 원하는 거의 모든 문자 문자열을 포함할 수 있습니다. 두 개의 매개변수가 필요합니다.
  • name – New Relic UI의 NGINX 인스턴스 이름입니다.
  • url – 해당 인스턴스에 대한 전체 URL입니다. 이 플러그인은 stub_status 지시문이 NGINX 또는 NGINX Plus 구성에 포함될 때 생성된 형식의 Source 데이터를 받아들입니다. 또한 api 지시문이 NGINX Plus 구성에 포함될 때 생성되는 JSON 형식의 출력도 지원합니다.

해당 위치가 NGINX auth_basic 지시문으로 보호되는 경우 선택 사항으로 http_user 및 http_pass 구문을 포함시켜 HTTP 기본 인증 자격 증명을 설정할 수 있습니다.

기본 로그 파일은 /var/log/nginx-nr-agent.log입니다.

4. 플러그인 실행

초기화 스크립트로 플러그인을 관리할 수 있습니다. start, stop 또는 status 인수를 사용하여 service nginx-nr-agent 명령을 실행하여 각각 플러그인을 start, stop 또는 status를 표시합니다.

초기화 스크립트에서 시작하면 플러그인 데몬이 nobody 사용자로 실행됩니다.

다음 선택적 매개변수를 사용하여 /usr/bin/nginx-nr-agent.py를 실행하여 플러그인을 직접 시작할 수 있습니다.

• -c, --config – 구성 파일 경로
• -p, --pidfile> – PID 파일 경로
• -f, --foreground – 터미널에서 분리하지 마세요(디버깅에 유용합니다).

모든 것이 예상대로 작동하면 플러그인이 New Relic UI에 탭으로 표시됩니다.

5. 대시보드 예시

5-1. Overview

Overview 탭에는 전체 인스턴스에 대한 가장 기본적인 지표인 활성 및 유휴 연결 수와 요청 비율이 표시됩니다.

5-2. Connections

Connections 탭에는 클라이언트 연결에 대한 다양한 지표가 표시됩니다.

5-3. Requests

Requests 탭에는 현재 처리 중인 요청 수와 전체 요청 비율이 표시됩니다.

5-4. Upstreams (NGINX Plus 만 해당)

Upstreams 탭에는 구성된 모든 Upstream 그룹에 대한 자세한 통계가 표시됩니다.

5-5. Servers (NGINX Plus 만 해당)

Servers 탭에는 구성된 모든 가상 서버 Zone에 대한 자세한 통계가 표시됩니다.

5-6. Cache (NGINX Plus 만 해당)

Cache 탭에는 구성된 모든 캐시에 대한 요약 통계가 표시됩니다.