If you have a suggestion or if you want to report an issue, please read the troubleshooting process below first. If this does not help you please do not hesitate reach out to us on our in app-chat.
Troubleshooting for Keymetrics/PM2
I can't seem to connect my local PM2 to the Keymetrics dashboard
If you are in this situation, it might be for several reasons.
- You are behind a company proxy or firewall. Make sure that the ports 80 (TCP outbound), 443 (HTTPS outbound) and 43554 (TCP outbound) are allowed on your firewall.
If you need to whitelist IPs, please allow these ones: 188.8.131.52, 184.108.40.206, 220.127.116.11, 18.104.22.168, 22.214.171.124, 126.96.36.199, 188.8.131.52
You are using an old version of Node.js or PM2. Make sure you are using at least Node.js v0.12.x or higher (node v0.12.x or iojs v.2.x is recommended). Make sure you are using the latest version of PM2 https://github.com/Unitech/PM2/releases.
You have concurrent PM2 sending data to the same bucket with an identical server name. Make sure you have only one PM2 instance launched
ps -ax | grep PM2
Refresh your connection to Keymetrics.
pm2 interact stopthen
pm2 interactshould help. Also don't forget to refresh the dashboard itself, it might help sometimes.
The dashboard displays "Reverse connection not established"
It means that PM2 have not managed to initialize the full duplex connection. Not any actions will work (restart, pull, module install...).
Please make sure that the port 43554 (TCP outbound) is opened and check the logs in ~/.pm2/agent.log.
pm2 link to re-try the connection.
I cannot link new servers but no server is linked at the moment
Go to the setting page of your bucket and delete servers in the server box.
The versioning buttons (Rollback/Pull/Upgrade) aren't working
If the buttons are disabled, make sure that the
Local commitindicators are green.
If you get a warning
Not authorizedwhen trying to perform such actions, it means you have not the admin privileges in this bucket.
If none of the above happens, but the precedure just hangs, make sure you have a recent version of Node.js as well as the latest version of PM2.
Also, your repository should not ask for a password input (it means you must clone it via ssh), try typing
git remote updatemanually in the folder and see if it asks for a password or not.
3. The versioning block displays
File modified (unstaged changes)
It means that there are local files that has been changed and not committed.
To see which files have been modified do a
git status. Once it is fixed (via git commit or git stash) do a
pm2 restart all.
In the dashboard I've linked two servers and they are continuously flickering
You made a
pm2 link <public_id> <private_id> [name] without setting the name option. By default if the name is empty, it becomes the $HOSTNAME env variable.
To fix this:
# Server 1 $ pm2 link <private_id> <public_id> server1 # Server 2 $ pm2 link <private_id> <public_id> server2