Skip to content

this docker image provides a convenient environment for performance profiling using perf. Its flexible enough to allow you to install and test other low-level packages as well.

License

Notifications You must be signed in to change notification settings

triplemcoder14/perf-utils

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Performance Triage Utility Docker Image

this Docker image is based on Debian and includes the perf utility, designed for use on Docker for debian-based linux system. It comes pre-configured with Nginx to demonstrate how to use perf for performance profiling. feel free to adapt the image to include other utilities as needed

Features

  • Debian base image
  • perf installed for performance profiling
  • Nginx included as a web server (modifiable)
  • Privileged mode support for perf commands

Usage

Running the Container

start the container in a privileged mode, run:

docker run --name perf-utils --privileged -p 8080:80 -d ghcr.io/triplemcoder14/perf-utils:latest

Accessing the Container

create a bash shell in the running container, execute:

docker exec -it perf-utils bash

Running perf Commands

Once inside the container, you can run perf commands to probe your applications. Here are some examples:

  1. List available probes for Nginx:
perf probe -x /usr/sbin/nginx -F

output:

probe

  1. Inspect specific function variables:
perf probe -x `which nginx` -V ngx_accept_log_error

output:

output8

Feel free to customize this image by adding additional utilities or configurations as needed. Simply modify the Dockerfile to install any required packages or dependencies.

cheers!!!

About

this docker image provides a convenient environment for performance profiling using perf. Its flexible enough to allow you to install and test other low-level packages as well.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages