eventlog2html: Visualise an eventlog

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain]

eventlog2html is a library for visualising eventlogs. At the moment, the intended use is to visualise eventlogs which have heap profiling events, as a replacement to hp2ps and hp2pretty. eventlog2html creates a static webpage which contains a collection of different interactive charts for analysing heap usage. Trace events are displayed on the chart and the charts can be zoomed, scrolled and filtered to give a more exploratory feel to heap profile analysis.


[Skip to ReadMe]

Properties

Versions0.1.0, 0.2.0, 0.2.0, 0.3.0, 0.4.0
Change logCHANGELOG
Dependenciesaeson (>=1.4.3 && <1.5), array (>=0.5.3 && <0.6), attoparsec (>=0.13.2 && <0.14), base (==4.*), blaze-html (>=0.9.1 && <0.10), bytestring (>=0.10.8 && <0.11), containers (>=0.6.0 && <0.7), eventlog2html, file-embed (>=0.0.11 && <0.1), filepath (>=1.4.2 && <1.5), ghc-events (>=0.8.0 && <0.10), hashtables (>=1.2.3 && <1.3), hvega (>=0.2.0 && <0.3), mtl (>=2.2.2 && <2.3), optparse-applicative (>=0.14.3 && <0.15), semigroups (>=0.18 && <0.20), text (>=1.2.3 && <1.3), time (>=1.8.0 && <2.0) [details]
LicenseBSD-3-Clause
Copyright(C) 2010,2011,2015,2017,2018 Claude Heiland-Allen 2019 Matthew Pickering
AuthorMatthew Pickering, David Binder, Claude Heiland-Allen
Maintainermatthewtpickering@gmail.com
CategoryDevelopment
Home pagehttps://mpickering.github.io/eventlog2html
Bug trackerhttps://github.com/mpickering/eventlog2html/issues
Source repositoryhead: git clone https://github.com/mpickering/eventlog2html.git
Executableseventlog2html
UploadedFri Jul 5 08:30:43 UTC 2019 by mpickering

Modules

[Index]

Downloads

Maintainers' corner

For package maintainers and hackage trustees


Readme for eventlog2html-0.2.0

[back to package description]

eventlog2html

Interactive Documentation

Build Status Hackage

eventlog2html is a tool to visualise eventlogs. In particular, it creates interactive charts for the heap profiling information included in the eventlog.

The complete documentation contain interactive examples and complete usage information.

How to use

The tool produces a static webpage to visualise the heap profile. For an eventlog program.eventlog, a static page titled program.eventlog.html will be created adjacent to the original file.

In order to use eventlog2html you first need an eventlog with heap profiling samples.

Compile your program with -prof. In a cabal project, the easiest way to do this is to set profiling: True in the cabal.project file.

Then, run your program with the normal profiling flags with an additional -l flag. This will tell GHC to also emit the eventlog.

my-leaky-program +RTS -hy -l-au

In the current directory a file my-leaky-program.eventlog will be produced. This is what you need to pass to eventlog2html to generate the profiling graphs.

eventlog2html my-leaky-program.eventlog

Note: The -l-au suffix will result in a significantly smaller eventlog as it will not include thread events. This makes a big difference for multi-threaded applications.

Building the project

There are two supported ways to build the project: cabal new-build and nix. For development the normal cabal new-build workflow should work fine.

There are also nix files provided which can build both the tool and documentation. Binary caches are populated by CI.

cachix use mpickering
nix build -f . eventlog2html
nix build -f . site

Using nix means that you can conveniently try the project using

nix run -f https://github.com/mpickering/eventlog2html/archive/master.tar.gz eventlog2html -c eventlog2html my-leaky-program.eventlog

Fixing CI

If we need a newer version of a dependency then it might be necessary to update the index-state which haskell.nix uses to compute the build plan.

All this requires is updating the date in build.nix to something more recent. The index-state-hashes are updated once a day so you might have to choose a date from a few days ago rather than the current date.

Modifying Documentation

The documentation for the project is located in the docs folder. It is a hakyll site built by the generator in the hakyll-eventlog folder. CI automatically builds and deploys changes to the documentation.

Additional examples can be added by adding an eventlog to the examples subdirectory. They will automatically be added to the examples gallery.

You can build the documentation using the nix target or using cabal new-build hakyll-eventlog and invoking the resulting executable in the docs/ directory.

There is a custom pandoc filter which can insert rendered eventlogs into the documentation. To understand how this works it's probably easiest to read the code or copy the existing examples.