How to extract GigaStor trace files in Apex Lite
Using a web browser, you can create packet captures from data collected by specific probe instances, across dates and times you set, and with or without filtering. This can be done without any direct interaction with Observer.
Apex Lite must remain installed on the target GigaStor.
As of, Observer Apex and Apex Lite are bundled with Observer.
LAN access to Apex Lite on the target GigaStor.
This is https://GigaStorHost/oa. Replace "GigaStorHost" with the host name or IP address of the GigaStor to know what address you need access to.
Apex Lite admin user credentials for logging in.
A compatible web browser is required.
By configuring and sending a trace extraction job, a packet capture is extracted from the GigaStor. The packet capture can be retrieved in a few different ways. See Understanding GigaStor trace extraction for details.
1. Open a compatible web browser, and type the following URL into the location bar: https://GigaStorHost/oa replacing "GigaStorHost" with the host name or IP address of the target GigaStor system.
You may notice a security certificate warning; this is normal for a self-signed certificate.
2. Type the user name admin and its password to log in.
Tip! Trouble logging in? Try user name: admin Password: admin.
3. In the web interface, click Advanced > Trace Extraction.
4. Set the probe instance in Instance.
Data from this probe instance creates the resulting packet capture.
5. Type a File Name for the packet capture.
6. Choose the File Type for the packet capture.
PCAPNG Packet Capture Next Generation
PCAP Packet Capture
BFR Observer Packet Buffer
7. Choose your Save To behavior for retrieving the packet capture after it is made.
Downloadable File Capture is downloadable from the job viewer using a web browser.
Local GigaStor File Path Capture is saved to a specified local directory on the GigaStor.
8. Click inside the Time Range boxes to set a date and time range.
All packets collected during this timespan—by this probe instance—are copied into the resulting packet capture. You still have the opportunity to narrow the scope of the packet capture in step 9.
9. Type a Filter to narrow the trace extraction to only the information you want.
Full details of the filtering syntax is available at Understanding the filter syntax.
10. Click the accept icon .
A REST API request with your parameters is sent to the GigaStor. A new trace extraction job is created and shown in the trace extraction job viewer. From there, the progress of your extraction can be viewed at any time. It may take some time to extract the packets; however, the time needed depends greatly on the order of your requests.
After the trace extraction completes the saved file can be opened in Observer to analyze the packets. If you open your trace in Observer one of two things happen with the filter. If this filter does not already exist a filter is created in the temp folder. If you want to permanently keep the filter in Observer you must move the filter out of the temp folder. If this filter already existed, the existing filter is automatically updated. The previous one is overwritten with the values from this one.
If you want to learn more about trace extraction settings, continue to Trace extraction settings. More details about how jobs are queued can be seen in Understanding GigaStor trace extraction.