Workshops Archive

Instrumentor: Customizable and Generic Instrumentation for LLVM


Workshop: LLVM-HPC2026: The Twelfth Workshop on the LLVM Compiler Infrastructure in HPC

Authors: Johannes Doerfert (Lawrence Livermore National Laboratory), Ethan Luis McDonough (Independent Researcher), Ivan R. Ivanov (Institute of Science Tokyo), and Kevin Sala (Lawrence Livermore National Laboratory)

Abstract: Instrumentation-based tools are essential for developing high-performance, efficient, and correct codebases in HPC and AI domains. However, code instrumentation mechanisms remain highly fragmented across compiler infrastructures, and LLVM is no exception. Building these tools usually requires developing custom LLVM passes, a tedious and repetitive task that demands deep knowledge of compiler internals. In this paper, we introduce the LLVM Instrumentor, a generic and customizable LLVM pass that instruments IR driven by user-provided configurations. The Instrumentor, configurable through a JSON file or programmatically, simplifies the development of new instrumentation-based tools by providing a wide coverage of instrumentation features. To demonstrate its versatility and ease of use, we present several instrumentation tools built with just a few lines of JSON configuration and runtime code.


Back to LLVM-HPC2026: The Twelfth Workshop on the LLVM Compiler Infrastructure in HPC Archive Listing

Back to Full Workshop Archive Listing