Flamegraph / Iciclegraph Java Swing component

This flamegraph component is known to be used in JDK Mission Control 9.0 and in the Datadog plugin for IntelliJ.

Usage

Example usage

var flamegraphView = new FlamegraphView<Node>();

flamegraphView.setFrameRender(
        new DefaultFrameRenderer<>(
                FrameTextsProvider.of(
                        frame -> frame.isRoot() ? "root" : frame.actualNode.getFrame().getHumanReadableShortString(),
                        frame -> frame.isRoot() ? "" : FormatToolkit.getHumanReadable(frame.actualNode.getFrame().getMethod(), false, false, false, false, true, false),
                        frame -> frame.isRoot() ? "" : frame.actualNode.getFrame().getMethod().getMethodName()
                ),
                new DimmingFrameColorProvider<>(defaultFrameColorMode.colorMapperUsing(ColorMapper.ofObjectHashUsing(defaultColorPalette.colors()))),
                FrameFontProvider.defaultFontProvider()
        )
);

jpanel.add(flamegraphView.component);


// later, fill in the data
var listOfFrames = FrameBox.flattenAndCalculateCoordinate(new ArrayList<Node>(), ...);
flamegraphView.setModel(
        new FrameModel<>(
                "title, events (CPU, Locks)", // used in the root "frame"
                (a, b) -> Objects.equals(a, b), // used to identify equal frames
                listOfFrames
        )
);

Earlier builds used to set up the view using setRenderConfiguration, this is deprecated for removal and code should be migrated to use setFrameRender instead.

Configuration Options

Method	Description	Default
setMode(Mode)	Display mode: FLAMEGRAPH (root at bottom) or ICICLEGRAPH (root at top)	ICICLEGRAPH
setFrameClickAction(FrameClickAction)	Click behavior: FOCUS_FRAME (double-click zooms) or EXPAND_FRAME (single-click expands)	FOCUS_FRAME
setShowMinimap(boolean)	Show/hide the navigation minimap	true
setShowHoveredSiblings(boolean)	Highlight identical frames elsewhere in the graph on hover	true
setTooltipTextFunction(BiFunction)	Customize tooltip text for frames	—
setPopupConsumer(BiConsumer)	Handle right-click context menu on frames	—
setSelectedFrameConsumer(BiConsumer)	Callback when a frame is selected (single-click)	—
setHoverListener(HoverListener)	Listen for frame hover events	—
highlightFrames(Set, String)	Highlight frames matching a search	—

Exporting to Image

Use FlamegraphImage to render a flamegraph to a static image (e.g., for export or reports).

Misc

Snapshot versions will be delivered at

Maven Central Portal: https://s01.oss.sonatype.org/content/repositories/snapshots/io/github/bric3/fireplace