Fetch monitoring data

You can retrieve monitoring data stored in a .dat file.

You may need to retrieve the monitoring data stored in a .dat file to transfer data to a database or to a third party monitoring system where the monitoring data is processed and managed. If there are several .dat files for a session, each fetch command reads the oldest .dat file. As a result, if you run several fetch commands against the same session, the events will be fetched in chronological order.

Fetch the monitoring data for a session using the gasadmin monitoring fetch <session-id> command. For example, this command generates a comma-separated file, which can then be opened by Microsoft® Excel:

gasadmin monitoring fetch --file mydata.csv d98290172c8f7c0d861db329f1ce6597

To fetch the data for processing by a Genero BDL application, use the --xml-output option of the gasadmin command to output the monitoring data as XML. For example, this code snippet uses the method xml.StaxReader.readFromPipe() to retrieve the monitoring data in XML format:

CALL stax.readFromPipe("gasadmin monitoring fetch --quiet --xml-output d98290172c8f7c0d861db329f1ce6597")

Important:

The --quiet option in the command line suppresses the diagnostic first line of the output, Fetching monitoring data for session :d98290172c8f7c0d861db329f1ce6597, which is not valid XML. Therefore, by adding the --quiet option, the Stax reader does not throw the error, Invalid XML document.