Skip to content

Latest commit

 

History

History
87 lines (55 loc) · 5.2 KB

README.md

File metadata and controls

87 lines (55 loc) · 5.2 KB
Raw

carre

A very small tool designed to continuously fetch process information from the inside of a docker container. This tool is heavily inspired by the concept of containermon which provides similar information but on container basis.

Install

Through golang

You may simply install the go project using the following go command:

go get -u github.com/lynxplay/carre

Release binaries

Carre also provides pre-build binaries for finished releases to avoid the requirement for a complete go installation on every system. The binaries can be found in the respective releases here .

Usage

--container | -C (required)

The container parameter specifies the name of the container for which the metrics are to be gathered. It is required as this is the core point of caree,

--interval | -I

The interval parameter can specify the duration between each data point collected by caree.

Default: 500ms

Units: "ns", "us" (or "µs"), "ms", "s", "m", "h"

--format | -F

The format parameter specifies in which format the output is printed. As of right now the follow formats exist.

  • 'CSV' provides a comma separated list of values including the csv header defining the collum values.
  • 'JSON' provides a set of json data points mapping the respective metric to its value. Each line is an individually complete json string.

Default: JSON

--timestamp | -T

The timestamp parameter specifies in which format the timestamp for each data point is going to be printed. As of right now the following formats exist.

  • 'ISO' specifies the time format to follow ISO 8601, more specifically RFC3339, when printing the timestamps.
  • 'EPOCH' specifies the timestamp to follow simple unix epoch. The timestamp will be represented as milliseconds.

Default: EPOCH

Examples

carre --container my_great_container
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:39.4060455 +0200 CEST m=+0.517411801","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:39.9075679 +0200 CEST m=+1.018934101","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:40.4162938 +0200 CEST m=+1.527660401","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:40.9075311 +0200 CEST m=+2.018897201","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:41.4087445 +0200 CEST m=+2.520110701","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:41.9082418 +0200 CEST m=+3.019608001","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:42.4036635 +0200 CEST m=+3.515029901","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:42.9070597 +0200 CEST m=+4.018426101","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:43.4165144 +0200 CEST m=+4.527880701","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:43.9088428 +0200 CEST m=+5.020209001","TTY":"?","USER":"root","VSZ":"19894616"}
{"%CPU":"0.1","%MEM":"0.2","COMMAND":"java -jar quarkus-run.jar","PID":"9809","RSS":"130072","START":"Mar29","STAT":"Ssl","TIME":"0:06","TIMESTAMP":"2021-03-30 02:04:44.4091147 +0200 CEST m=+5.520481001","TTY":"?","USER":"root","VSZ":"19894616"}