Monitoring an NGINX server

To monitor an NGINX server, you must add the NGINX server source to IBM® DevOps Test Hub (Test Hub), enter connection settings and select the counters that are used to capture the monitoring usage data.

You must have logged in Test Hub and be the owner of an existing new project.

If you monitor a remote host, it must be connected with the computer that you use to access resource monitoring. See Resource monitoring agents.

You can optionally use agents.

This task applies to NGINX and NGINX Plus.

If you use an agent to connect

Click Infrastructure > Resource Monitoring.
The resource monitoring page opens.
In the resource monitoring page, click Add a Source and select Add an NGINX server....
Fill in the following connection settings in the New server dialog:
1. In Target host, enter the IP address or hostname and port number of the host where the server to monitor is installed.
  
  Note: For hosts that are already connected to Test Hub through an agent, you have only the Access target from field enabled. Move directly to step 4.
2. In Server edition, select the appropriate server from the drop-down list.
3. In Path to the status page of the server, enter the name of the page to view the status of the server.
  
  Note: If you select NGINX Plus (with API version 3) as a source, you must specify the name of the path to view the API root of the NGINX Plus server.
4. In Security, select the following options:
  
  Secured with TLS/SSL
  
  If the application server is secured with TLS/SSL.
  
  Trust self-signed certificate
  
  To accept the server certificate.
  
  Do not verify hostname
  
  To ignore verification of the hostname in the certificate.
  
  Require credentials
  
  If the server requires log-in credentials, enter a User name and Password.
5. Click Add.
  The Choose Data Counters dialog opens.
Select and save the statistics counters to monitor the source. You can select them from the list where they follow the server logical organization.
For a faster selection, select the counters from the built-in sets drop-down list where they are organized by theme and save your selection.
Note:
For Docker host, you can select different sets of counters.
- The first level of counters: Generic counters that are related to a Docker Image and all its running Docker Containers (in an exit, running or paused, created, restarted, removing, dead or transitive state).
- The second level of counters: Specific counters that are related to the existing Docker Containers.

When the selected counters are saved, two tables are displayed in the resource monitoring main page. They contain the total number of sources you have added and the number of sources ordered by type.

You can click the links in the tables to view the performance metrics of your monitored system.