NGINX One 시작하기
이 가이드는 F5 NGINX One Console을 활성화하고 시작하는 방법에 대한 단계벌 지침을 제공합니다. NGINX One은 NGINX Data Plane 인스턴스를 모니터링하고 관리하기 위한 관리 Console입니다.
목차
1. NGINX One 서비스 활성화
2. NGINX 인스턴스를 NGINX One에 추가
2-1. 인스턴스 추가
2-2. Data Plane Key 생성
2-3. NGINX Agent 설치
3. NGINX One 대시보드로 인스턴스 측정항목 보기
3-1. NGINX One 로그인
3-2. NGINX One 대시보드 개요
1. NGINX One 서비스 활성화
NGINX One 사용을 시작하려면 F5 Distributed Cloud에서 서비스를 활성화합니다.
- F5 Distributed Cloud에 로그인합니다.
- 서비스 목록에서 NGINX One을 선택합니다
- Enable Service를 선택합니다.
- 서비스가 활성화 된 후, Visit Service을 선택하여 NGINX One Console을 불러옵니다.
2. NGINX 인스턴스를 NGINX One에 추가
다음으로 NGINX 인스턴스를 NGINX One에 추가합니다. Data Plane Key를 생성한 다음 모니터링하려는 각 인스턴스에 NGINX Agent를 추가합니다.
2-1. 인스턴스 추가
NGINX One 콘솔을 최초로 사용하는지, 이전에 사용했었던 적이 있는이제 따라 단계에 따라 인스턴스를 추가할 수 있습니다.
- 최초 사용자의 경우 : 시작화면에서 Add Instance를 선택합니다.
- 기존 사용자의 경우 : 이전에 인스턴스를 추가 했었고 더 추가하려면 Instances 왼쪽 메뉴에서 Add Instance를 선택합니다.
2-2. Data Plane Key 생성
Data Plane Key는 신뢰할 수 있는 NGINX 인스턴스만 NGINX One에 등록하고 통신할 수 있도록 보장하는 보안 토큰입니다.
Data Plan Key를 생성하려면 다음 안내를 따르세요.
- 새 Key의 경우 : Add Instance창에서 Generate Data Plane을 선택합니다.
- 기존 Key 재사용의 경우 : 이미 Data Plane Key가 있고 이를 다시 사용하려면 Use existing key를 선택합니다. 그 다음 Data Plane Key의 Key값을 입력합니다.
Data Plane 주요 지침
- Data Plane Key는 한 번만 표시되며 나중에 재확인할 수 없습니다. 이 Key를 복사하여 안전하게 보관해야합니다.
- Data Plane Key는 1년 후에 만료됩니다. 만료 날짜를 변경할 수 있습니다.(Key 편집)
- Data Plane Key를 삭제하면 해당 Key로 등록된 모든 인스턴스의 연결이 끊어집니다.
2-3. NGINX Agent 설치
Data Plane Key를 입력은 아래 명령문(curl)과 같습니다. 각 NGINX 인스턴스에서 이 명령문을 실행하여 NGINX Agent를 설치합니다. NGINX Agent가 설치되면 몇 초 내에 NGINX One에 등록됩니다.
NGINX 인스턴스에 NGINX Agent를 설치하려면 다음 안내를 따르세요.
1. NGINX가 실행 중인지 확인합니다.
먼저 NGINX가 실행중인지 확인합니다.
sudo systemctl status nginx
Active 상태가 아닌경우 아래 명령문을 사용하여 NGINX를 시작합니다.
sudo systemctl start nginx
2. NGINX Agent를 설치합니다.
다음과 같은 명령문을 사용하여 NGINX Agent를 설치합니다.
curl https://agent.connect.nginx.com/nginx-agent/install | DATA_PLANE_KEY="YOUR_DATA_PLANE_KEY" sh -s -- -y
YOUR_DATA_PLANE_KEY에는 실제 Data Plane Key를 사용하세요.-y욥션은 설치 중 프롬포트를 자동으로 확인합니다.
위의 install 스크립트는 Data Plane Key를 생성합니다.
Data Plane Key의 정보는 /etc/nginx-agent/nginx-agent.conf 파일에서 확인할 수 있습니다.
server:
token: "<YOUR_DATA_PLANE_KEY>"
host: agent.connect.nginx.com
grpcPort: 443
tls:
enable: True
skip_verify: False
NGINX 에이전트 설치를 위한 설치 및 업그레이드 가이드를 따랐다면 이 정보를 nginx-agent.conf에 수동으로 추가해야 할 수도 있습니다.
Note: NGINX Agent 폴링 간격
NGINX 에이전트 구성(/etc/nginx-agent/nginx-agent.conf)에서 dataplane.status.poll_interval을 30~60초 사이로 유지하는 것이 좋습니다. 간격을 50초 이상으로 설정하면 NGINX One Console이 잘못된 인스턴스 상태를 보고할 수 있습니다.
NGINX Agent는 아래와 같은 Linux 운영 체제를 지원하고 있습니다. NGINX Agent 설치 스크립트는 이러한 배포판 및 버전과 호환됩니다.
NGINX Agent Install Script: 지원되는 배포판
| Distribution | Version | Architecture |
| AlmaLinux | 8,9 | x86_64, aarch64 |
| Alpine Linux | 3.16 – 3.18 | x86_64, aarch64 |
| Amazon Linux | 2023 | x86_64, aarch64 |
| Amazon Linux 2 | LTS | x86_64, aarch64 |
| CentOS | 7.4+ | x86_64, aarch64 |
| Debian | 11, 12 | x86_64, aarch64 |
| Oracle Linux | 7.4+, 8.1+, 9 | x86_64 |
| Red Hat Enterprise Linuxz | 7.4+, 8.1+, 9 | x86_64, aarch64 |
| Rocky Linux | 8. 9 | x86_64, aarch64 |
| Ubuntu | 20.04 LTS, 22.04 LTS | x86_64, aarch64 |
3. NGINX One 대시보드로 인스턴스 측정항목 보기
NGINX 인스턴스를 NGINX One에 연결한 후 성능과 상태를 모니터링할 수 있습니다. NGINX One 대시보드는 이러한 목적을 위해 설계되었으며 사용하기 쉬운 인터페이스를 제공합니다.
3-1. NGINX One에 로그인
- F5 Distributed Console에 로그인합니다.
- NGINX One에서 Visit Service를 선택합니다.
3-2. NGINX One 대시보드 개요
대시보드 탐색:
- Drill down into specifics : 만료되는 인증서 등 특정 항목에 대한 자세한 정보를 보려면 측정항목 카드의 링크를 클릭하여 자세한 개요 페이지로 이동할 수 있습니다.
- Refine metric timeframe :측정항목은 기본적으로 지난 시간의 데이터를 표시합니다. 다른 기간의 데이터를 보려면 드롭다운 메뉴에서 원하는 시간 간격을 선택할 수 있습니다.

NGINX One 대시보드 지표
| Metrics | Description | Details |
| Instance availability | NGINX 인스턴스의 운영 상태입니다. | – Online : NGINX 인스턴스가 활발하게 연결되어 제대로 작동하고 있습니다. – Offline : NGINX 에이전트가 연결되어 있지만 NGINX 인스턴스가 실행되지 않거나 설치되지 않았거나 NGINX 에이전트와 통신할 수 없습니다. – Unavailable : NGINX Agent와 NGINX One 간의 연결이 끊어졌거나 인스턴스가 해제되었습니다. – Unknown : 현재 상태를 확인할 수 없습니다. |
| NGINX versions by instance | 인스턴스에서 사용 중인 NIGNX 버전입니다. | |
| Operating systems | 인스턴스가 어떤 운영체제에서 사용되고 있는지 알 수 있습니다. | |
| Certificates | SSL 인증서 상태를 모니터링하여 만료되는 인증서와 유효한 인증서를 확인할 수 있습니다. | |
| Config recommendations | 인스턴스 설정을 최적화하기 위한 구성 권장 사항입니다. | |
| CVEs (Common Vulnerabilities and Exposures) | 인스턴스의 잠재적 보안 위협의 심각도 수의 평가입니다. | – Major : 즉각적인 주의가 필요한 심각도가 높은 위협을 나타냅니다. – Medium : 중간 정도의 위협 수준을 의미합니다. – Minor 및 Low : 여전히 모니터링이 필요한 덜 중요한 문제를 나타냅니다. – Other : 표준범주에 맞지 않는 위협을 모두 포함합니다. |
| CPU utilization | CPU 사용량을 추적하고 CPU의 사용량이 높은 인스턴스를 찾을 수 있습니다. | |
| Memory utilization | 메모리 사용 패턴을 관찰하여 높은 메모리를 사용하는 인스턴스를 볼 수 있습니다. | |
| Disk space utilization | 인스턴스가 사용하고 있는 디스크의 공간 양을 모니터링할 수 있습니다. | |
| Unsuccessful response codes | HTTP 서버 오류 수가 많은 인스턴스를 찾을 수 있고 오류 코드를 확인할 수 있습니다. | |
| Top network usage | 인스턴스의 네트워크 사용량과 대역폭 소비를 확인할 수 있습니다. |
NGINX Instance를 Control Plane으로 클라우드 환경에서 제어할 수 있는 NGINX One 사용하시려면 NGINX STORE에 연락하여 논의하십시오.
댓글을 달려면 로그인해야 합니다.