https://github.com/czukowski/tracy-log-parser
LogParser COM Plug-In for reading Tracy Debugger Log Files
https://github.com/czukowski/tracy-log-parser
log-parser nette tracy
Last synced: about 2 months ago
JSON representation
LogParser COM Plug-In for reading Tracy Debugger Log Files
- Host: GitHub
- URL: https://github.com/czukowski/tracy-log-parser
- Owner: czukowski
- License: mit
- Created: 2017-03-24T16:06:29.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-03-27T08:01:52.000Z (about 9 years ago)
- Last Synced: 2025-03-20T22:18:55.578Z (over 1 year ago)
- Topics: log-parser, nette, tracy
- Size: 6.84 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
LogParser COM Plug-In for reading Tracy Debugger Log Files
==========================================================
This package makes it possible to view and query log files written by [Tracy Debugger][tracy],
part of the [Nette Framework][nette] for PHP, using [Microsoft Log Parser][logparser].
A COM Plug-In is implemented to parse Tracy log files. Obviously, it'll work only on Windows.
Installation and Usage
----------------------
After you've downloaded the SCT file from this package, it must be registered using the following syntax:
```sh
%SystemRoot%\Syswow64\regsvr32 Tracy.LogParser.Scriptlet.sct
```
Note the path to regsvr32 executable used, it is needed to work correctly on 64bit Windows. Regsvr32 expects
a valid path to the SCT file, so either run the command from the directory where you've placed the file or use
the full path.
To use the Plug-In, run Log Parser with parameters that tell it to use this COM Plug-In, for example:
```sh
logparser "SELECT * FROM 'C:\foo\exception.log' WHERE TO_DATE(DateTime) = SYSTEM_DATE()" -i:COM -iProgID:Tracy.LogParser.Scriptlet
```
To unregister the Plug-In, use this command:
```sh
%SystemRoot%\Syswow64\regsvr32 /u Tracy.LogParser.Scriptlet.sct
```
About
-----
Tracy log files contain the following notable features:
```
DateTime Message @ Request [ @@ ExceptionFile]
```
* `DateTime` in `[YYYY-MM-DD HH:MM:SS]` format (wrapped in square brackets)
* `Message` is any text message, for error and exception logs this is the respective error message
* `Request` is a request URL or CLI command that have originally executed the script, separated by ` @ `
from the previous part
* `ExceptionFile`, only found in exception logs, states a file name, in which exception details, such
as stack trace, can be found. It is separated by ` @@ ` from the previous part.
This COM Plug-In is heavily based on tutorials by [Robert McMurray][robmcm] on Microsoft blog, especially:
* [Advanced Log Parser Charts Part 4 � Adding Custom Input Formats][tutorial-part-4]
* [Advanced Log Parser Part 6 � Creating a Simple Custom Input Format Plug-In][tutorial-part-6]
* [Advanced Log Parser Part 7 � Creating a Generic Input Format Plug-In][tutorial-part-7]
It would not have been possible to create this Plug-In without these. Also, last time I was writing
anything in VB was well more than 10 years ago, so there are bound to be some gotchas with this work.
License
-------
This work is released under the MIT License. See LICENSE.md for details.
[logparser]: https://technet.microsoft.com/en-us/scriptcenter/dd919274.aspx
[nette]: https://nette.org/en/
[robmcm]: https://social.msdn.microsoft.com/profile/robmcm
[tracy]: https://tracy.nette.org/en/
[tutorial-part-4]: https://blogs.msdn.microsoft.com/robert_mcmurray/2012/05/25/advanced-log-parser-charts-part-4-adding-custom-input-formats/
[tutorial-part-6]: https://blogs.msdn.microsoft.com/robert_mcmurray/2013/02/27/advanced-log-parser-part-6-creating-a-simple-custom-input-format-plug-in/
[tutorial-part-7]: https://blogs.msdn.microsoft.com/robert_mcmurray/2013/02/28/advanced-log-parser-part-7-creating-a-generic-input-format-plug-in/