Learn how to install NGINX Agent.
NGINX Agent interfaces directly with an NGINX server process installed on the same system. If you don’t have it already, follow these steps to install NGINX Open Source or NGINX Plus. Once installed, ensure the NGINX instance is running.
Install Agent from Package Files
To install NGINX Agent on your system, go to Releases and download the latest package supported by your OS distribution and CPU architecture.
Use your system’s package manager to install the package. Some examples:
Debian, Ubuntu, and other distributions using the
sudo dpkg -i nginx-agent-<agent-version>.deb
RHEL, CentOS RHEL, Amazon Linux, Oracle Linux, and other distributions using the
sudo yum localinstall nginx-agent-<agent-version>.rpm
RHEL and other distributions using the
sudo rpm -i nginx-agent-<agent-version>.rpm
sudo apk add nginx-agent-<agent-version>.apk
sudo pkg add nginx-agent-<agent-version>.pkg
Start and Enable Start on Boot
To start the NGINX Agent on
systemd systems, run the following command:
sudo systemctl start nginx-agent
To enable the NGINX Agent to start on boot, run the following command:
sudo systemctl enable nginx-agent
NGINX Agent uses formatted log files to collect metrics. Expanding log formats and instance counts will also increase the size of the NGINX Agent log files. We recommend adding a separate partition for
Without log rotation or storage on a separate partition, log files could use up all the free drive space and cause your system to become unresponsive to certain services.