core-dump-client

Crates.io	core-dump-client
lib.rs	core-dump-client
version	1.0.0
source	src
created_at	2021-09-29 17:34:40.765966
updated_at	2021-10-08 22:12:15.3325
description	A client for debugging core-dump-handler output
homepage	https://github.com/IBM/core-dump-handler/main/core-dump-client
repository	https://github.com/IBM/core-dump-handler/main/core-dump-client
max_upload_size
id	458236
size	19,326

Anton Whalley (No9)

documentation

https://docs.rs/core-dump-client

A CLI for running a core dump session on kubernetes using the zipfile generated by core-dump-handler

This tool is still under active development but the core functionality is in place. Currently it support nodejs, java or default lldb tools.

Ensure core-dump-handler is installed on your cluster.
Install the cli
- Download the latest build from releases https://github.com/IBM/core-dump-handler/releases Rename it cdcli and place it in a folder that is in your $PATH
- Or build the client with cargo install core-dump-client If you don't have rust installed you can get it with rustup
Ensure your kubectl client is logged into the cluster kubectl install instructions are available here

Create a debug environment with

cdcli -c [name-of-zipfile] -i [crashed-image-name]

e.g.

cdcli 36c0d272-3295-4474-a16e-00885ba04fed-dump-1631477784-crashing-app-848dc79df4-srqkv-node-8-4.zip quay.io/number9/example-crashing-nodejs-app

This will log you into a running container with lldb tools and core file info available to you.

To start a debug session in the environment runrundebug.sh command.

./rundebug

To inspect the metadata that was saved with crash ls will list the folder container your core file and the metadata json.

Commit count: 0