tldr-pages/tldr

Page request: asprof

Open

#21675 opened on Mar 23, 2026

View on GitHub
 (2 comments) (0 reactions) (0 assignees)Shell (30,937 stars) (2,507 forks)batch import
help wantednew command

Description

Command description

Async Profiler (asprof) is a profiler for JVM apps that attaches to processes and produces profiles. It supports a few profiling modes, output formats, thread profiling, inclusion/exclusion lists for stacks, lots of other flags.

Command details

No response

Documentation

https://github.com/async-profiler/async-profiler/tree/master/docs

Platform

Common

VCS repository link (e.g. GitHub, GitLab)

https://github.com/async-profiler/async-profiler

Additional information

Three easy starter commands from my shell history matching the core command pattern:

  • Profile a process PID for N seconds: asprof -d [N] -f [filename.html] [PID]
  • Profile a process by name with wall-clock timing: asprof -f [filename.html] -e wall [Process Name] (and -e alloc for memory allocs)
  • Profile generating Flamegraph-compatible stacks: asprof -f [filename.stacked] [Process Name]

But there's a lot more in the docs that I haven't uncovered yet that would benefit from a tldr. Planning to write this myself after learning more.

Contributor guide

Tech stack
java
Domain
documentation
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
basic command line knowledge
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85
Research direction
Read the asprof documentation at https://github.com/async profiler/async profiler/tree/master/docs. Create a new tldr page in pages/common/asprof.md following the tldr page format. Include typical command examples such as profiling a process for N seconds (asprof d [N] f [filename.html] [PID]), profiling with wall clock timing (asprof f [filename.html] e wall [Process Name]), and generating flamegraph compatible stacks (asprof f [filename.stacked] [Process Name]). Reference existing tldr pages for similar profiling commands for style guidance.