README.md

nimcoz

This is a Nim Wrapper For Coz Profiler

For Background on Causal Profiling:

• Introduction: https://mattwarren.org/2016/03/30/Coz-Finding-Code-that-Counts-with-Causal-Profiling/
• Paper: http://www.sigops.org/s/conferences/sosp/2015/current/2015-Monterey/printable/090-curtsinger.pdf
• Video: "Performance Matters" by Emery Berger
• Video: Coz: finding code that counts with causal profiling

Usage

• Install Coz: https://github.com/plasma-umass/coz

  • Linux: apt install coz-profiler
  • OS X: Easiest way is to run a docker image with Linux and install Coz

• Setup

  • Install nimcoz: nimble install https://github.com/s0kil/nimcoz
  • Specify Progress Points In Your Program:
    • Docs
    • Where to place progress points

• Build

  • nim c --debuginfo:on --debugger:native --passC:"-gdwarf-3" --passL:"-ldl" program.nim

• Run

  • coz run --- ./program

• View Profile

  • Load profile.coz into https://plasma-umass.org/coz/
  • Or Locally: xdg-open /usr/share/coz-profiler/viewer/index.htm

Related

• https://github.com/urjitbhatia/cozgo
• https://github.com/alexcrichton/coz-rs
• https://github.com/filipesilva/node-coz