.. _package-rst-monitoring:
========================
Package rst.monitoring
========================
*Not documented*
Messages
========
.. container:: mess4ge-multi
.. container:: mess4ge-graph
.. digraph:: message_graph
fontname="Arial";
fontsize=11;
stylesheet="../_static/corlab.css";
node [fontsize=11]
node [fontname="Arial"]
edge [fontsize=11]
edge [fontname="Arial"]
"1" [label=<
| ProcessCues |
|
UINT32 | pid |
OCTET-VECTOR | name |
OCTET-VECTOR | host_name |
ASCII-STRING | command_line |
Cues | cues |
Thread | threads |
ProcessCues | children |
>,shape=box,style=filled,fillcolor="white"];
"3" [label=< | Thread |
|
OCTET-VECTOR | name |
UINT32 | tid |
Cues | cues |
>,shape=box,style=filled,fillcolor="white"];
"2" [label=< | Cues |
|
OCTET-VECTOR | source |
UINT64 | utime |
UINT64 | stime |
INT64 | num_threads |
UINT64 | vsize |
INT64 | rss |
UINT64 | wall_time |
UINT64 | virtual_time |
UINT64 | etime |
UINT64 | utime_scaled |
UINT64 | stime_scaled |
UINT64 | wall_time_scaled |
UINT64 | start_time |
UINT64 | rchar |
UINT64 | wchar |
UINT64 | read_bytes |
UINT64 | write_bytes |
>,shape=box,style=filled,fillcolor="white"];
"1" -> "3" [dir=both,arrowtail=odiamond];
"1" -> "2" [dir=both,arrowtail=odiamond];
"1":children -> "1" [];
"1":threads -> "3" [];
"1":cues -> "2" [];
"3":cues -> "2" [];
.. container:: mess4ge-list
.. container:: messages
* :ref:`ProcessCues `
.. container:: clearer
clearer: should be made invisible via css
.. _message-rst-monitoring-processcues:
Message ProcessCues
-------------------
.. container:: message-rst-monitoring-processcues-multi
.. container:: message-rst-monitoring-processcues-documentation
.. py:class:: rst.monitoring.ProcessCues
Monitoring-relevant cues about a system process.
.. codeauthor:: Johannes Wienke
.. todo::
this message requires serious abstraction once the
functionality of all cue providers is understood. Do not move
it to stable!
.. py:attribute:: pid
:type: :py:class:`UINT32`
PID of the program.
.. py:attribute:: name
:type: :py:class:`OCTET-VECTOR`
Name of the program (argv[0]).
.. py:attribute:: host_name
:type: :py:class:`OCTET-VECTOR`
Name of the host the program is running on.
.. py:attribute:: command_line
:type: :py:class:`ASCII-STRING`
The complete command line of the program (might include the name, too).
.. py:attribute:: cues
:type: array of :py:class:`rst.monitoring.ProcessCues.Cues`
Cues from different sources.
.. py:attribute:: threads
:type: array of :py:class:`rst.monitoring.ProcessCues.Thread`
Thread-specific performance data of requested.
.. py:attribute:: children
:type: array of :py:class:`rst.monitoring.ProcessCues`
Child processes of this process and their data. The hierarchy of
processes is linearized in this field.
.. container:: message-rst-monitoring-processcues-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.10-merge-simulator/rst-manual/../rst-proto/proto/sandbox/rst/monitoring/ProcessCues.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.10-merge-simulator/rst-manual/../rst-proto/proto/sandbox/rst/monitoring/ProcessCues.proto
:language: protobuf
:emphasize-lines: 18-18,23-23,28-28,33-33,140-140,151-151,157-157
.. _message-rst-monitoring-processcues-cues:
Message Cues
------------
.. container:: message-rst-monitoring-processcues-cues-multi
.. container:: message-rst-monitoring-processcues-cues-documentation
.. py:class:: rst.monitoring.ProcessCues.Cues
Cues from a single source.
.. py:attribute:: source
:type: :py:class:`OCTET-VECTOR`
Short description of the cue source.
.. py:attribute:: utime
:type: :py:class:`UINT64`
Amount of time that this process has been scheduled in user
mode, [usec], for taskstats this is ac_utime.
.. py:attribute:: stime
:type: :py:class:`UINT64`
Amount of time that this process has been scheduled in
kernel mode, [usec], for taskstats this is ac_stime
.. py:attribute:: num_threads
:type: :py:class:`INT64`
Number of threads in this process.
.. py:attribute:: vsize
:type: :py:class:`UINT64`
Virtual memory size in bytes.
.. py:attribute:: rss
:type: :py:class:`INT64`
Resident Set Size: number of pages the process has in real
memory.
.. py:attribute:: wall_time
:type: :py:class:`UINT64`
Wall-clock time used by this process since
start. [nanoseconds]
.. py:attribute:: virtual_time
:type: :py:class:`UINT64`
Processing time used by this process since start.
[nanoseconds]
.. py:attribute:: etime
:type: :py:class:`UINT64`
Elapsed time (from taskstats). [usec]
.. py:attribute:: utime_scaled
:type: :py:class:`UINT64`
*Not documented*
.. py:attribute:: stime_scaled
:type: :py:class:`UINT64`
*Not documented*
.. py:attribute:: wall_time_scaled
:type: :py:class:`UINT64`
*Not documented*
.. py:attribute:: start_time
:type: :py:class:`UINT64`
Start time of the process or thread. [usec] since unix epoche.
.. py:attribute:: rchar
:type: :py:class:`UINT64`
IO stuff
The number of bytes which this task has caused to be read
from storage. This is simply the sum of bytes which this
process passed to read() and pread(). It includes things
like tty IO and it is unaffected by whether or not actual
physical disk IO was required
.. py:attribute:: wchar
:type: :py:class:`UINT64`
The number of bytes which this task has caused, or shall
cause to be written to disk.
Similar caveats apply here as with rchar.
.. py:attribute:: read_bytes
:type: :py:class:`UINT64`
Attempt to count the number of bytes which this process
really did cause to be fetched from the storage layer. Done
at the submit_bio() level, so it is accurate for
block-backed filesystems.
.. py:attribute:: write_bytes
:type: :py:class:`UINT64`
Attempt to count the number of bytes which this process
caused to be sent to the storage layer. This is done at
page-dirtying time.
.. container:: message-rst-monitoring-processcues-cues-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.10-merge-simulator/rst-manual/../rst-proto/proto/sandbox/rst/monitoring/ProcessCues.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.10-merge-simulator/rst-manual/../rst-proto/proto/sandbox/rst/monitoring/ProcessCues.proto
:lines: 38-135
:language: protobuf
:emphasize-lines: 6-6,12-12,18-18,23-23,28-28,34-34,40-40,46-46,51-51,53-53,55-55,57-57,62-62,73-73,81-81,89-89,96-96
.. _message-rst-monitoring-processcues-thread:
Message Thread
--------------
.. container:: message-rst-monitoring-processcues-thread-multi
.. container:: message-rst-monitoring-processcues-thread-documentation
.. py:class:: rst.monitoring.ProcessCues.Thread
*Not documented*
.. py:attribute:: name
:type: :py:class:`OCTET-VECTOR`
*Not documented*
.. py:attribute:: tid
:type: :py:class:`UINT32`
*Not documented*
.. py:attribute:: cues
:type: array of :py:class:`rst.monitoring.ProcessCues.Cues`
*Not documented*
.. container:: message-rst-monitoring-processcues-thread-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.10-merge-simulator/rst-manual/../rst-proto/proto/sandbox/rst/monitoring/ProcessCues.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.10-merge-simulator/rst-manual/../rst-proto/proto/sandbox/rst/monitoring/ProcessCues.proto
:lines: 142-146
:language: protobuf
:emphasize-lines: 2-2,3-3,4-4