Skip to content

Commit c5c191f

Browse files
committed
Add joss paper
1 parent 8003f49 commit c5c191f

File tree

2 files changed

+118
-0
lines changed

2 files changed

+118
-0
lines changed

paper.bib

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
@article{Soldani2018microservice,
2+
title = {The pains and gains of microservices: A Systematic grey literature review},
3+
journal = {Journal of Systems and Software},
4+
volume = {146},
5+
pages = {215-232},
6+
year = {2018},
7+
doi = {10.1016/j.jss.2018.09.016},
8+
author = {Jacopo Soldani and Damian Andrew Tamburri and Willem-Jan {Van Den Heuvel}}
9+
}
10+
11+
@article{Soldani2022rcasurvey,
12+
author = {Soldani, Jacopo and Brogi, Antonio},
13+
title = {Anomaly Detection and Failure Root Cause Analysis in (Micro) Service-Based Cloud Applications: A Survey},
14+
year = {2022},
15+
volume = {55},
16+
number = {3},
17+
doi = {10.1145/3501297},
18+
journal = {ACM Computing Surveys}
19+
}
20+
21+
22+
@inproceedings{pham2024baro,
23+
title = {BARO: Robust Root Cause Analysis for Microservices via Multivariate Bayesian Online Change Point Detection},
24+
author = {Pham, Luan and Ha, Huong and Zhang, Hongyu},
25+
booktitle = {Proceedings of the ACM on Software Engineering},
26+
volume = {1},
27+
number = {FSE},
28+
pages = {2214--2237},
29+
year = {2024},
30+
doi = {10.1145/3660810}
31+
}
32+
33+
@article{Xin2023CausalRCA,
34+
title = {CausalRCA: Causal inference based precise fine-grained root cause localization for microservice applications},
35+
journal = {Journal of Systems and Software},
36+
volume = {203},
37+
pages = {111724},
38+
year = {2023},
39+
doi = {10.1016/j.jss.2023.111724},
40+
author = {Ruyue Xin and Peng Chen and Zhiming Zhao}
41+
}
42+
43+
@inproceedings{pham2024root,
44+
title = {Root Cause Analysis for Microservices based on Causal Inference: How Far Are We?},
45+
author = {Pham, Luan and Ha, Huong and Zhang, Hongyu},
46+
booktitle = {Proceedings of the 39th IEEE/ACM International Conference on Automated Software Engineering},
47+
pages = {706--715},
48+
year = {2024},
49+
doi = {10.1145/3691620.3695063}
50+
}
51+
52+
@inproceedings{pham2025rcaeval,
53+
title = {RCAEval: A Benchmark for Root Cause Analysis of Microservice Systems with Telemetry Data},
54+
author = {Pham, Luan and Zhang, Hongyu and Ha, Huong and Salim, Flora and Zhang, Xiuzhen},
55+
booktitle = {Companion Proceedings of the ACM Web Conference 2025},
56+
pages = {777--780},
57+
year = {2025},
58+
doi = {10.1145/3701716.3715290}
59+
}
60+
61+
@inproceedings{altenbernd2025amocrca,
62+
title={Amocrca: at most one change segmentation and relative correlation ranking for root cause analysis},
63+
author={Altenbernd, Anton and Wu, Zhiyuan and Kao, Odej},
64+
booktitle={Proceedings of the 33rd ACM International Conference on the Foundations of Software Engineering},
65+
pages={1386--1393},
66+
year={2025}
67+
}

paper.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: 'RCAEval: A Benchmark for Multimodal Root Cause Analysis'
3+
tags:
4+
- Python
5+
- root cause analysis
6+
- multimodal data
7+
- benchmark
8+
- telemetry data
9+
- causal inference
10+
authors:
11+
- name: Luan Pham
12+
orcid: 0000-0001-7243-3225
13+
affiliation: "1"
14+
affiliations:
15+
- name: RMIT University, Australia
16+
index: 1
17+
date: 10 December 2025
18+
bibliography: paper.bib
19+
repository: https://github.com/phamquiluan/RCAEval
20+
archive_doi: 10.5281/zenodo.15616876
21+
---
22+
23+
# Summary
24+
25+
RCAEval is an open-source Python framework for root cause analysis (RCA) methods using multimodal data. When failures or incidents occur in software systems, engineers must quickly identify root causes from massive amounts of observable data including time-series metrics, textual logs, and topological tracing data. RCAEval addresses the lack of standardized, reproducible tools and benchmarks in this domain by providing (1) ready-to-use RCA methods spanning metric-based, trace-based, and multi-source approaches, and (2) comprehensive datasets containing 735 failure cases collected from real-world software systems.
26+
27+
RCAEval is the first framework to support many reproducible RCA tools and comprehensive benchmark datasets with diverse fault types and modality, enabling researchers to evaluate RCA methods under realistic conditions. The library is pip-installable, provides a simple Python API for running experiments, and includes standardized evaluation metrics (AC@k, Avg@k) for fair comparison across methods.
28+
29+
# Statement of need
30+
31+
Modern cloud applications generate massive amounts of telemetry data including metrics, logs, and traces [@Soldani2022rcasurvey]. When failures occur, they can propagate across multiple components, making it challenging for operators to identify root causes from the overwhelming volume of observable data. Root cause analysis (RCA) aims to pinpoint the faulty component and the specific indicators (e.g., CPU usage, error logs) responsible for the failure [@Soldani2022rcasurvey].
32+
33+
Despite growing research interest in automated RCA, the field lacks a standardized, reproducible benchmark. Existing studies typically evaluate on limited systems with few fault types, often using private datasets that prevent fair comparison [@pham2024root]. Available resources provide only single-modality analysis (e.g., metrics only) without support for multimodal data combining logs and traces. Commercial observability platforms offer RCA capabilities but are proprietary and not reproducible for research purposes.
34+
35+
RCAEval fills this gap by providing: (1) three large-scale datasets with 735 failure cases across three software systems, covering resource faults (CPU, memory, disk), network faults (delay, packet loss), and code-level faults; (2) multimodal telemetry data including metrics, logs, and traces; (3) 15 reproducible RCA tools implementations including state-of-the-art methods, e.g., BARO [@pham2024baro] and CausalRCA [@Xin2023CausalRCA]; and (4) standardized evaluation metrics for consistent comparison.
36+
37+
RCAEval targets researchers developing new RCA algorithms, practitioners evaluating methods for production deployment, and educators teaching AIOps and site reliability engineering concepts.
38+
39+
# State of the field
40+
41+
Several tools and datasets exist for RCA, but none provide comprehensive coverage of multimodal telemetry with reproducible methods. Existing libraries focus on metric-based RCA, supporting methods like Bayesian networks and Granger causality, but lack support for log and trace analysis. Available datasets provide limited fault types and no benchmarking framework for systematic evaluation. Commercial observability platforms offer automated root cause analysis features, but their proprietary nature prevents reproducible research comparisons.
42+
43+
RCAEval distinguishes itself by providing the first open-source benchmark framework that combines 15 reproducible RCA tools [@pham2025rcaeval] with large-scale datasets with multimodal observability data. This enables fair, systematic comparison of RCA methods under realistic failure scenarios.
44+
45+
![Overview of RCAEval benchmark framework.\label{fig:overview}](docs/readme.jpg){ width=100% }
46+
47+
# Acknowledgements
48+
49+
We acknowledge contributions from the open-source community and the developers of the software systems (Online Boutique, Sock Shop, Train Ticket) used in our benchmark datasets.
50+
51+
# References

0 commit comments

Comments
 (0)