NGINX Plus 사용 리포트 F5로 전송
중요: NGINX Pluss R33은 NGINX Instance Manager 2.18 혹은 이후 버전이 필요합니다
데이터 플레인 인스턴스가 NGINX Plus R33 버전을 사용하고 있다면, 중단 없는 트래픽 처리를 보장하기 위해 NGINX Instance Manager을 2.18 혹은 이후 버전으로 업그레이드하세요.
NGINX Plus R33 인스턴스는 F5 라이선싱 엔드포인트 혹은 NGINX Instance Manager로 사용 데이터를 전송해야 합니다. 그러지 못한다면, NGINX Plus 인스턴스는 트래픽 처리를 멈춥니다.
사용 리포트 및 정책에 대한 더 자세한 정보는 구독 라이선스 문서를 참고하세요.
NGINX Instance Manager은 인터넷에 접속할 수 있지만, NGINX Plus 는 접속할 수 없는 환경에서 NGINX Plus는 사용 데이터 리포트 를 NGINX Instance Manager로 전송합니다. NGINX Instance Manager는 검증을 위해 사용 리포트를 자동으로 F5로 전송합니다. 혹은 수동으로 전송하도록 선택할 수 있습니다.
만약 사용 리포트 전송이 실패하면, NGINX Plus는 트래픽 처리를 중단합니다. 이전에 리포트를 전송한 인스턴스에 대해선 예외가 있습니다.
아래의 단계를 확인하여 NGINX Plus가 NGINX Instance Manager로 사용 리포트를 전송하도록 설정하고 검증을 위해 F5로 리포트를 전송하는 방법을 확인하세요.
네트워크 제한 환경의 경우
만약 NGINX Instance Manager의 배포 환경이 인터넷 접속이 불가능할 경우, NGINX Plus 사용 리포트 F5로 전송(네트워크 제한 환경)의 단계를 따라 사용 데이터를 F5로 전송하세요.
목차
1. NGINX Plus 사용 리포트 전송을 위한 사전 준비
2. F5로 NGINX Plus 사용 리포트 전송
2-1. 자동 리포트 전송
2-2. 수동 리포트 전송
3. 전송되는 내용
1. NGINX Plus 사용 리포트 전송을 위한 사전 준비
사용 데이터를 F5로 전송하기 전에, NGINX Instance Manager가 F5로 리포트를 전송하기 위해 적절한 네트워크 포트가 개방되었는지 확인하세요. 그리고 NGINX Plus가 원격 측정 데이터를 NGINX Instance Manager로 전송하도록 설정해야 합니다.
리포트 전송을 위한 네트워크 포트 설정
NGINX Instance Manager이 사용 데이터 리포트를 F5로 전송하기 위해, 다음 URL에 대해 443 포트가 개방되어 있는지 확인하세요.
NGINX Plus 사용 리포트를 NGINX Instance Manager로 전송하기 위한 설정
NGINX Plus(R33 혹은 이후 버전)가 NGINX Instance Manager로 사용 데이터를 전송하도록 설정하려면 다음 단계를 따르세요.
1. NGINX Instance Manager을 위해 443 포트를 개방합니다.
2. 각 NGINX Plus 인스턴스의 NGINX 설정(/etc/nginx/nginx.conf)에서 mgmt 블록의 usage_report 지시문에 NGINX Instance Manager 호스트를 설정합니다.
mgmt {
usage_report endpoint=<NGINX-INSTANCE-MANAGER-FQDN>;
}자체 서명 인증서
자체 서명 인증서 사용을 위한 세부 사항은 자체 서명 인증서로 사용 리포트 전송을 위한 SSL 검증 설정을 참고하세요.
3. NGINX를 reload 합니다.
$ nginx -s reload
2. F5로 NGINX Plus 사용 리포트 전송
2-1. 자동 리포트 전송
NGINX Instance Manager에 JSON Web Token(JWT)를 추가하면, 사용 리포트 전송은 기본적으로 활성화됩니다.
NGINX Instance Manager는 인터넷 접속이 가능하면 자동으로 구독 권리와 사용 데이터를 F5에 전송합니다.
2-2. 수동 리포트 전송
사용 리포트 요구 사항
정기적으로 F5에 사용 리포트가 전송되어야 합니다. 사용 리포트가 180일 동안 전송되지 않으면, NGINX Plus는 트래픽 처리를 중단합니다. 사용 리포트 전송 과정의 세부 사항은 구독 라이선스를 참고하세요.
사용 리포트를 F5로 수동으로 전송하는 것을 선호하신다면, 다음 단계를 따르세요.
- NGINX Instance Manager 웹 인터페이스(
https://<NIM-FQDN>/ui/)로 로그인합니다. - Settings (톱니바퀴) 아이콘을 선택합니다.
- Licenses > Overview 페이지에서 Enable Continuous Connection을 비활성화합니다.
- 사용 리포틀르 수동으로 전송하기 위해 Send Usage to F5를 선택합니다.
3. 전송되는 내용
NGINX Plus는 사용 리포트를 시간마다 자동으로 F5에 전송합니다. 이 데이터는 POST 요청으로 전송되고 처리한 트래픽 양이나 인스턴스가 실행된 기간과 같은 세부 정보를 포함합니다. 다음은 전송되는 데이터의 예시입니다.
{
"version": "<nginx_version>",
"uuid": "<nginx_uuid>",
"nap": "<active/inactive>", // status of NGINX App Protect
"http": {
"client": {
"received": 0, // bytes received
"sent": 0, // bytes sent
"requests": 0 // number of HTTP requests processed
},
"upstream": {
"received": 0, // bytes received
"sent": 0 // bytes sent
}
},
"stream": {
"client": {
"received": 0, // bytes received
"sent": 0 // bytes sent
},
"upstream": {
"received": 0, // bytes received
"sent": 0 // bytes sent
}
},
"workers": 0, // number of worker processes running
"uptime": 0, // number of seconds the instance has been running
"reloads": 0, // number of times the instance has been reloaded
"start_time": "epoch", // start time of data collection for the report
"end_time": "epoch" // end time of data collection for the report
}
