1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="fn_status">
<refmeta>
<refentrytitle>status</refentrytitle>
<refmiscinfo>admin</refmiscinfo>
<refmiscinfo>statistics</refmiscinfo>
<refmiscinfo>stat</refmiscinfo>
</refmeta>
<refnamediv>
<refname>status</refname>
<refpurpose>Returns statistics for a running server as a result set</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_status">
<funcprototype id="fproto_status">
<funcdef><function>status</function></funcdef>
<paramdef><optional>in <parameter>option</parameter> varchar</optional></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_status"><title>Description</title>
<para>Depending of input parameter displays a statistics for running server. </para>
<para>Note that counters reported by status will be reset after server startup.</para>
</refsect1>
<refsect1 id="params_status">
<title>Parameters</title>
<refsect2><title>option</title>
<para>This option controls the level of detail of the output returned from this procedure.
Possible options are:</para>
<simplelist>
<member>not supplied - general statistics report including : Database, Lock,
Client, Replication status will be returned.</member>
<member>'c' - the report will contain also additional status report on
running statements</member>
<member>'k' - to include index usage report</member>
<member>'r' - to include transactional replication status report</member>
<member>'h' - to include hash indexes usage report</member>
</simplelist>
</refsect2>
</refsect1>
<refsect1 id="ret_status"><title>Return Types</title>
<para>Status returns a result set with one varchar column, one row per line of text in the status report.</para>
</refsect1>
<!--
<refsect1 id="errors_soap_client">
<title>Errors</title>
<para>This function can generate the following errors:</para>
<errorcode></errorcode>
</refsect1>
-->
<refsect1 id="examples_status">
<title>Example</title>
<example id="ex_status"><title>Retrieving Server Status</title>
<programlisting><![CDATA[
SQL> status('rhck');
VARCHAR
_______________________________________________________________________________
OpenLink Virtuoso Server
Version 03.00.23NN-pthreads for Linux as of Nov 27 2002
<License information>
Database Status:
File size 55705600, 6800 pages, 1345 free.
2000 buffers, 180 used, 2 dirty 0 wired down, repl age 0 .
Disk Usage: 188 reads avg 0 msec, 0% read last 80 s, 25 writes,
7 read ahead, batch = 9.
Gate: 0 2nd in reads, 0 gate write waits, 0 in while read 0 busy scrap.
Log = demo.trx, 1597 bytes
5454 pages have been changed since last backup (in checkpoint state)
Current backup timestamp: 0x0000-0x00-0x00
Last backup date: unknown
Clients: 4 connects, max 11 concurrent, 25 licensed
RPC: 55 calls, -2 pending, 2 max until now, 0 queued
Checkpoint Remap 74 pages, 0 mapped back. 0 s atomic time.
DB master 6800 total 1345 free 74 remap 0 mapped back
temp 200 total 197 free
Lock Status: 0 deadlocks of which 0 2r1w, 0 waits,
Currently 1 threads running 0 threads waiting 0 threads in vdb.
Pending:
Client 1111:5: 1944 bytes in, 29516 bytes out, 1 stmts.
Transaction status: PENDING, 1 threads.
Locks:
Running Statements:
Time (msec) Text
Replication Status: Server rep1.
anonymous anonymous 0 OFF.
rep1 rep1 0 OFF.
Index Usage:
Table Index Touches Reads %Miss Locks Waits %W n-dead
WS.WS.SYS_DAV_RES_TYPES SYS_DAV_RES_TYPES 254 1 0% 132 0 0% 0
VAD.DBA.VAD_REGISTRY VAD_REGISTRY 1 1 50% 1 0 0% 0
VAD.DBA.VAD_HELP VAD_HELP 20 1 4% 20 0 0% 0
Hash indexes
47 Rows. -- 9 msec.
]]></programlisting>
</example>
</refsect1>
</refentry>
|