.. include:: ../../../vars.rst .. _section-administration-view-process: Process View ============ ======== Overview ======== The Process View provides panels that display the DDS entities related or contained within a process, the process's log (populated through Distributed Logger; this tab only appears if Distributed Logger is enabled for the process), and a basic information panel. ============== Graphical View ============== The Process Graphical View shows how a Process is connected to other entities in the DDS System. This view will help you understand the entities that matched with the DataWriters and DataReaders created by the process, and which DDS system entities are relevant for the selected process. .. figure:: ../../../_static/administration/processView_graphView.png :alt: Process view graph view :name: Process view graph view :align: center :figWidth: 100% The Graphical View uses the same approach as the Topic View to indicate the match analysis status of every DataWriter and DataReader in the graph. .. NOTE:: For information on how the Publishers and Subscriber are named, please see the section :ref:`Publishers and Subscribers names ` The information in this view is organized in a way to ensure that the Process Node is always located on the left side of the graph. In the center of the graph, you will see the nodes that represent the Topics that the Process is connected to. On the right side, you will see the other nodes that are connected to all the entities created by the Process. The Process node will move up and down as you scroll through the graph. Having the Process node always visible can help you see how the process is connected to the rest of the entities. .. Note:: This view is the only graphical representation in which you may see the same entity more than once. The Host node where the Process is running may appear on both the left and right sides, if it contains more than one process running, and the second process is relevant for the process that is driving the visualization of the graph. ============ DDS Entities ============ .. |IMAGE_RUNNING_PROCESS| image:: ../../../_static/administration/branding/icons/running_process.png .. |IMAGE_PARTICIPANT| image:: ../../../_static/administration/branding/icons/participant.png .. |IMAGE_PUBLISHER| image:: ../../../_static/administration/branding/icons/publisher.png .. |IMAGE_DATA_WRITER| image:: ../../../_static/administration/branding/icons/datawriter.png .. |IMAGE_SUBSCRIBER| image:: ../../../_static/administration/branding/icons/subscriber.png .. |IMAGE_DATA_READER| image:: ../../../_static/administration/branding/icons/datareader.png .. |IMAGE_ERROR| image:: ../../../_static/administration/branding/icons/error.png .. |IMAGE_WARNING| image:: ../../../_static/administration/branding/icons/warning.png The DDS Entities tab displays a hierarchical view of the DDS entities that were created by that process. The tree starts with the process |IMAGE_RUNNING_PROCESS| itself, which then contains DomainParticipants |IMAGE_PARTICIPANT|, Publishers |IMAGE_PUBLISHER|, DataWriters |IMAGE_DATA_WRITER|, Subscribers |IMAGE_SUBSCRIBER|, and DataReaders |IMAGE_DATA_READER|. Health badges for errors |IMAGE_ERROR| and warnings |IMAGE_WARNING| are also used to convey health state information. .. figure:: ../../../_static/administration/processView_ddsEntities.png :alt: Process view graph view dds entities :name: Process view graph view dds entities :align: center :figWidth: 100% *** Log *** The Log tab displays the processes' log messages. This display requires that the process is using Distributed Logger. .. figure:: ../../../_static/administration/distributedLog.png :alt: Distributed log :name: Distributed log :align: center :figWidth: 100% The Distributed Logger table consists of these columns: * **Message ID** - The ID of the message. * **Time** - The time the log message was written. * **Level** - The level of the message. * **Category** - The logger category name. * **Message** - The message. There are also buttons to pause updates to the table, export the contents of the table to a file, and adjust the settings used by the remote process's Distributed Logger library. ********************** Remote Settings Dialog ********************** .. figure:: ../../../_static/administration/distributedLog_settingsDialog.png :alt: Distributed log settings dialog :name: Distributed log settings dialog :align: center :figWidth: 100% The Distributed Logger remote settings dialog controls the instance of the Distributed Logger library being used by the remote process. You can adjust the filter level, print format, and verbosity of the individual log categories. This dialog also displays the state, and last update time. ************ Security Log ************ The Security Log tab displays the process's security log messages. This display only appears when the Security Logger is enabled for the remote process. .. figure:: ../../../_static/administration/processView_securityLog.png :alt: Process view security log :name: Process view security log :align: center :figWidth: 100% The Distributed Logger table consists of these columns: * **Time** - The time the log message was written. * **Level** - The level of the message. * **Message** - The message. * **Structured Data** - Further details related to the log message. There are also buttons to pause the updates to the table and to export the contents of the table to a file. ******************* Process Information ******************* .. figure:: ../../../_static/administration/processView_processInfo.png :alt: Process view process information :name: Process view process information :align: center :figWidth: 100% The Process Information tab displays some basic information about the processes such as the |CONNEXT| version being used, who is running the process, and some relevant timestamps. Note that the RTI Architecture Name reflects the **native** architecture and not that of a layered API binding. In particular, don't be confused when Java and .Net processes are reported as OS-native architectures.