Package org.apache.hadoop.hbase.http

Class ProfilerCommandMapper

java.lang.Object

org.apache.hadoop.hbase.http.ProfilerCommandMapper

@Private
final class ProfilerCommandMapper
extends Object

Utility class that maps ProfileServlet.ProfileRequest to async-profiler commands in both the in-process Java API format (comma-separated string) and the CLI format (argument list).

Field Summary

Fields

Modifier and Type	Field	Description
private static final org.slf4j.Logger	LOG
private static final String	OLD_PROFILER_SCRIPT
private static final String	PROFILER_SCRIPT

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ProfilerCommandMapper()

Method Summary

Modifier and Type	Method	Description
private static void	appendOption(StringBuilder sb, String key, Object value)
(package private) static List<String>	toCliCommand(ProfileServlet.ProfileRequest request, File outputFile, String profilerHome, Integer pid)	Builds the CLI argument list for invoking the async-profiler binary (asprof / profiler.sh).
(package private) static String	toFileExtension(ProfileServlet.Output output)	Maps the ProfileServlet.Output enum to a file extension / format token without emitting any log warnings.
(package private) static String	toFormatString(ProfileServlet.Output output)	Maps the ProfileServlet.Output enum to the format string used by both backends.
(package private) static String	toLibraryStartCommand(ProfileServlet.ProfileRequest request)	Builds the start command string for the async-profiler Java API.
(package private) static String	toLibraryStopCommand(ProfileServlet.ProfileRequest request, File outputFile)	Builds the stop command string for the async-profiler Java API.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

LOG

private static final org.slf4j.Logger LOG

PROFILER_SCRIPT

private static final String PROFILER_SCRIPT

See Also:

• Constant Field Values

OLD_PROFILER_SCRIPT

private static final String OLD_PROFILER_SCRIPT

See Also:

• Constant Field Values

Constructor Details

ProfilerCommandMapper

private ProfilerCommandMapper()

Method Details

toLibraryStartCommand

static String toLibraryStartCommand(ProfileServlet.ProfileRequest request)

Builds the start command string for the async-profiler Java API. Format: start,event=<event>[,interval=N][,jstackdepth=N][,threads][,simple]

Note: bufsize is intentionally omitted — it is not a recognized option in the async-profiler 4.x agent grammar and is silently ignored. It remains supported by the BinaryBackend CLI path via -b.

toLibraryStopCommand

static String toLibraryStopCommand(ProfileServlet.ProfileRequest request,
 File outputFile)

Builds the stop command string for the async-profiler Java API. Format: stop,file=<path>[,<format-token>][,minwidth=N][,reverse]

In async-profiler 4.x the output format is derived from the file extension for html/jfr, and via a bare token (e.g. tree, flat) for text-based formats. The format= key is not recognized. width and height are also not recognized by the 4.x agent grammar; they remain supported via the BinaryBackend CLI.

toCliCommand

static List<String> toCliCommand(ProfileServlet.ProfileRequest request,
 File outputFile,
 String profilerHome,
 Integer pid)

Builds the CLI argument list for invoking the async-profiler binary (asprof / profiler.sh). Locates the script under <profilerHome>/bin/asprof, falling back to <profilerHome>/profiler.sh for older installations.

toFormatString

static String toFormatString(ProfileServlet.Output output)

Maps the ProfileServlet.Output enum to the format string used by both backends. Logs a deprecation warning when SVG is requested (it was removed in async-profiler 2.0, see HBASE-25685). Use toFileExtension(org.apache.hadoop.hbase.http.ProfileServlet.Output) when only the file extension is needed and the warning has already been emitted.

toFileExtension

static String toFileExtension(ProfileServlet.Output output)

Maps the ProfileServlet.Output enum to a file extension / format token without emitting any log warnings. SVG is silently remapped to "html".

appendOption

private static void appendOption(StringBuilder sb,
 String key,
 Object value)