Monitoring HTTP requests
When investigating issues, you often need to look at what goes "over the wire", in the HTTP requests between the client and the server. You may want to look at the HTTP requests as sent/received on the browser, on the application server, or somewhere in between. This page lists a few tool which might be of use in these cases.
- WireShark is a workhorse. It can do a lot more than monitoring HTTP requests, but can also be intimidating. Lately, usability, including the installing process, has improved significantly. (See below for more details on WireShark.)
- [SINCE Orbeon Forms 2020.1.6]
- [UNTIL Orbeon Forms 2020.1.5]
- Use the browser's dev tools (AKA "F12 Developer Tools" on IE)
After you install WireShark, click on Capture Options, and setup a setup the Capture Filter to be
tcp port 8080. (Replace 8080 with the port on which your application server or services are listening, as appropriate.)
Click Start, and since you only interested about HTTP (versus TCP) traffic, in Filter type
http and press enter to apply.
Next WireShark will show you all the HTTP traffic that goes through the machine it is running on, to the port you specified (here 8080).
[SINCE Orbeon Forms 2021.1, 2020.1.6] To enable, add the following to your
web.xml, before all the other filters.<filter>
<filter-name>orbeon-http-logging-filter</filter-name>
<filter-class>org.orbeon.oxf.servlet.HttpLoggingFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>orbeon-http-logging-filter</filter-name>
<url-pattern>/xforms-server</url-pattern>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
Note that the Request Dumper Filter only shows information about the HTTP headers of the request. If you want more information to be logged, use the Apache TCPMon.
- 1.The Request Dumper Filter comes with Tomcat, so even if you are not using Tomcat, start by downloading Tomcat.
- 2.Unzip Tomcat, and copy the directory webapps/servlets-examples/WEB-INF/classes/filters to the WEB-INF/classes directory of your web application.
- 3.Edit WEB-INF/web.xml and add:
- After the declaration of the filter ops-xforms-filter:<filter><filter-name>request-dumper-filter</filter-name><filter-class>filters.RequestDumperFilter</filter-class></filter>
- After the filter mapping for ops-xforms-filter:<filter-mapping><filter-name>request-dumper-filter</filter-name><url-pattern>/*</url-pattern></filter-mapping>
- Restart your application server (e.g. Tomcat).
- On Tomcat, requests will be logged to the logs/localhost log file.
The Request Dumper Valve doesn't log the body of
POSTs, it can only be used on Tomcat, and we found its output to be less readable than what you get with the Request Dumper Filter. But if you still want to experiment with the Request Dumper Valve, add the following in server.xml inside :<valve classname="org.apache.catalina.valves.RequestDumperValve">
Last modified 11mo ago