Skip to content

Commit d102245

Browse files
FindHaofacebook-github-bot
authored andcommitted
Update CHANGELOG and README for version 0.1.1 enhancements (#41)
Summary: ### Changes: - Updated CHANGELOG.md to reflect the new version 0.1.1, detailing added features such as `launch_diff` event generation, kernel-centric event grouping, and enhanced logging capabilities. - Revised README.md to include updated links and descriptions for new features, particularly the `launch_diff` analysis and structured logging improvements. - Adjusted example code in README to demonstrate the new `enable_trace_launch` parameter in the logging initialization. These updates improve documentation clarity and highlight recent enhancements to the TritonParse tool. Pull Request resolved: #41 Reviewed By: Sibylau Differential Revision: D78769075 Pulled By: FindHao fbshipit-source-id: 326ff3ec52a6da7691efb536153795a25cb1fb57
1 parent dba8936 commit d102245

File tree

5 files changed

+19
-7
lines changed

5 files changed

+19
-7
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,7 @@ parsed_output/
5757
!tests/example_output/logs/**
5858
!tests/example_output/parsed_output/**
5959
!tests/example_output/parsed_output_complex/**
60+
!website/public/**
6061
.tox/
6162
.nox/
6263
.hypothesis/

CHANGELOG.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,16 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8-
## [0.1.0] - 2024-07-31
8+
## [0.1.1] - 2025-07-22
9+
10+
### Added
11+
12+
- **Launch Difference Analysis**: A new `launch_diff` event is automatically generated for each kernel, providing a concise summary of how launch parameters vary across different calls. This helps to quickly identify changes in kernel arguments, grid dimensions, and other metadata.
13+
- **Kernel-Centric Event Grouping**: The parser now intelligently groups compilation and launch events by kernel, making it easier to analyze the entire lifecycle of a specific kernel.
14+
- **Launch Event Tracing Control**: Added an `enable_trace_launch` parameter to `tritonparse.structured_logging.init` to give users explicit control over whether to trace kernel launch events.
15+
- **Enhanced Logging and Testing**: Improved the structured logging initialization and expanded test coverage to verify the correctness of `launch` and `compilation` event counts.
16+
17+
## [0.1.0] - 2025-07-21
918

1019
This is the initial public release of TritonParse.
1120

README.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,15 @@
55

66
**A comprehensive visualization and analysis tool for Triton IR files** — helping developers analyze, debug, and understand Triton kernel compilation processes.
77

8-
🌐 **[Try it online →](https://pytorch-labs.github.io/tritonparse/?json_url=https%3A%2F%2Fpytorch-labs.github.io%2Ftritonparse%2Ff0_fc0_a0_cai-.ndjson)**
8+
🌐 **[Try it online →](https://pytorch-labs.github.io/tritonparse/?json_url=https%3A%2F%2Fpytorch-labs.github.io%2Fdedicated_log_triton_trace_findhao__mapped.ndjson.gz)**
99

1010
## ✨ Key Features
1111

12+
- **🚀 Launch Difference Analysis** - Automatically detect and visualize variations in kernel launch parameters, helping you pinpoint performance bottlenecks and debug launch configurations.
1213
- **🔍 Interactive Visualization** - Explore Triton kernels with detailed metadata and stack traces
1314
- **📊 Multi-format IR Support** - View TTGIR, TTIR, LLIR, PTX, and AMDGCN in one place
1415
- **🔄 Side-by-side Comparison** - Compare IR stages with synchronized highlighting
15-
- **📝 Structured Logging** - Capture detailed compilation events with source mapping
16+
- **📝 Structured Logging** - Capture detailed compilation and launch events with source mapping
1617
- **🌐 Ready-to-use Interface** - No installation required, works in your browser
1718
- **🔒 Privacy-first** - All processing happens locally in your browser, no data uploaded
1819

@@ -23,8 +24,8 @@
2324
```python
2425
import tritonparse.structured_logging
2526

26-
# Initialize logging
27-
tritonparse.structured_logging.init("./logs/")
27+
# Initialize logging with launch tracing enabled
28+
tritonparse.structured_logging.init("./logs/", enable_trace_launch=True)
2829

2930
# Your Triton/PyTorch code here
3031
# ... your kernels ...
@@ -55,7 +56,8 @@ INFO:tritonparse:Copying parsed logs from /tmp/tmp1gan7zky to /scratch/findhao/t
5556

5657
### 2. Visualize Results
5758

58-
**Visit [https://pytorch-labs.github.io/tritonparse/](https://pytorch-labs.github.io/tritonparse/?json_url=https%3A%2F%2Fpytorch-labs.github.io%2Ftritonparse%2Ff0_fc0_a0_cai-.ndjson)** and open your local trace files (.ndjson.gz format).
59+
**Visit [https://pytorch-labs.github.io/tritonparse/](https://pytorch-labs.github.io/tritonparse/?json_url=https%3A%2F%2Fpytorch-labs.github.
60+
io%2Ftritonparse%dedicated_log_triton_trace_findhao__mapped.ndjson.gz)** and open your local trace files (.ndjson.gz format).
5961

6062
> **🔒 Privacy Note**: Your trace files are processed entirely in your browser - nothing is uploaded to any server!
6163
Binary file not shown.

website/src/App.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ function App() {
154154
* Loads the default data file from public directory
155155
*/
156156
const loadDefaultData = async () => {
157-
const logFile = "./f0_fc0_a0_cai-.ndjson";
157+
const logFile = "./dedicated_log_triton_trace_findhao__mapped.ndjson.gz";
158158
await loadData(logFile);
159159
};
160160

0 commit comments

Comments
 (0)