threadscope: A graphical tool for profiling parallel Haskell programs.

[ bsd3, development, profiling, program, trace ] [ Propose Tags ] [ Report a vulnerability ]

ThreadScope is a graphical viewer for thread profile information generated by the Glasgow Haskell compiler (GHC).

The Threadscope program allows us to debug the parallel performance of Haskell programs. Using Threadscope we can check to see that work is well balanced across the available processors and spot performance issues relating to garbage collection or poor load balancing.


[Skip to Readme]

Downloads

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Versions [RSS] 0.1, 0.1.1, 0.1.2, 0.1.3, 0.2.0, 0.2.1, 0.2.2, 0.2.3, 0.2.4, 0.2.5, 0.2.6, 0.2.7, 0.2.8, 0.2.9, 0.2.10, 0.2.11, 0.2.11.1, 0.2.12, 0.2.13, 0.2.14, 0.2.14.1
Change log CHANGELOG.md
Dependencies array (<0.6), base (>=4.10 && <5), binary (<0.11), bytestring (<0.13), cairo (<0.14), containers (>=0.2 && <0.8), deepseq (>=1.1), file-embed (<0.1), filepath (<1.6), ghc-events (>=0.13 && <0.21), glib (<0.14), gtk (>=0.12 && <0.16), mtl (<2.4), pango (<0.14), template-haskell (<2.24), temporary (>=1.1 && <1.4), text (<2.2), time (>=1.1 && <1.15), unix (>=2.3 && <2.9) [details]
Tested with ghc ==8.8.4, ghc ==8.10.7, ghc ==9.0.2, ghc ==9.2.8, ghc ==9.4.8, ghc ==9.6.6, ghc ==9.8.4, ghc ==9.10.1, ghc ==9.12.1
License BSD-3-Clause
Copyright 2009-2010 Satnam Singh, 2009-2011 Simon Marlow, 2009 Donnie Jones, 2011-2012 Duncan Coutts, 2011-2014 Mikolaj Konarski, 2011 Nicolas Wu, 2011 Eric Kow
Author Satnam Singh <s.singh@ieee.org>, Simon Marlow <marlowsd@gmail.com>, Donnie Jones <donnie@darthik.com>, Duncan Coutts <duncan@well-typed.com>, Mikolaj Konarski <mikolaj@well-typed.com>, Nicolas Wu <nick@well-typed.com>, Eric Kow <eric@well-typed.com>
Maintainer Simon Marlow <marlowsd@gmail.com>
Revised Revision 3 made by teo at 2024-12-23T10:47:04Z
Category Development, Profiling, Trace
Home page http://www.haskell.org/haskellwiki/ThreadScope
Bug tracker https://github.com/haskell/ThreadScope/issues
Source repo head: git clone git@github.com:haskell/ThreadScope.git
Uploaded by MitsutoshiAoe at 2022-05-10T15:07:55Z
Distributions Debian:0.2.13, FreeBSD:0.2.7, NixOS:0.2.14.1
Reverse Dependencies 1 direct, 0 indirect [details]
Executables threadscope
Downloads 19223 total (65 in the last 30 days)
Rating 2.25 (votes: 2) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2022-05-10 [all 2 reports]

Readme for threadscope-0.2.14.1

[back to package description]

ThreadScope

Hackage Hackage-Deps CI

Using pre-built binaries

Currently pre-built binaries for the following platforms are provided:

  • Ubuntu 18.04 (64-bit)
  • macOS 10.15
  • Windows Server 2019 (x64)

GTK+2 needs to be installed for these binaries to work.

On Windows, the MSYS2 is the recommended way to install GTK+2. In MSYS2 MINGW64 shell:

pacman -S $MINGW_PACKAGE_PREFIX-gtk2

then you can run the threadscope binary from the shell.

Building from source

Use git clone or cabal get threadscope to get the source and move into the threadscope directory.

Linux

GTK+2 is required to be installed. On Ubuntu-like systems:

sudo apt install libgtk2.0-dev

Then you can build threadscope using cabal:

cabal v2-build   # to only build the project, or
cabal v2-install # to build and install the binary

Or using stack:

stack build   # to only build the project, or
stack install # to build and install the binary

macOS

GTK+ is required:

brew install gtk+

Then you can build threadscope using cabal:

cabal --project-file=cabal.project.osx v2-build   # to only build the project, or
cabal --project-file=cabal.project.osx v2-install # to build and install the binary

Or using stack:

stack --stack-yaml=stack.osx.yaml build   # to only build the project, or
stack --stack-yaml=stack.osx.yaml install # to install the binary

Windows

Chocolatey can be used to install GHC and MSYS2 is the recommended way to install GTK+.

choco install ghc
refreshenv
set PATH=C:\\msys64\\mingw64\\bin;C:\\msys64\\usr\\bin;%PATH%
pacman -Sy mingw-w64-x86_64-gtk2

then you can build threadscope using cabal:

cabal v2-build

Or you can use stack instead.

CAVEAT: gtk2 needs to be installed twice: one for stack's MSYS2 environment and another for local MSYS2 environment.

In command prompt:

stack setup
stack exec -- pacman --needed -Sy bash pacman pacman-mirrors msys2-runtime msys2-runtime-devel
stack exec -- pacman -Syu
stack exec -- pacman -Syuu
stack exec -- pacman -S base-devel mingw-w64-x86_64-pkg-config mingw-w64-x86_64-toolchain mingw-w64-x86_64-gtk2
stack install

Then in MSYS2 MINGW64 shell:

pacman -S $MINGW_PACKAGE_PREFIX-gtk2
echo 'export PATH=$APPDATA/local/bin:$PATH' >> .profile
source .profile
threadscope

Building using stack is not tested in CI. If you find any issues with building with stack, please update the instructions and send a PR.