coz-go

Coz profiler Golang wrapper.

This is a golang wrapper around the Coz profiler here: https://github.com/plasma-umass/coz

Code Usage {#code-usage}

| Coz Call | Equivalent CozGo Call | Description | | ----------- | ----------- | ----------- | | COZ_BEGIN("name") | cozgo.Begin("name") | Begin a latency profiling block identified by the name | | COZ_END("name") | cozgo.End("name") | End a latency profiling block identified by the name| | COZ_PROGRESS() | cozgo.Progress() | Specify a progress point within a block of work| | COZ_PROGRESS() | cozgo.NamedProgress("name") | Specify a named progress point within a block of work|

For background on causal profiling, see

Paper: http://www.sigops.org/s/conferences/sosp/2015/current/2015-Monterey/printable/090-curtsinger.pdf

Blog: https://morsmachine.dk/causalprof

Running/Usage

• Install Coz: https://github.com/plasma-umass/coz
  • For OS X users, the easiest way is to run a docker image with linux and install Coz
  • 'apt update; apt install coz-profiler'
• Import cozgo: import "github.com/urjitbhatia/cozgo"
• Call the Coz wrappers in your application
  • See the Code Usage Section above
• Build your go binary with the flags: -ldflags=-compressdwarf=false -gcflags=all="-N -l" so that Coz can identify the debug symbols properly
• Run your application with Coz: coz run --- yourGoBinary
• Let the application run for a while (you might want to run some load test etc, so that the profiler can pick up usage data)
• By default, Coz will create a file called profile.coz
• Use the Coz viewer to analyze the profile