In order to analyze non-compliant or abnormal proxy behavior, it is sometimes necessary to activate the verbose mode in the proxy. But activating this mode in production mode will generate too many events and make reading almost unreadable.
This feature is availabe on Artica v4.50 Service pack 1 or Artica v4.50 Hotfix dev 20240307-18
On the other hand, verbose mode will generate a huge amount of disk writing and may slow down the Internet access service.
That's the reason for this feature.
It allows you to run a new instance in debug mode on a different port on your Artica machine, with the same rules and configuration as the production service.
In this way, you are able to only connect your browser or your user's browser to replicate then abnormal behavior and provide trace files to the technical support team.
¶ Install the dedicated debug proxy instance
- On the top-right menu, choose “
Your Proxy” > “Services operations”
- Click on the button “
Proxy (Debug mode)”
- Define a port that is not used by the production proxy service.
You will Connect your browser to this port in order to reproduce the unusual behavior. - Click on Start button
- The instance installation will start and the window will be transformed into an uninstall window.
- Replicate the behavior with your browser by using the defined port and click on the uninstall button.
- This uninstall interface can be found in the proxy status section.
When the debug mode instance is installed, you can view the status of its service, and a new button has been added to return to the debugging section.
¶ Retreive the support package
- When you start uninstalling the debugging service, Artica will collect the trace files before uninstalling, so that the trace files can be downloaded..
- Download the generated package and provide it to the technical support team for investigation.
¶ Rest API
Install the Debug instance
GET http://server:9503/proxy/debug/enable-instance
Uninstall the Debug instance
GET http://server:9503/proxy/debug/disable-instance
Get status of the Debug instance
GET http://server:9503/proxy/debug/status
Restart the Debug instance
GET http://server:9503/proxy/debug/restart