Monitoring an NGINX server

To monitor an NGINX server, you must add the NGINX server source to Rational® Test Automation Server, enter connection settings and select the counters that are used to capture the monitoring usage data.

Before you begin

You must have logged in Rational® Test Automation Server 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.

About this task

This task applies to NGINX and NGINX Plus.

If you use an agent to connect

Procedure

  1. Click Infrastructure > Resource Monitoring.
    The resource monitoring page opens.
  2. In the resource monitoring page, click Add a Source and select Add an NGINX server....
  3. Fill in the following connection settings in the New server dialog:
    1. In Target host, enter the IP address or host name and port number of the host where the server to monitor is installed.
      Note: For hosts that are already connected to Rational® Test Automation Server 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 host name
      To ignore verification of the host name 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.
  4. 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.

    Choose data counters with the filters

    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.

Results

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.

Tables of available sources

What to do next

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