clj-async-profiler.core — com.clojure-goes-fast/clj-async-profiler 1.3.0

async-profiler-agent-path clj

attach-agent clj

(attach-agent pid command-string)

clear-results clj

(clear-results)

Clear all results from /tmp/clj-async-profiler directory.

find-profile clj

(find-profile run-id-or-stacks-file)

generate-diffgraph clj

(generate-diffgraph profile-before profile-after options)

Generate a diff flamegraph from two profiles, identified either by their file paths or IDs. For available options, see stop.

generate-flamegraph clj

(generate-flamegraph run-id-or-stacks-file options)

Generate flamegraph from a collapsed stacks file, identified either by its file path or numerical ID. For available options, see stop.

get-self-pid clj

(get-self-pid)

list-event-types clj

(list-event-types)

(list-event-types options)

Print all event types that can be sampled by the profiler. Available options:

:pid - process to attach to (default: current process) :silent? - if true, only return the event types, don't print them.

print-jvm-opt-for-startup-profiling clj

(print-jvm-opt-for-startup-profiling options)

Generate a JVM option string that can be used to profile a JVM application completely from its start to finish. Prints further instructions to stdout. Accepts the same options map as start.

profile clj macro

(profile options? & body)

Profile the execution of body. If the first argument is a map, treat it as options. For available options, see start and stop. :pid option is ignored, current process is always profiled. Additional options:

:return-file - if true, return the generated flamegraph file, otherwise return the value returned by body (default: false - return value)

profile-for clj

(profile-for duration-in-seconds)

(profile-for duration-in-seconds options)

Run the profiler for the specified duration. Return the generated flamegraph file. For available options, see start and stop.

serve-ui clj

(serve-ui port)

(serve-ui host port)

Start profiler web UI on the given host (default: localhost) and port.

set-default-profiling-options clj

(set-default-profiling-options default-options-map)

Set the map of default options that will be used for all subsequent profiling runs. Defaults will be merged with explicit options with lower priority.

start clj

(start)

(start options)

Start the profiler. Available options:

:pid - process to attach to (default: current process) :interval - sampling interval in nanoseconds (default: 1000000 - 1ms) :framebuf - size of the buffer for stack frames (default: 1000000 - 1MB) :threads - profile each thread separately :features - a list of extra features to enable. Supported features: :vtable - show targets of vtable/itable calls :comptask - show JIT compilation task :event - event to profile, see list-event-types (default: :cpu)

status clj

(status)

(status options)

Get profiling agent status. Available options:

:pid - process to attach to (default: current process)

stop clj

(stop)

(stop options)

Stop the currently running profiler and save the results into a text file. If flamegraph is generated next, the flamegraph file will be returned, otherwise the text file is returned. Available options:

:pid - process to attach to (default: current process) :generate-flamegraph? - if true, generate flamegraph in the same directory as the profile (default: true) :title - title of the generated flamegraph (optional) :predefined-transforms - a list of maps that specify the dynamic transforms to bake into the flamegraph. For example:

... :predefined-transforms [{:type :remove :what "frame_buffer_overflow"} {:type :replace :what #"(;manifold.deferred[^;]+)+" :replacement ";manifold.deferred/..."} ...