You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by lq...@apache.org on 2017/05/23 10:38:57 UTC
qpid-broker-j git commit: QPID-7794: [Java Broker,
Documentation] Update flow to disk section and associated operational
log messages
Repository: qpid-broker-j
Updated Branches:
refs/heads/6.1.x f9262e9ec -> 29bb87ecf
QPID-7794: [Java Broker, Documentation] Update flow to disk section and associated operational log messages
Project: http://git-wip-us.apache.org/repos/asf/qpid-broker-j/repo
Commit: http://git-wip-us.apache.org/repos/asf/qpid-broker-j/commit/29bb87ec
Tree: http://git-wip-us.apache.org/repos/asf/qpid-broker-j/tree/29bb87ec
Diff: http://git-wip-us.apache.org/repos/asf/qpid-broker-j/diff/29bb87ec
Branch: refs/heads/6.1.x
Commit: 29bb87ecf47d14297beefabe0ce532bc9d2ec0e0
Parents: f9262e9
Author: Lorenz Quack <lq...@apache.org>
Authored: Tue May 23 11:38:44 2017 +0100
Committer: Lorenz Quack <lq...@apache.org>
Committed: Tue May 23 11:38:44 2017 +0100
----------------------------------------------------------------------
...er-Appendix-Operational-Logging-Messages.xml | 57 ++++----------------
.../Java-Broker-Runtime-Flow-To-Disk.xml | 10 ++--
2 files changed, 14 insertions(+), 53 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/qpid-broker-j/blob/29bb87ec/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml
----------------------------------------------------------------------
diff --git a/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml b/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml
index d54d220..d3293ef 100644
--- a/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml
+++ b/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml
@@ -357,30 +357,6 @@
management credentials that may be used connect to the Broker.</para>
</entry>
</row>
- <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1014">
- <entry morerows="1">BRK-1014</entry>
- <entry>Message flow to disk active : Message memory use <replaceable>size of all
- messages</replaceable> exceeds threshold <replaceable>threshold
- size</replaceable></entry>
- </row>
- <row>
- <entry>
- <para>Indicates that the memory space occupied by messages has exceeded the
- threshold so the flow to disk feature has been activated.</para>
- </entry>
- </row>
- <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1015">
- <entry morerows="1">BRK-1015</entry>
- <entry>Message flow to disk inactive : Message memory use <replaceable>size of all
- messages</replaceable> within threshold <replaceable>threshold
- size</replaceable></entry>
- </row>
- <row>
- <entry>
- <para>Indicates that the memory space occupied by messages has fallen below the
- threshold so the flow to disk feature has been deactivated.</para>
- </entry>
- </row>
<row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1016">
<entry morerows="1">BRK-1016</entry>
<entry>Fatal error : <replaceable>root cause</replaceable> : See log file for more information</entry>
@@ -567,6 +543,15 @@
when the usage of file system containing Virtualhost message falls under predefined limit.</para>
</entry>
</row>
+ <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-VHT-1008">
+ <entry morerows="1">VHT-1008</entry>
+ <entry>Total number of bytes evacuated from memory due to flow to disk : <replaceable>amount</replaceable> bytes</entry>
+ </row>
+ <row>
+ <entry>
+ <para>Number of bytes evacuated from memory due to the <link linkend="Java-Broker-Runtime-Flow-To-Disk">flow to disk feature</link> during the lifetime of the VirtualHost.</para>
+ </entry>
+ </row>
</tbody>
</tgroup>
</table>
@@ -622,30 +607,6 @@
<para>Indicates that a queue has fallen to its resume capacity. See <xref linkend="Qpid-Producer-Flow-Control"/> for details.</para>
</entry>
</row>
- <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1014">
- <entry morerows="1">QUE-1014</entry>
- <entry>Message flow to disk active : Message memory use <replaceable>size of all
- messages</replaceable> exceeds threshold <replaceable>threshold
- size</replaceable></entry>
- </row>
- <row>
- <entry>
- <para>Indicates that the memory space occupied by messages for this queue
- has exceeded thevthreshold so the flow to disk feature has been activated.</para>
- </entry>
- </row>
- <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1015">
- <entry morerows="1">QUE-1015</entry>
- <entry>Message flow to disk inactive : Message memory use <replaceable>size of all
- messages</replaceable> within threshold <replaceable>threshold
- size</replaceable></entry>
- </row>
- <row>
- <entry>
- <para>Indicates that the memory space occupied by messages for this queue has fallen
- below the threshold so the flow to disk feature has been deactivated.</para>
- </entry>
- </row>
</tbody>
</tgroup>
</table>
http://git-wip-us.apache.org/repos/asf/qpid-broker-j/blob/29bb87ec/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Flow-To-Disk.xml
----------------------------------------------------------------------
diff --git a/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Flow-To-Disk.xml b/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Flow-To-Disk.xml
index 5280b1a..2294e0b 100644
--- a/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Flow-To-Disk.xml
+++ b/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Flow-To-Disk.xml
@@ -22,9 +22,9 @@
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="Java-Broker-Runtime-Flow-To-Disk">
<title>Flow to Disk</title>
- <para>Flow to disk limits the amount of <link linkend="Java-Broker-Runtime-Memory">direct and heap memory</link>
+ <para>Flow to disk limits the amount of <link linkend="Java-Broker-Runtime-Memory">direct memory</link>
that can be occupied by messages. Once this
- limit is reached any new transient messages and all existing transient messages will be
+ limit is reached any new transient messages will be
transferred to disk. Newly arriving transient messages will continue to go to the disk until the
cumulative size of all messages falls below the limit once again.</para>
<para>By default the Broker makes 40% of the max direct available memory for messages. This memory is
@@ -39,7 +39,7 @@
<para>Flow to disk is configured by Broker context variable
<literal>broker.flowToDiskThreshold</literal>. It is expressed as a size in bytes and defaults
to 40% of the JVM maximum heap size.</para>
- <para>Log message <link linkend="Java-Broker-Appendix-Operation-Logging-Message-BRK-1014">BRK-1014</link> is written when the feature activates. Once the total space of all messages
- decreases below the threshold, the message <link linkend="Java-Broker-Appendix-Operation-Logging-Message-BRK-1015">BRK-1015</link> is written
- to show that the feature is no longer active.</para>
+ <para>Periodically, the log message <link linkend="Java-Broker-Appendix-Operation-Logging-Message-VHT-1008">VHT-1008</link>
+ will be issued if messages are newly flowed to disk indicating the total amount of bytes evacuated from memory
+ during the lifetime of the VirtualHost.</para>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org