Troubleshooting
F5 NGINX Agent Troubleshooting
1. Container running but Agent is not connected to NGINX One Console?
- Check Agent logs
bash docker logs <container-id-or-name>
- If you are using NGINX Plus, a valid license will need to be passed into the container run command.
- Ensure that the values sent with the container run command are correct.
2. Container running but instance is showing offline on NGINX One Console?
- Check Agent logs
bash docker logs c5e1e3234900 | grep "nginx"
- Verify the following log message is shown:
2025/02/17 19:02:58 [notice] 32#32: nginx/1.27.2 (nginx-plus-r33-p2
- If not found, it could mean the container image is missing the NGINX service
- Make sure NGINX is running
ps -ef | grep "nginx"
- Make sure NGINX is part of the image file.
3. NGINX Agent is installed on my Virtual Machine, but not showing up on NGINX One Console?
- Verify the agent is running
sudo systemctl status nginx-agent
- Check for any errors in the logs
sudo tail -f /var/log/nginx-agent/agent.log
- Check
/etc/nginx-agent/nginx-agent.conf
for any misconfigurations.