Working with Event Payloads
An event payload is the information carried in the body of the event's network packet, as distinct from the packet's header data. From the , you can search, retrieve, view, save to a file, or discard event payloads.
The first step in handling event payloads is to be able to locate payload-bearing events among the general flow of events in an active channel.
Events payloads are identified by the Payload ID icon:
To find payloads:
-
In an active channel, right-click a column header and choose Add Column>Device>Payload ID.
-
Look for events showing a Payload ID in that column.
To retrieve payloads:
-
In an active channel, double-click an event with an associated payload.
-
In the Event Inspector, click the Payload tab.
-
Click Retrieve Payload.
To preserve payloads:
You can select to preserve the payload for an event in either of two ways:
-
In an active channel, right-click an event with an associated payload, choose Payload, then Preserve.
Or
-
In the Event Inspector, click the Payload tab, then Preserve Payload.
To discard payloads:
In an active channel, right-click an event with an associated payload and choose Payload, then Discard Preserved.
You can also use the Event Inspector, as follows:
-
In an active channel, double-click an event with an associated payload.
-
In the Event Inspector, click the Payload tab.
-
Click Discard Preserved Payload.
To save payloads to files:
-
In an active channel, double-click an event with an associated payload.
-
In the Event Inspector, click the Payload tab.
-
Click Save Payload.
-
In the Save dialog box, navigate to a directory and enter a name in the File name text field.
-
Click Save.
To view payloads in other viewers:
-
In an active channel, double-click an event with an associated payload.
-
In the Event Inspector, click the Payload tab.
-
Click Launch External Payload Viewer.
-
View the payload using the Preferred Payload Viewer and Text to PCAP Converter, specified in the 's Edit>Preferences>Programs panel.