Skip to content

carehart/FusionReactor-Log-Headers

 
 

Repository files navigation

FusionReactor-Log-Headers

The purpose of this project is to offer log header files (single-word headers on a single line) for the various log files in FusionReactor, a monitoring tool for ColdFusion, Lucee, and any Java server.

Update May 2022: The columns have been confirmed to be accurate still with FR 8.7.7. Of course, any changes over time can be observed in past commits here.

As for the terse column header names used, note that these were the values that the FR team originally provided when versions of FR (before 5, I think) included a headers text file for each different log file. They stopped doing that years ago, but folks (inluding myself) leveraged those header files for use with tools like Log Parser, etc. (See below.) As such, as much as I think longer names could make sense for those new to the logs, I kept the header names as the FR team had created them, for backward compatibility with any such existing uses of these header files.

For more on the FR logs

For more on the FR logs (and descriptions of each log as well as its columns, from which these header files are being created), see https://docs.fusion-reactor.com/Logs/Logs/.

Why the headers can be valuable

These log header files can be valuable when using tools to analyze the logs, such as Microsoft Excel (or OpenOffice Calc) as well as Microsoft Log Parser command line tool. Besides available docs on using Excel with FR logs, I've written in the past about using such tools with FusionReactor log files in the past, or done presentations on them, as offered either at my own site, http://www.carehart.org, or at the webinars area of the FusionReactor site, https://www.fusion-reactor.com/webinars.

FR Archive Viewer does diminish need for these headers

I should note that since FR 7.2, there's a useful new log archive viewer feature which relieves somewhat the need to store know these header, since its "spreadsheet" view offers human-readable headings for each col of each log. But there can still value in analyzing the logs using those other analytical tools (like Excel/OpenOffice Calc).

Thanks to JC, who started the repo, and why I forked it

Thanks to JCSuthe, who had started this effort in 2015, at the project https://github.com/JCSuthe/Fusion-Reactor-Coldfusion-Log-Tools. I had proposed new header files that he did not have (pretty fundamental ones, like request, jdbc, and resource) and offered pull requests, but after several months of no response, I decided to fork the project.

I'm also removing from here various files he'd created offering SQL to import the logs into a database. Again, he had only a few, and it doubles the effort in keeping the files up to date, should the formats change in FusionReactor. It's an interesting idea, to store them in a database, but I will also note that there are similar solutions doing that from the FusionReactor folks, including FusionAnalytics and FusionReactor Cloud.

As such, for now, I just want in this project to focus on getting all the logs tracked (and keeping them updated). I've renamed the project accordingly. If somebody wants to take up the effort of creating and updating SQL scripts for the logs (like JC had done), I would be happy to accept them into the repo.

Other contributes welcomes

And of course I welcome contributions from any others interested in adding still more FR log header files, as well as keeping them updated.** Look for the file names and/or structure of the project to change over time, to accomodate different versions and kinds of files.

About

FusionReactor Log Headers (for ColdFusion, Lucee, Java)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published