.. _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
UINT32pid
OCTET-VECTORname
OCTET-VECTORhost_name
ASCII-STRINGcommand_line
Cuescues
Threadthreads
ProcessCueschildren
>,shape=box,style=filled,fillcolor="white"]; "3" [label=<
Thread
OCTET-VECTORname
UINT32tid
Cuescues
>,shape=box,style=filled,fillcolor="white"]; "2" [label=<
Cues
OCTET-VECTORsource
UINT64utime
UINT64stime
INT64num_threads
UINT64vsize
INT64rss
UINT64wall_time
UINT64virtual_time
UINT64etime
UINT64utime_scaled
UINT64stime_scaled
UINT64wall_time_scaled
UINT64start_time
UINT64rchar
UINT64wchar
UINT64read_bytes
UINT64write_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 ` .. 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 ` .. 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 ` .. 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