Troubleshooting runtime errors
Users might encounter runtime errors when trying to connect to your partners. To troubleshoot these errors, investigate the user’s activities, particularly the requests and the responses between the client and the PingFederate server, to determine the root cause.
- Client side
-
Use built-in developer tools from the browsers to analyze HTTP traffic. Alternatively, you can use third-party tools, such as Fiddler and Charles.
- Server side
-
Review server log messages to investigate what PingFederate has received from the client.On rare occasions, you can also use third-party tools, such as Wireshark, or tools from the operating systems, such as Tcpdump, to capture network traffic on the PingFederate server.
For instructions of third-party tools, see their documentation.
To correlate server log messages to user activities, you can use one of the following:
-
The tracking ID, which can be configured to show in the user-facing error pages in PingFederate.
-
The PF cookie value, which requires capturing the HTTP headers on the client side.
-
Real-time monitoring of the server log, which works well if the issues can be replicated reliably and involves using tools from the operating systems or third-party vendors.