Skip to main content

Find Bookmark or Transaction ID in Transaction Log

The AMPS journal search utility is used to locate entries in an AMPS journal file. The amps_journal_search utility is most commonly used as a tool to debug issues with applications that use AMPS, particularly in cases where it is unclear at what point in time a given message was received by AMPS. The amps_journal_search tool can be used to find the precise journal file that contains a given message.

Command Line Options

The amps_journal_search program includes the following options. The options available can be printed to the screen by typing amps_journal_search --help.

OptionDescription

filename

(required)

Filename of the AMPS journal file.
-h, --helpShow the program help message and quit.
<search-pattern>

The bookmark or transaction id to locate.

When a <search-pattern> is provided, the utility searches the record metadata, but does not search the message data.

-d <search-string>, --data <search-string>

Locate messages that contain the data in <search-string>.

If <search-string> is a bookmark, also includes records matching the bookmark.

-topic=TOPIC_NAMESearch metadata for the provided topic term.
--no-dataDo not provide message data in the output.
--client=CLIENT_HASHSearch client hash(es) metadata for all matching records. This argument may be provided multiple times to search for multiple clients.