# plasma-umass/coz

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/plasma-umass-coz).**

4,511 stars · 170 forks · C · NOASSERTION

## Links

- GitHub: https://github.com/plasma-umass/coz
- awesome-repositories: https://awesome-repositories.com/repository/plasma-umass-coz.md

## Topics

`causal-inference` `optimization` `performance-analysis` `performance-engineering` `profiler`

## Description

Coz is a suite of profiling tools for C++ applications designed to identify performance bottlenecks through causal analysis and execution tracking. It functions as a performance profiler that tracks operation timing and execution frequency to determine critical paths within a system.

The tool distinguishes itself through a causal profiling engine and an optimization simulation engine. These capabilities allow for the prediction of how hypothetical code improvements would impact overall system throughput and latency by simulating the effects of speedups without requiring the software to be rewritten and retested. Additionally, it includes an AI-powered profiling assistant that uses language models to suggest optimal locations for performance measurement points and recommend concrete code optimizations.

The system covers broad capability areas including latency and throughput measurement, source code instrumentation, and profile data filtering. It provides a web-based visualizer to render causal profile data and analyze speedup slopes in a browser.

The toolkit includes utilities for build system integration to link external projects with the profiling library and binary.

## Tags

### Development Tools & Productivity

- [Causal Profiling Instrumentation](https://awesome-repositories.com/f/development-tools-productivity/causal-profiling-instrumentation.md) — Implements macro-based source instrumentation to capture execution frequency and timing for causal bottleneck analysis. ([source](https://github.com/plasma-umass/coz/tree/master/rust))

### System Administration & Monitoring

- [Performance Profilers](https://awesome-repositories.com/f/system-administration-monitoring/performance-profilers.md) — Measures how specific code sections affect overall system throughput and latency to identify impactful bottlenecks.
- [Event Latency Measurements](https://awesome-repositories.com/f/system-administration-monitoring/event-latency-measurements.md) — Tracks the time between paired start and end points to evaluate and reduce average event duration.
- [Throughput and ETA Monitors](https://awesome-repositories.com/f/system-administration-monitoring/activity-monitors/activity-progress-monitors/task-progress-monitors/throughput-and-eta-monitors.md) — Tracks the frequency of visits to specific progress points to determine the overall rate of work completion.
- [Function Auto-Instrumentation Macros](https://awesome-repositories.com/f/system-administration-monitoring/automatic-tracing-instrumentation/function-auto-instrumentation-macros.md) — Utilizes macros to instrument source code for capturing execution frequency and timing data.
- [Transactional Latency Tracking](https://awesome-repositories.com/f/system-administration-monitoring/event-latency-measurements/transactional-latency-tracking.md) — Measures event duration by recording timestamps at designated start and end points in the source code.

### Artificial Intelligence & ML

- [AI-Powered Code Analysis Tools](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-powered-code-analysis-tools.md) — Uses language models to analyze profiling results and source code to recommend concrete code optimizations. ([source](https://github.com/plasma-umass/coz#readme))
- [Instrumentation Placement Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-driven-development-tooling/instrumentation-placement-agents.md) — Analyzes source code with an AI agent to propose the most effective locations for performance measurement points. ([source](https://github.com/plasma-umass/coz/blob/master/README.md))

### Software Engineering & Architecture

- [Code Throughput Measurement](https://awesome-repositories.com/f/software-engineering-architecture/monotonic-time-measurement/code-throughput-measurement.md) — Tracks the frequency of visits to specific progress points to determine the overall rate of work completion. ([source](https://github.com/plasma-umass/coz/blob/master/CLAUDE.md))
- [Optimization Simulators](https://awesome-repositories.com/f/software-engineering-architecture/performance-reliability/code-optimization/optimization-simulators.md) — Predicts the impact of hypothetical code improvements on system speed without needing to rewrite and retest the software.
- [Request Latency Measurement](https://awesome-repositories.com/f/software-engineering-architecture/performance-reliability/performance-engineering/latency-optimization/request-latency-measurement.md) — Calculates average transaction delays by measuring the time elapsed between paired start and end points in the source code. ([source](https://github.com/plasma-umass/coz/blob/master/CLAUDE.md))
- [Optimization Effect Simulation](https://awesome-repositories.com/f/software-engineering-architecture/performance-reliability/performance-optimization/data-handling-throughput/system-performance-optimization/optimization-effect-simulation.md) — Predicts the impact of hypothetical code improvements on throughput and latency by simulating speedups without requiring software rewrites. ([source](https://github.com/plasma-umass/coz/blob/master/pyproject.toml))

### Testing & Quality Assurance

- [Causal Performance Simulators](https://awesome-repositories.com/f/testing-quality-assurance/causal-performance-simulators.md) — Implements a causal profiling engine to predict the impact of hypothetical code improvements on system throughput.
- [Causal Profiling Tools](https://awesome-repositories.com/f/testing-quality-assurance/causal-profiling-tools.md) — Identifies bottlenecks by simulating the effect of code optimizations on throughput and latency.
- [Causal-Slope Analysis Tools](https://awesome-repositories.com/f/testing-quality-assurance/causal-slope-analysis-tools.md) — Identifies performance bottlenecks by calculating the causal slope of speedups in specific code sections.
- [Optimization Simulation Engines](https://awesome-repositories.com/f/testing-quality-assurance/optimization-simulation-engines.md) — Predicts the impact of hypothetical code improvements by slowing down other system components proportionally.
- [Performance Profilers](https://awesome-repositories.com/f/testing-quality-assurance/performance-profilers.md) — Provides a profiling system for C++ applications that tracks execution frequency and operation timing.
- [Software Bottleneck Identification](https://awesome-repositories.com/f/testing-quality-assurance/software-bottleneck-identification.md) — Analyzes execution data and source code to determine which parts of a program limit overall performance.
- [AI-Assisted Instrumentation](https://awesome-repositories.com/f/testing-quality-assurance/ai-assisted-instrumentation.md) — Uses automated agents to identify and insert performance measurement points for more accurate profiling.
- [Instrumentation Suggestions](https://awesome-repositories.com/f/testing-quality-assurance/code-quality-review/code-quality-tools/llm-analyzers/instrumentation-suggestions.md) — Uses a language model to analyze source code and propose the optimal locations for performance measurement points.
- [Profiling Data Visualizations](https://awesome-repositories.com/f/testing-quality-assurance/profiling-visualization-filters/profiling-data-visualizations.md) — Provides a web-based visualizer to render captured performance data and analyze speedup slopes.

### Part of an Awesome List

- [Profiling Assistants](https://awesome-repositories.com/f/awesome-lists/ai/ai-coding-assistants/profiling-assistants.md) — Provides an instrumentation system using language models to suggest measurement points and concrete code optimizations.