Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ././../../../../../../usr/man/man8/daxstat.8
Real path: /usr/share/man/man8/daxstat.8
Zurück

'\" te
.\" Copyright (c) 2016, 2023, Oracle and/or its affiliates.
.TH daxstat 8 "14 Jun 2023" "Oracle Solaris 11.4" "System Administration Commands"
.SH NAME
daxstat \- report Database Analytics Accelerator (DAX) statistics
.SH SYNOPSIS

.LP
.nf
/usr/bin/daxstat [[-T u | d] [-c \fIprocessor_id\fR] | [-d \fIdax_id\fR \e
       [-q \fIqueue_id\fR]] | [-[x]d \fIdax_id\fR]] [\fIinterval\fR [\fIcount\fR]]
.fi

.LP
.nf
/usr/bin/daxstat -a [[-T u | d] [-c] | [-d [-q]] | \e
       [-[x]d]] [\fIinterval\fR [\fIcount\fR]]
.fi
.SH DESCRIPTION
.sp
.LP
The \fBdaxstat\fR command reports DAX statistics. Using the first format, \fBdaxstat\fR reports DAX statistics per-dax or per-cpu or per-queue in a tabular form. Using the second format, \fBdaxstat\fR command reports DAX statistics aggregated into a single all-dax, all-cpu, or all-queue value in a tabular form. The first entry in the table summarizes all activity since boot. Subsequent entries in the table summarizes activity for the preceding interval.
.sp
.LP
The \fBdaxstat\fR per-dax reports the following information:
.sp
.ne 2
.mk
.na
\fB\fBDAX\fR\fR
.ad
.RS 13n
.rt
DAX ID
.RE

.sp
.ne 2
.mk
.na
\fB\fBcommands\fR\fR
.ad
.RS 13n
.rt
Number of commands completed by DAX
.RE

.sp
.ne 2
.mk
.na
\fB\fBfallbacks\fR\fR
.ad
.RS 13n
.rt
Number of commands completed by the software, which DAX could not complete
.RE

.sp
.ne 2
.mk
.na
\fB\fBinput\fR\fR
.ad
.RS 13n
.rt
Total input processed by DAX in megabytes per second (M) or gigabytes per second (G)
.RE

.sp
.ne 2
.mk
.na
\fB\fBoutput\fR\fR
.ad
.RS 13n
.rt
Total output produced by DAX in megabytes per second (M) or gigabytes per second (G)
.RE

.sp
.ne 2
.mk
.na
\fB\fB%busy\fR\fR
.ad
.RS 13n
.rt
Indicates the percentage of DAX cycles spent while processing a command
.RE

.sp
.LP
The \fBdaxstat\fR per-dax extended reports the following information:
.sp
.ne 2
.mk
.na
\fB\fBDAX\fR\fR
.ad
.RS 13n
.rt
DAX ID
.RE

.sp
.ne 2
.mk
.na
\fB\fBcommands\fR\fR
.ad
.RS 13n
.rt
Number of commands completed by DAX
.RE

.sp
.ne 2
.mk
.na
\fB\fBfallbacks\fR\fR
.ad
.RS 13n
.rt
Number of commands completed by the software, which DAX could not complete
.RE

.sp
.ne 2
.mk
.na
\fB\fBinput\fR\fR
.ad
.RS 13n
.rt
Total input processed by DAX in megabytes per second (M) or gigabytes per second (G)
.RE

.sp
.ne 2
.mk
.na
\fB\fBoutput\fR\fR
.ad
.RS 13n
.rt
Total output produced by DAX in megabytes per second (M) or gigabytes per second (G)
.RE

.sp
.ne 2
.mk
.na
\fB\fB%input\fR\fR
.ad
.RS 13n
.rt
Indicates the percent utilization of DAX read capacity
.RE

.sp
.ne 2
.mk
.na
\fB\fB%output\fR\fR
.ad
.RS 13n
.rt
Indicates the percent utilization of DAX of write capacity
.RE

.sp
.ne 2
.mk
.na
\fB\fB%data\fR\fR
.ad
.RS 13n
.rt
Indicates the percent utilization of DAX capacity to process data
.RE

.sp
.ne 2
.mk
.na
\fB\fB%lookup\fR\fR
.ad
.RS 13n
.rt
Indicates the percent utilization of DAX capacity to perform lookups. Lookups are DAX cycles spent in decompression and translation
.RE

.sp
.ne 2
.mk
.na
\fB\fB%busy\fR\fR
.ad
.RS 13n
.rt
Indicates the percentage of DAX cycles spent while processing a command
.RE

.sp
.LP
The \fBdaxstat\fR per-queue reports the following information:
.sp
.ne 2
.mk
.na
\fB\fBDAX\fR\fR
.ad
.RS 12n
.rt
DAX ID
.RE

.sp
.ne 2
.mk
.na
\fB\fBQUEUE\fR\fR
.ad
.RS 12n
.rt
Queue ID
.RE

.sp
.ne 2
.mk
.na
\fB\fBcommands\fR\fR
.ad
.RS 12n
.rt
Number of commands completed by DAX
.RE

.sp
.LP
The \fBdaxstat\fR per-cpu reports the following information:
.sp
.ne 2
.mk
.na
\fB\fBCPU\fR\fR
.ad
.RS 13n
.rt
CPU ID
.RE

.sp
.ne 2
.mk
.na
\fB\fBcalls\fR\fR
.ad
.RS 13n
.rt
Number of \fBdax_submit\fR fast trap calls
.RE

.sp
.ne 2
.mk
.na
\fB\fBtime\fR\fR
.ad
.RS 13n
.rt
The sum of kernel and hypervisor time in seconds spent submitting DAX commands
.RE

.sp
.ne 2
.mk
.na
\fB\fBsuccess\fR\fR
.ad
.RS 13n
.rt
Number of \fBccb_submit\fR hyper-calls that returned \fBsuccess\fR
.RE

.sp
.ne 2
.mk
.na
\fB\fBfallbacks\fR\fR
.ad
.RS 13n
.rt
Number of \fBccb_submit\fR hyper-calls that returned an error
.RE

.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.mk
.na
\fB\fB-a\fR\fR
.ad
.RS 12n
.rt
The output would be aggregated into a single '\fBall-cpu\fR’ or '\fBall-dax\fR’ or '\fBall-queue\fR’ value. With this option, no \fBdax\fR, \fBqueue\fR, or \fBCPU\fR IDs should be entered.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-c\fR\fR
.ad
.RS 12n
.rt
Displays per-cpu statistics for specified CPUs.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-d\fR\fR
.ad
.RS 12n
.rt
Displays per-dax statistics for specified DAX units. In each cycle, DAX concurrently reads data from memory, processes data, performs lookups, and writes data to memory. Each of these steps has a capacity and could be the utilization limiter. The \fBdaxstat\fR command reports the percent capacity utilization of each step. This option also reports the percentage of cycles that DAX is busy on which includes any of the steps while processing a command.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-q\fR\fR
.ad
.RS 12n
.rt
Displays per-queue statistics for specified queues in specified DAX units.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-x\fR\fR
.ad
.RS 12n
.rt
Displays per-dax extended statistics for specified DAX units. This option is only valid when used with the \fB-d\fR option.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-T\fR \fBu\fR | \fBd\fR\fR
.ad
.RS 12n
.rt
Prints a time stamp before each report, in either standard date format, \fBd\fR, or the internal representation of time, \fBu\fR. For more information, see the \fBtime\fR(2) and \fBdate\fR(1) man pages.
.RE

.sp
.ne 2
.mk
.na
\fB\fBinterval\fR\fR
.ad
.RS 12n
.rt
Reports once each interval second. The default interval is \fB1\fR second.
.RE

.sp
.ne 2
.mk
.na
\fB\fBcount\fR\fR
.ad
.RS 12n
.rt
Prints only count reports. Default count is \fB1\fR.
.RE

.SH OPERANDS
.sp
.LP
The following operands are supported:
.sp
.ne 2
.mk
.na
\fB\fIprocessor_id\fR\fR
.ad
.RS 16n
.rt
Specifies \fIprocessor_id\fR as an individual processor number (for example, 3), or a range of processor numbers (for example, 1-4).
.RE

.sp
.ne 2
.mk
.na
\fB\fIdax_id\fR\fR
.ad
.RS 16n
.rt
Specifies \fIdax_id\fR as an individual DAX unit (for example, 8), or a range of DAX units (for example, 8-15).
.RE

.sp
.ne 2
.mk
.na
\fB\fIqueue_id\fR\fR
.ad
.RS 16n
.rt
Specifies \fIqueue_id\fR as an individual queue number (for example, 0), or a range of queue numbers (for example, 0-4).
.RE

.SH EXIT STATUS
.sp
.LP
The following exit values are returned:
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 5n
.rt
Command successful.
.RE

.sp
.ne 2
.mk
.na
\fB\fB1\fR\fR
.ad
.RS 5n
.rt
An error occurred.
.RE

.sp
.ne 2
.mk
.na
\fB\fB2\fR\fR
.ad
.RS 5n
.rt
Invalid command line options were specified.
.RE

.SH EXAMPLES
.LP
\fBExample 1\fR Using \fBdaxstat\fR to Display per-dax Statistics

.sp
.LP
The following commands generate aggregated per-dax statistics over a five-second interval in two reports.

.sp
.in +2
.nf
example% \fBdaxstat -ad 5 2\fR

DAX    commands fallbacks    input    output %busy
ALL   394986995         0     1.3G      1.2G     0
ALL       36646         0  2045.4M   3410.1M     3
.fi
.in -2
.sp

.sp
.in +2
.nf
example% \fBdaxstat -axd 5 2\fR

DAX    commands fallbacks    input    output %input %output %data %lookup %busy
ALL   394895412         0   200.3M    340.2M      0       0     0       0     0
ALL       37838         0     3.3G      1.1G      0       0     3       1     5
.fi
.in -2
.sp
.LP
\fBExample 2\fR Using \fBdaxstat\fR to Display per-cpu Statistics

.sp
.LP
The following command generates per-cpu statistics for CPUs \fB0\fR and \fB1\fR since boot.

.sp
.in +2
.nf
example% \fBdaxstat -c 0-1\fR

CPU        calls          time    success  fallbacks
  0      6486811    9276154005    6486811          0
  1      6553856    9272570130    6553856          0

.fi
.in -2
.sp
.LP
\fBExample 3\fR Using \fBdaxstat\fR to Display per-queue Statistics

.sp
.LP
The following command generates per-queue statistics for queues \fB0\fR-\fB3\fR in DAX unit \fB5\fR over an interval of one second in one report.

.sp
.in +2
.nf
example% \fBdaxstat -d 5 -q 0-1\fR

DAX    QUEUE     commands
  5        0     32569344
           1     37095525
.fi
.in -2
.sp
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPE
ATTRIBUTE VALUE
_
Architecture
SPARC
_
Availability
system/sstore
_
Interface Stability
Uncommitted
.TE
.sp
.SH SEE ALSO
.sp
.LP
\fBsstore\fR(1), \fBkstat2\fR(8)
.SH NOTES
.sp
.LP
The sum of DAX utilization might vary slightly from 100 due to rounding errors in the production of a percentage figure.
.sp
.LP
By default, the DAX driver only collects statistics for DAX units. The per-cpu and per-queue statistics are not collected. Thus, trying to display data for CPU (\fB-c\fR) and queue (\fB-q\fR), as per the examples, will show no data available to display. For more information about the DAX driver collecting DAX CPU and queue statistics, see the \fIGeneral Driver Parameters\fR in \fIOracle Solaris 11.4 Tunable Parameters Reference Manual\fR.