Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add age & machine and readable outputs for ldms_ls: json/tab #1568

Merged
merged 2 commits into from
Jan 21, 2025
Merged

add age & machine and readable outputs for ldms_ls: json/tab #1568

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d4383bd
add machine age and readable outputs for ldms_ls (json, tabbed multit…
baallan Dec 13, 2024
390f65d
remove comment
baallan Dec 22, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 22 additions & 16 deletions ldms/man/ldms_ls.man
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,11 @@ PORT of the HOST to use for the query. Default is LDMS_DEFAULT_PORT.
.BR -l
Display long listing. Outputs details of the metric set, including timestamp, metric names, metric types, and values.

.TP
.BR -f " <format>"
Display output using format, which is one of 'tab' or 'json'. Other values are ignored.
Output in tab format includes header rows starting with # and has tab separated columns.

.TP
.BI -a " AUTH"
The name of the LDMS Authentication plugin. Please see
Expand Down Expand Up @@ -163,25 +168,26 @@ $ldms_ls -h vm1 -x sock -p 60000 -l vm1_1/foo
ldms_ls: No such file or directory
ldms_ls: lookup failed for set 'vm1_1/foo'
.PP
4) Display metadata:
4a) Display metadata:
.nf
.RS
ldms_ls -h vm1 -x sock -p 60000 -v
vm1_1/meminfo: consistent, last update: Fri Dec 16 17:12:08 2016 [5091us]
METADATA --------
Producer Name : vm1_1
Instance Name : vm1_1/meminfo
Schema Name : meminfo
Size : 1816
Metric Count : 43
GN : 2
DATA ------------
Timestamp : Fri Dec 16 17:12:08 2016 [5091us]
Duration : [0.000072s]
Consistent : TRUE
Size : 384
GN : 985
-----------------
Schema Instance Flags Msize Dsize Hsize UID GID Perm Update Duration Info
-------------- ------------------------ ------ ------ ------ ------ ------ ------ ---------- ----------------- ----------------- --------
vmstat vm1/vmstat CL 8504 1328 0 0 0 -rw-r--r-- 1734076680.060971 0.000186 "updt_hint_us"="60000000:0"
baallan marked this conversation as resolved.
Show resolved Hide resolved
-------------- ------------------------ ------ ------ ------ ------ ------ ------ ---------- ----------------- ----------------- --------
Total Sets: 1, Meta Data (kB): 8.50, Data (kB) 1.33, Memory (kB): 9.83

.RE
4b) Display metadata tabbed:
.nf
.RS
ldms_ls -h vm1 -x sock -p 60000 -v -f tab
#schema instance flags msize dsize hsize uid gid perm update duration age_seconds age_intervals info
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since 'age_seconds' and 'age_intervals' are not self-explanatory, they may benefit from brief description in the man page. What do you think?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll fixed that if i've missed it.

vmstat amber-login4/vmstat CL 8504 1328 0 0 0 -rw-r--r-- 1734076800.060615 0.000174 10.461 0 "updt_hint_us"="60000000:0"
#total_sets meta_data_kb data_kb memory_kb
1 8.50 1.33 9.83

.RE
.PP
5) Regular Expression:
Expand Down
Loading
Loading