ProcDump

ProcDump es una reinvención de la clásica herramienta ProcDump del conjunto Sysinternals para Windows, adaptada para Linux y Mac. ProcDump proporciona una manera conveniente para que los desarrolladores de Linux y Mac creen volcados de núcleo de sus aplicaciones basados en disparadores de rendimiento. ProcDump para Linux y Mac es parte de Sysinternals.

Instalación y Uso

Requisitos

• Sistema operativo Linux mínimo:
  • Red Hat Enterprise Linux / CentOS 7
  • Fedora 29
  • Ubuntu 16.04 LTS
  • gdb >= 7.6.1
• Sistema operativo Mac mínimo: Sierra

Instalar ProcDump

Consulte las instrucciones de instalación aquí.

Compilar

Consulte las instrucciones de compilación aquí.

Uso

CAMBIO IMPORTANTE Con el lanzamiento de ProcDump 1.3, los interruptores ahora están alineados con la versión de Windows de ProcDump. Tenga en cuenta que la versión Mac actualmente tiene un conjunto limitado de disparadores.

Uso de captura:
   procdump [-n Count]
            [-s Seconds]
            [-c|-cl CPU_Usage]
            [-m|-ml Commit_Usage1[,Commit_Usage2...]]
            [-gcm [<GCGeneration>: | LOH: | POH:]Memory_Usage1[,Memory_Usage2...]]
            [-gcgen Generation]
            [-restrack [nodump]]
            [-sr Sample_Rate]
            [-tc Thread_Threshold]
            [-fc FileDescriptor_Threshold]
            [-sig Signal_Number1[,Signal_Number2...]]
            [-e]
            [-f Include_Filter,...]
            [-fx Exclude_Filter]
            [-mc Custom_Dump_Mask]
            [-pf Polling_Frequency]
            [-o]
            [-log syslog|stdout]
            {
             {{[-w] Process_Name | [-pgid] PID} [Dump_File | Dump_Folder]}
            }

Opciones:
   -n      Número de volcados a escribir antes de salir.
   -s      Segundos consecutivos antes de escribir un volcado (por defecto 10).
   -c      Umbral de CPU por encima del cual crear un volcado del proceso.
   -cl     Umbral de CPU por debajo del cual crear un volcado del proceso.
   -m      Umbral(es) de uso de memoria (MB) por encima del cual crear volcados.
   -ml     Umbral(es) de uso de memoria (MB) por debajo del cual crear volcados.
   -gcm    [.NET] Umbral(es) de memoria de GC (MB) por encima del cual crear volcados para la generación o el montón especificado (por defecto es el uso total de memoria .NET).
   -gcgen  [.NET] Crear volcado cuando el recolector de basura de la generación especificada comienza y termina.
   -restrack  Activar seguimiento de fugas de memoria (familia de API malloc). Si se usa sin otros disparadores, use 't' para capturar manualmente un informe restrack. Cuando se usa con otros disparadores, la opción 'nodump' puede usarse para evitar la generación de volcados y solo producir informes restrack.
   -sr     Tasa de muestreo al usar -restrack.
   -tc     Umbral de recuento de hilos por encima del cual crear un volcado del proceso.
   -fc     Umbral de recuento de descriptores de archivo por encima del cual crear un volcado del proceso.
   -sig    Lista separada por comas de números de señal durante la cual cualquier señal resulta en un volcado del proceso.
   -e      [.NET] Crear volcado cuando el proceso encuentra una excepción.
   -f      Filtro (incluir) sobre el contenido de excepciones .NET (separado por comas). Se admiten comodines (*).
   -fx     Filtro (excluir) sobre el contenido de las pilas de llamadas de -restrack. Se admiten comodines (*).
   -mc     Máscara de volcado de núcleo personalizada (en hex) que indica qué memoria debe incluirse en el volcado de núcleo. Consulte 'man core' (/proc/[pid]/coredump_filter) para opciones disponibles.
   -pf     Frecuencia de sondeo.
   -o      Sobrescribir archivo de volcado existente.
   -log    Escribe el seguimiento extendido de ProcDump en el flujo de salida especificado (syslog o stdout).
   -w      Esperar a que se inicie el proceso especificado si no se está ejecutando.
   -pgid   El ID del proceso especificado se refiere a un ID de grupo de procesos.

Seguimiento de Recursos

El interruptor -restrack activa el seguimiento de recursos, permitiendo monitorear e informar de cualquier asignación de recursos que no haya sido liberada al momento de generar el volcado de núcleo. Los resultados se guardan en un archivo con extensión '.restrack'. Actualmente, se rastrean las siguientes funciones de asignación/desasignación de recursos:

Asignación:

• malloc
• calloc
• realloc
• reallocarray
• mmap

Desasignación:

• free
• munmap

La versión para Mac actualmente no implementa el seguimiento de recursos.

Ejemplos

Los siguientes ejemplos tienen como objetivo un proceso con pid == 1234