Troubleshooting

Solutions for common issues with the Amplify Agent.

Agent Not Reporting

Check Agent Status

sudo systemctl status amplify-agent

Check Logs

sudo tail -100 /var/log/amplify-agent/agent.log

Common Issues

Problem Solution
Invalid API key Verify the key in /etc/amplify-agent/agent.conf
Network blocked Ensure outbound HTTPS to amplify.getpagespeed.com is allowed
NGINX not detected Ensure NGINX is running: nginx -t
Permission denied Check file permissions on config and log directories

Missing Metrics

stub_status Not Working

Test the endpoint:

curl http://127.0.0.1/nginx_status

Expected output:

Active connections: 1
server accepts handled requests
 1234 1234 5678
Reading: 0 Writing: 1 Waiting: 0

Getting Help

If you're still having issues:

  1. Check our FAQ for common questions
  2. Review the agent logs for specific error messages
  3. Contact support with your logs attached