'\" t
.TH "SYSTEMD\-REPORT" "1" "" "systemd 260.1" "systemd-report"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
systemd-report \- Generate report of system facts and metrics
.SH "SYNOPSIS"
.HP \w'\fBsystemd\-report\fR\ 'u
\fBsystemd\-report\fR [OPTIONS...]
.SH "DESCRIPTION"
.PP
\fINote: this command is experimental for now\&. While it is likely to become a regular component of systemd, it might still change in behaviour and interface\&.\fR
.PP
\fBsystemd\-report\fR
requests facts and metrics from the system and writes them to standard output\&.
.SH "COMMANDS"
.PP
The following commands are understood:
.PP
\fBmetrics\fR [MATCH...]
.RS 4
Acquire a list of metrics values from all local services providing them, and write them to standard output\&. Optionally takes one or more match expressions for filtering the metrics to show\&. The expression either may be a literal metric family name to search for, or a prefix of one (which will be matched only at dot boundaries)\&. If multiple matches are specified as multiple parameters, any metric matching
\fIany\fR
of the specified matches are shown\&.
.sp
Added in version 260\&.
.RE
.PP
\fBdescribe\-metrics\fR [MATCH...]
.RS 4
Acquire a list of metric families from all local services providing them, and write them to standard output\&. This returns primarily static information about metrics, their data types and human readable description, without values\&.
.sp
Match expressions similar to those supported by
\fBmetrics\fR
are supported for
\fBdescribe\-metrics\fR, too\&.
.sp
Added in version 260\&.
.RE
.PP
\fBlist\-sources\fR
.RS 4
Show list of known metrics sources\&.
.sp
Added in version 260\&.
.RE
.SH "OPTIONS"
.PP
The following options are understood:
.PP
\fB\-\-system\fR, \fB\-\-user\fR
.RS 4
Query per\-system metrics sources (the default), or the per\-user metrics sources\&.
.sp
Added in version 260\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
Do not pipe output into a pager\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
Shows output formatted as JSON\&. Expects one of
"short"
(for the shortest possible output without any redundant whitespace or line breaks),
"pretty"
(for a pretty version of the same, with indentation and line breaks) or
"off"
(to turn off JSON output, the default)\&.
.RE
.PP
\fB\-j\fR
.RS 4
Equivalent to
\fB\-\-json=pretty\fR
if running on a terminal, and
\fB\-\-json=short\fR
otherwise\&.
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
Do not print the legend, i\&.e\&. column headers and the footer with hints\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print a short help text and exit\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print a short version string and exit\&.
.RE
.SH "EXIT STATUS"
.PP
On success, 0 is returned, a non\-zero failure code otherwise\&.
.SH "SEE ALSO"
.PP
\fBsystemd\fR(1)