{"id":13581755,"url":"https://github.com/urjitbhatia/cozgo","last_synced_at":"2025-12-25T15:28:57.351Z","repository":{"id":57507634,"uuid":"212443645","full_name":"urjitbhatia/cozgo","owner":"urjitbhatia","description":"Coz profiler Golang wrapper - Coz employs a novel technique we call causal profiling that measures optimization potential.","archived":false,"fork":false,"pushed_at":"2024-07-03T22:45:55.000Z","size":9,"stargazers_count":140,"open_issues_count":1,"forks_count":11,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-05T21:45:06.394Z","etag":null,"topics":["go","golang","optimization","performance","profiler"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/urjitbhatia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-02T21:21:17.000Z","updated_at":"2024-10-19T16:18:23.000Z","dependencies_parsed_at":"2024-11-05T21:43:40.244Z","dependency_job_id":null,"html_url":"https://github.com/urjitbhatia/cozgo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urjitbhatia%2Fcozgo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urjitbhatia%2Fcozgo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urjitbhatia%2Fcozgo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urjitbhatia%2Fcozgo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/urjitbhatia","download_url":"https://codeload.github.com/urjitbhatia/cozgo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247470486,"owners_count":20944146,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","optimization","performance","profiler"],"created_at":"2024-08-01T15:02:13.586Z","updated_at":"2025-12-25T15:28:57.308Z","avatar_url":"https://github.com/urjitbhatia.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# coz-go\n\nCoz profiler Golang wrapper.\n\nThis is a golang wrapper around the `Coz` profiler here: https://github.com/plasma-umass/coz\n\n### Code Usage {#code-usage}\n\n| Coz Call      | Equivalent CozGo Call | Description |\n| ----------- | -----------   | ----------- | \n| COZ_BEGIN(\"name\")   | cozgo.Begin(\"name\")   | Begin a latency profiling block identified by the name |\n| COZ_END(\"name\")     | cozgo.End(\"name\")     | End a latency profiling block identified by the name|\n| COZ_PROGRESS()     | cozgo.Progress()     | Specify a progress point within a block of work|\n| COZ_PROGRESS()     | cozgo.NamedProgress(\"name\")     | Specify a named progress point within a block of work|\n\n## For background on causal profiling, see\n\nPaper: http://www.sigops.org/s/conferences/sosp/2015/current/2015-Monterey/printable/090-curtsinger.pdf\n\nBlog: https://morsmachine.dk/causalprof\n\n## Running/Usage\n\n- Install Coz: https://github.com/plasma-umass/coz\n    - For OS X users, the easiest way is to run a docker image with linux and install Coz\n    - 'apt update; apt install coz-profiler'\n- Import `cozgo`: `import \"github.com/urjitbhatia/cozgo\"`\n- Call the `Coz` wrappers in your application\n    - See the [Code Usage Section above](#code-usage)\n- Build your `go` binary with the flags: `-ldflags=-compressdwarf=false -gcflags=all=\"-N -l\"` so that Coz can identify\n  the debug symbols properly\n- Run your application with Coz: `coz run --- yourGoBinary`\n- Let the application run for a while (you might want to run some load test etc, so that the profiler can pick up usage\n  data)\n- By default, Coz will create a file called `profile.coz`\n- Use the Coz viewer to analyze the profile\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furjitbhatia%2Fcozgo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furjitbhatia%2Fcozgo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furjitbhatia%2Fcozgo/lists"}