RTI Monitor User`s Manual
Contents
1. as expected eho _I Tune performance by providing deep statis tics on every aspect of the middleware s opera tion RTI Monitor L Optimize integration with detailed information on every entity in your system I Monitor real time operation with a dashboard of tools to see traffic patterns errors lost samples and more You can run Monitor on the same host as the Connext application or on a different host QWODIOM l Welcome To enable a Connext application to provide monitoring data to Monitor the application needs to use the Monitoring Library plug in Connext notifies Monitoring Library every time an entity is created deleted or a QoS is changed Monitoring Library also periodically queries the status of all entities Monitoring Library sends all the data to Monitor once it gets the data from the Connext application Monitoring is enabled in the application by setting values in the DomainParticipant s PropertyQosPolicy programmatically or through an XML QoS profile Refer to the Monitoring Library Getting Started Guide included with the Monitoring Library bundle for details Monitoring Library is available from the RTI Support Portal accessible from https support rti com Chapter 2 Starting Monitor On Linux systems Start Monitor using the provided rtimonitor script For example if you installed Monitor in opt rti start it by entering gt opt rti RTI_Monitor_ lt version2. 3 1 Tree Views There are two tree views on the left I The Physical View displays all entities arranged by their physical containment I The DDS Logical View displays all the entities arranged by domains and topics When you select an entity in one of the panels it becomes selected in the tree Similarly when you select an entity in a tree any entity specific panels are updated to display information for the newly selected entity One exception to this is if you use the pin button inthe upper left corner of the panel When a panel is pinned to an entity it will periodically receive updated data for the pinned entity even when another entity is selected in the tree 3 2 Tree Views Figure 3 2 Physical and DDS Logical Views Physical View DDS Logical View i DDS Logical View Physical View DDS Logical views F je 9 Entity Description Type Entity Description Type v 2 System v 2 System v amp siesta rti com Domain 0 v Process ID 4112 3 v amp DomainPanticipant 0 RTI Shapes De v id Circle Circle ShapeType v Topics J DataReader Circle ShapeType Circle Circle ShapeType gt DataWriter Circle ShapeType Square Square ShapeType v Square Square ShapeType Triangle Triangle ShapeType J DataReader Square ShapeType v Subscriber J DataReader Square ShapeType J DataReader Circle ShapeType gt DataWriter Square ShapeType J DataReader Square ShapeType v Triangle Triangle ShapeType a DataRe
3. Figure 3 10 Distributed Logger Panel File Domain Actions Window Help TEYAT ETIEN 4a55 _ Physical View DDS Logical View r7 Distributed Logger is a a t System gt Host 192 168 0 3 gt Process 3276 Entity Description Type Messages State and Controls File Logger g r Y a System v v amp 192 168 0 3 Find Row Count 50 View Filter Trace J D 0 EJ Pro B4 Seq a Time Level Category Message ae D 3276 1 0570272011 0538 48 699 PM Debug app SampleGoun strategy RAMP baseine 1 newvaue 0 a v FB Topics Commands Comman system c D Flow Flow system R Level Level system 6 05 02 2011 05 38 59 889 PM Info app LaunchSyste going to normal state due to level 199 80267284 J Miscommunical Miscomm DDS Sting Pressure Pressure system T ProblematicTyp Problema Problema S Temperature Temperat system f MEMC SA Po EI GHOHHHNeaiHE rtilog rtilog com rti l 05 02 2011 05 39 09 398 PM Info Japp om going to normal state due to level 199 80267284 rliJlog administr rtiylog ad com rti l Fud rli log administr rtilog ad com rtiz l rtilogiadministrd rtiylog ad com rtiz Y Sig Subscriber I 15 0510272011 05 39 13 653 Pm into app LaunchSyste going to normal state due to level 199 80267284 3 DataReader Flow system J DataReader Level system 3 D
4. errors both Connext and Monitor warnings Monitor only verbosity lt value gt warnings both Connext and Monitor tracing Monitor only 2 3 4 information Monitor only 5 6 tracing both Connext and Monitor Default 1 JOHUOIN Hulpojs Z Starting Monitor 2 4 Chapter 3 Using Monitor Monitor consists primarily of tree views and panels There is also a toolbar for easy access to the most commonly used commands This chapter provides more details on Monitor s components File Domain Actions Window Help 4 gt sos agaa suas Chart Panel Desti System gt Host BOCAGRANDE tti com gt Process 9 System gt Host BOCAGRANDE ti com gt Process 12836 gt DP 0 gt Subscriber gt DR Square 12836 gt DP 0 gt Subscriber gt DR Square Filter by match AI Matches i aos Buitin Topic Data Datatype Y ais System ChartData Samples Received Counts A v BOCAGRANDE rti com vy Process ID 7508 i i Field Value Y amp DomainParticipant 0 RTI Monit i v oos Y Topics E v durability Square Square ShapeType i i F kind VOLATILE_DURABILITY_QOS Tr ee Y Publisher i F direct communicati true gt DataWriter Square ShapeType f f v F deadline v T Process ID 12836 eh i P period infinite VI ews Y amp DomainParticipant 0 RTI Monit i i v F latency_budget v TB Topics i F duration 0 0 secon
5. P 6896 siesta rti com DataReader Terse v DataWriter Terse I All Terse 3 21 JO UON Buisn e Using Monitor If the Measurement option is selected the Measurement and Scale drop down menus are enabled Measurement allows you to select which data value to display in the map Scale allows you to control the scaling factor of the data value Figure 3 16 System Overview Panel Measurement Option e System Overview Panel BOB Highlight Mode Notifications Q Matches Measurement Measurement Samples Received Count M Scale No Scaling ET Key Selected 0 Display Name Controls Host Terse M Topic Terse v DataReader Terse v Process Terse w Subscriber Terse v DataWriter Terse 7 DomainParticipant Terse iv Publisher Terse v All Terse D pwlowlowlow Imma Eoen ub Move the mouse over an entity in the map will show you the details of that entity for the selected highlight mode The Display Name Controls simply control how the items in the map are labeled or whether they are hidden Each entity types can be hidden from the map labeled tersely with just an abbreviation for the entity type such as T for a Topic or include more information such as T Topic Name 3 22 System Wide Panels and Tables 3 4 2 All Notifications Table f The All Notifications Table show
6. h i Extensibility EXTENSIBLE_EXTENSIBILITY The Description panel is not applicable when a system host or process is selected since they are not Connext entities 3 11 JO UON Buisn e Using Monitor 3 3 4 Notifications Panel The Notifications panel displays the selected entity s current status normal warning or error and a historical list of all related alarm statuses Warnings are highlighted in yel low errors are in red Figure 3 8 Notifications Panel 3 12 Notifications Panel cOas0202 1d30 1 80000107 Tue Jul 27 21 03 06 EDT 2010 Reasons Field reauested deadline missed status status total count change 20 0 Historical Problems Tue Jul 27 21 03 01 EDT 2010 Tue Jul 27 21 02 46 EDT 2010 Fieasorns Clearing Notifications To clear the warnings and error status of ALL entities in the system select the but ton from the toolbar or Actions Clear All Notifications from the menu Historical statuses will never be cleared The number of saved historical statuses is con trolled by the notificationHistoryDepth command line option see Table 2 1 for details Table 3 1 lists the conditions that are considered warnings or errors Type conflicts might be ignored if the ignoreTypeConflicts command line option is used see Table 2 1 for details Entity Specific Panels Table 3 1 3 3 4 1 Warning and Error Conditions Entity Type Inconsistency see Section 3 3 4
7. 19 Processes Table Processes Table Select in Physical View Find ID Total CPU UserCPU Kernel CPU Physical Memory MB Total Memory MB Im siestarticom 4 112 5 928 0 936 4 992 27 66 107 492 a siestarticom 6 280 of of of ol 26 328 107 055 siesta rti com 0 936 0 312 0 624 110 738 3 24 Joining and Leaving Domains 3 5 3 6 These values are valid only if the host is a Linux or Windows system For multi core machines CPU usage can be greater than 1 Like the All Notifications Table Section 3 4 2 this table also has a B button above the vertical scrollbar to control the columns that appear in the table You can also sort the table based on any of the columns by clicking the column heading For example you can quickly sort by Total CPU to see which process is using the most When the process row is selected in the table you can use the Select in Physical View button to see where this process is within the physical tree The Find button is useful for searching through a large table This is a simple string search so you must use the exact same form as displayed in the table Joining and Leaving Domains You must specify the domain s in which you want Monitor to monitor When Monitor starts you will be Join DDS Domain prompted to enter a domain ID unless I bail i A Please enter the ID of the DDS domain you d like to join i he 9 command line opti
8. 2 DataReader Deadlines missed Using push on write false with best effort reliability or an asynchronous publisher i On same host as another DomainParticipant that DomainParticipant Error does not agree on using shared memory Topic Inconsistent topic status Error Additional Information from RTI Distributed Logger RTI Distributed Logger is a library that enables applications to publish log messages to Connext If you are interested in purchasing Distributed Logger please contact your RTI Sales representative If a Connext application uses Distributed Logger the log messages it sends to Monitor are used as an integral part of the entity state kept for the associated Process You can see this in Figure 3 9 where log messages have changed the Process state to Error because there are error level log messages This is a simple but powerful way to monitor the health of a distributed system with minimal integration work If the application already tracks its state it can write updates to the state for Warning and Error to the log Those will be picked up by Monitor and reflected in the display See also Distributed Logger Panel Section 3 3 5 Note Monitor cannot downgrade entity state from Error to Warning to Normal You can make this change explicitly with the Clear All Notifications button on the toolbar 3 13 JOHUOIN Buisn e Using Monitor Figure 3 9 Notifications Panel Integrating Log Message Level with Entity
9. 4 1 e All Notifications Table Section 3 4 2 e System Types Table Section 3 4 3 e Processes Table Section 3 4 4 You can create these panels by _I Using the Window Create Panel option from the menu I Right clicking an entity and selecting from the popup menu entity specific pan els only I Clicking a button on the toolbar see Figure 3 1 You may have multiple panels of each type open at the same time Panels can be arranged by various options in the Window menu There is also a Tile button in the toolbar File Domain Actions Tile button Entity Specific Panels 3 3 Entity Specific Panels The contents for entity specific panels change to show whatever entity is currently selected in the tree view You can however pin a panel to an entity to prevent it from switching contents to do so use the pin button amp in the upper left corner of the panel When a panel is pinned to an entity you will see the pin button changed to a it will periodically receive updated data for the same pinned entity even when another entity is selected in the tree The entity for the entity specific panel pinned or unpinned is indicated by the entity hierarchy list at the top of the panel The backward lt and forward buttons in the toolbar can be used navigate through the entity selection history 3 5 JOWUOW Buisn e Using Monitor 33 1 Status Panel The Status panel displays real time statistics
10. State 3 3 4 2 3 14 c aB0003ccc 00 a Mon May 02 17 42 31 EDT 2011 Mon May 02 174227 EDT 2011 Fiebd Figtd Fieiid Field Fi id Field Fiaid Field Field Fiad Field Field Fiad Understanding Type Consistency Monitor includes partial support for the Extensible and Dynamic Topic Types for DDS specification from the Object Management Group OMG This section assumes that you are familiar with Extensible Types and you have read the Core Libraries and Utilities Getting Started Guide Addendum for Extensible Types Monitor proactively checks for type consistency This is done as new types are discov ered from DataWriters and DataReaders If there are type inconsistencies they will be added to the notifications for the DataWriter and DataReader The type consistency checking considers TypeObject information described in the Extensible and Dynamic Topic Types for DDS specification 1 http www omg org spec DDS XTypes Entity Specific Panels 3 3 5 How Monitor determines type consistency 1 If the TypeObject information is missing for either the DataWriter or DataReader a If the registered type names are different then they are inconsistent b If the registered type names are equal e If the TypeCode information is missing for either the DataWriter or DataReader or if the TypeCodes are equal they are consistent e Otherwise they are inconsistent 2 If the TypeObject informatio
11. a loaded data file I After viewing saved data to return to live data you must reconnect to the domain s that you want to monitor by joining the domain see Section 3 3 5 Connecting and Disconnecting the Display To stop Monitor from updating the display while still receiving data select the but ton on the toolbar or Actions Disconnect Display from the menu To resume display updates select the Ll button on the toolbar or Actions Connect Display from the menu Note Data samples may be lost at the Connext level while Monitor s display is discon nected because the History QoS is configured to only keep the last few samples Changing Transport Settings in the Configuration File 3 8 Changing Transport Settings in the Configuration File The QoS used by Monitor are in lt installation directory gt config rtimonitor_qos_profiles xml You can edit this file to adjust the QoS to fit your system s needs The typical use case is to adjust the transport settings so that they align with the other applications in the system as these are critical for communication However changing any other settings in this file may result in unpredictable behavior and is not supported Generally the configuration file is editable on the system There are certain circum stances where it cannot be updated such as on Windows 7 when Monitor is installed in the Program Files directory If this is the case open your text editor with a
12. for the selected entity Figure 3 3 Status Panel 3 6 Parent list for the selected entity Status Panel System gt Host BOCAGRANDE 1t com gt Process 9648 gt DP 0 gt Publisher gt DW Filter by match All Matches Display Mode _ Basic Advanced Common Information Last Update Mon Jul 23 21 11 39 EDT 2012 GUID c0as0170 25b0 1 80000002 Delta value Update Period 5 0 seconds shows the i change for DataWriter Statistics the update Sample Statistics Heartbeat Statistics period Pushed Count 2 873 A 81 Heartbeat Count 0 A0 Pushed Bytes 218 348 46 156 Heartbeat Bytes phe Gap Count 3 A0 Pulled Count D A0 i Gap Bytes 96 AD Pulled Bytes 0 AQ Ack Cuni 0 A0 Filtered Count 0 A0 Ack Bytes 0 AQ Filtered Bytes 0 A0 Nack Count 0 AQ Rejected Count 0 A0 Nack Bytes 0 AQ Send Window Size 1 Liveliness Lost Sequence Numbers Total Count 0 AQ First Available Sample Last Available Sample aracda eerie his aE asa sample First Available Sample Virtual Total Count 0 40 Last Available Sample Virtual Sequence numbers are displayed for Reliable DataWriters when Filter by match is set to All Matches DataReaders when Filter by match is set to a specific endpoint not All Matches It displays statuses of the selected entity or an aggregation of all the statuses of all the entities that belong to that selected item For example if
13. gt scripts rtimonitor On Windows systems Start Monitor by double clicking lt installation directory gt scripts rtimonitor bat You can also start it from the command line if you need to use any of the options described in Section 2 1 2 1 Command line Options Monitor accepts the command line options in Table 2 1 Table 2 1 Command line Options Monitor periodically goes through all the monitored entities in the system this information is saved in its own database to ageregationPeriodSeconds lt seconds gt calculate aggregated statistics and states This value controls that minimum period specified in seconds Default 5 seconds 2 JOHUOW Hulpojs Z Starting Monitor Table 2 1 Command line Options Monitor saves some statistics history so it can be displayed in the charts This option controls how much historical data historyDepth lt value gt number of samples is saved per monitoring topic Default 12 samples Instructs Monitor to ignore any type conflicts In Monitor type conflicts are based on type code equality rather than type com ignoreTypeConflicts patibility This command line option can be useful if you have types that have different type codes but are compatible Default Not specified do not ignore type conflicts Specifies which domains Monitor will join when it starts up lt domain_id_list gt is a list of domain IDs each separated by a comma To specify multipl
14. you select a DataWriter the sta tuses are just for that entity If you select a Publisher the statuses are an aggregation of those for all DataWriters that belong to that Publisher Aggregation calculation period can be controlled by the command line parameter aggregationPeriodSeconds see Table 2 1 for details Entity Specific Panels Basic and Advanced options are provided Basic data only includes Sample Statistics and Heartbeat Statistics for reliable readers or writers only The Advanced option shows all the available statuses for the entity some of the data is only available for reli able readers or writers Warnings and Error Statuses Warnings and errors are checked for some of the statuses warnings are highlighted in yellow errors are in red See Section 3 3 4 for details on which statuses are checked for warnings or errors To clear the warnings and errors status of ALL entities in the system select the yx button from the toolbar or Actions Clear All Notifications from the menu The Common Information section shows you general information about the entity the GUID for the entity for this panel when the data was last updated and the current update period The version of the remote entity is also provided except for System Host and Process in this panel If the version of the remote entity is incompatible with Monitor it will be marked as a warning the background will be yellow In this situa tion very littl
15. LITY_QOS Ll direct communication true a deadline Li period infinite latency_budget Li duration 0 0 seconds T ma liveliness Li kind AUTOMATIC_LIVELINESS_QO0S Li lease duration infinite v E reliability Li kind RELIABLE_RELIABILITY_QOS Li max_blocking_time 100 milliseconds I Builtin Topic Data appears for DomainParticipants DataWriters and DataReaders Shows the propagated QoS in the builtin topic for the selected entity Figure 3 6 Description Panel s Builtin Topic Data Tab Bulin Topical v a builtin topic data Li Key c0as0202 1030 1 80000007 Li participant_key cOas0202 10d30 1 1c1 LS topic_name Square Ll type_name Shapelype ae durability Ll kind VOLATILE_DURABILITY_00S Lal direct_communication true iy deadline iy latency_budget ie liveliness 3 10 Entity Specific Panels I Data Type appears for DataWriters and DataReaders Shows the type name and ID type code serialized size and IDL representation of the associated data type Figure 3 7 Description Panel s Data Type Tab Description Panel System gt Host BOCAGRANDE 1t com gt Process 8356 gt DP 0 gt Publisher gt DW Square Builtin Topic Data Type Name ShapeType Type ID 69fd54chdeblebc5 Typecode Serialized Size Minimum Serialized Size Maximum Serialized Size Maximum Key Serialized Size IDL Representation struct ShapeTypef string 128 gt color i key long x long Yy long shapesize
16. RTI Monitor User s Manual Version 5 0 t Your systems Working as one 2010 2012 Real Time Innovations Inc All rights reserved Printed in U S A First printing August 2012 Trademarks Real Time Innovations RTI and Connext are trademarks or registered trademarks of Real Time Innovations Inc All other trademarks used in this document are the property of their respective owners Copy and Use Restrictions No part of this publication may be reproduced stored in a retrieval system or transmitted in any form including electronic mechanical photocopy and facsimile without the prior written permission of Real Time Innovations Inc The software described in this document is furnished under and subject to the RTI software license agreement The software may be used or copied only under the terms of the license agreement Technical Support Real Time Innovations Inc 232 E Java Drive Sunnyvale CA 94089 Phone 408 990 7444 Email support rti com Website https support rti com Contents l Welcome Zo 31 3 2 3 3 3 4 3 5 3 6 3 7 3 8 Starting Monitor Command dine OPNS e niea O E eaten 2 1 Using Monitor Tree VIEW Coann A at ww TN Sr cece ot 3 2 Workin with Monitor s Pan lsisssersnionn onari n Gas HH gais hata uii e ai s iman 3 4 Enuneopeci Hail Panel Sia yeti sess spcun N E eee ae ane ee 3 5 oM DEAEUS PANE stron A basa tensdnseta nn E caste aaa dude aaeoean ten a
17. S ERROR DP 0 P ERROR DP 0 P WARN v Entity Click here to see v State i these options x Status Horizontal Scroll Pack All Columns Pack Selected Column You can change the order of the columns by simply dragging them to a new place in the table 3 23 JOWUOW Buisn e Using Monitor Clearing Notifications To clear the notifications select the button from the toolbar or Actions Clear All Notifications from the menu 343 System Types Table The System Types table displays all the known data types in the selected domain Figure 3 18 System Types Table System Types Table Domain oo im Type Name Type ID Keyed Min Serialized Max Serialized Max Key Serialized Type Code Serialized Is ShapeType 69fd54c6deb1ebc5 A Shapelype 432818800688 7bd3 The Domain drop down menu includes a list of all the joined domain IDs for you to select Like the All Notifications Table Section 3 4 2 this table also has a IS button above the vertical scrollbar to control the columns that appear in the table You can also sort the table based on any of the columns by clicking the column heading The Find button is useful for searching through a large table This is a simple string search so you must use the exact same form as displayed in the table 3 4 4 Processes Table The Processes table displays memory and CPU information for all the processes in the system Figure 3
18. ader Triangle ShapeType 3 DataReader Triangle ShapeType v Process ID 6280 gt DataWriter Triangle ShapeType Y amp DomainParticipant 0 RTI Shapes De v Topics DomainParticipant 0 RTI Shapes Demo Circle Circle ShapeType amp DomainParticipant 0 RTI Shapes Demo Square Square ShapeType amp DomainParticipant 0 RTI Shapes Demo Y 5 Subscriber J DataReader Square ShapeType v Publisher gt DataWriter Circle ShapeType v J Process ID 7052 Y amp DomainParticipant 0 RTI Shapes De Square Square ShapeType Triangle Triangle ShapeType Y Publisher gt DataWriter Square ShapeType gt DataWriter Triangle ShapeType Note Topics and DomainParticipants appear strictly to help organize the tree they are not entities If you select either of these while viewing an unpinned entity specific panel Monitor behaves as if you selected the domain or DomainParticipant above it in the tree Using Monitor 3 2 3 4 Working with Monitor s Panels Monitor has several panels that display monitoring data in graphical and tabular form Some panels show data for a specific selected entity while others show system wide information I Entity Specific Panels e Status Panel Section 3 3 1 e Chart Panel Section 3 3 2 e Description Panel Section 3 3 3 e Notifications Panel Section 3 3 4 e Distributed Logger Panel Section 3 3 5 l System wide Panels and Tables e System Overview Panel Section 3
19. and Figure 3 11 displays a table containing the log messages from the currently selected Process The messages can include those logged using the application s logging library RTI Logger as well as the standard out and standard error of the application depending on how the application configured Distributed Logger By default the messages are presented sorted based on the order in which they were written By clicking on the column headers you can re sort the table to meet your needs 3 16 Entity Specific Panels The panel also has a Find button to do simple string searches a control to limit the number of rows which are displayed and a view filter which shows filters messages that are less severe than the selected level At the bottom of the panel is a detailed dis play for the selected messages from the table This is primarily useful when the log mes sage contains multiple lines only a single line is displayed in the table Figure 3 11 Distributed Logger Panel s Messages Tab 1 sseazorosseansereu oeney apart Messages from 0502r201105738 58 898 Pal all Distributed Logger instances for the selected Process i emean 053809398 Pu e E Fo 15 0502 20110539131653PH ifo ape LaunchSyste going 7s osmzor1 05 3016 s06 Pu imo app Launencyat going to normal state due to level 199 80267284 Bwn 0s EE 19 656 PU E ChOIgH going to normal state due to level 199 60267264 EREN aE gE ILERI ga
20. ataReader Pressure system 2 DataReader Problema Problema 19 05 02 2011 05 39 16 406 Pm into app LaunchSyste going to normal state due to level 199 80267284 3 DataReader Temperat system SJ DataReader rtilog ad comzrtizi Y Pe Publisher gt DataWriter Comman system c 23 05 02 2011 05 39 18 658 PM Info app LaunchSyste going to normal state due to level 199 80267284 be DataWriter Miscomm DDS String 24 05 02 2011 05 39 18 898 PM app SampleCoun strategy RAMP baseline 1 newvalue 1 v Publisher gt DataWriter rti log comzrti l gt DataWriter rtilog ad com rti l Message Details gt DataWriter rtilog ad com l Publication Sequence Number 10 Time 05 02 2011 05 39 09 398 PM Level Category app LaunchSystemController Message going to warning state due to level 199 95065603657326 1 2 System Metrics Domains 1 Hosts 1 Processes 2 Participants 2 Topics 11 Publishers 4 DataWriters 13 Subscribers 2 DataReaders 9 LJ File Logger Tab Section 3 3 5 3 When a Process containing an instance of Distributed Logger is selected the cached log messages populate the table in the Messages tab and the State and Controls and File Logger tabs are updated to reflect the state of the Distributed Logger instance 3 3 5 1 Messages Tab The Messages Tab shown in Figure 3 10
21. cate the meaning of the different highlights in the map If the Notifications option is selected the map will show all the entities in the system and their colors will show if they are in normal warning or error mode If the Matches option is selected the map will show all the entities that are currently matched and all the entities that are currently unmatched due to potential errors For an ideal match opposing endpoints DataWriters and DataReaders must have the same domain ID same topic name and belong to compatible partitions if any are spec ified This list of ideal matches is compared to the list of actual matches received from Monitoring Library to determine which entities are marked as matches or mismatches in 3 19 JOWUOW Buisn e Using Monitor Figure 3 14 System Overview Panel Notifications Option System Overview Panel Highlight Mode e Notifications Matches Measurement Measurement Samples Received Count Key ___ Selected Normal _ Display Name Controls Host Terse iv Topic Terse h Process Terse Subscriber Terse m DomainParticipant Terse jE J Publisher Terse iv ow ow pwi u DP P 6032 siesta rti com A visual map of the system T Topic DR DataReader The outer most box represents the host DW DataWriter sub Subscriber Pub Publisher DP DomainParticipant P process ID the map There are variou
22. dministra tive permissions before opening the QoS file 3 27 JOWUOW Buisn e Using Monitor 3 28
23. ds Square Square ShapeType i v liveliness v Subscriber 04 44 00 PM 04 44 30 PM lan kind AUTOMATIC_LIVELINESS_Q P DataReader Square ShapeType Time A lease_duration Aii Sam Received Duplicate Filtered Rejected I u C h a rts Status Pz System gt Host BOCAGRANDE 1ti com gt Process a n d 12836 gt DP 0 gt Subscriber gt DR Square Fiterbymatch AuMatcnes w Panels Display Mode Basic Q Advanced Common Information Last Update Thu Feb 09 16 44 57 EST 2012 Update Period 5 0 seconds DataReader Statistics Sample Statistics r Heartbeat 4 183 A161 Heartbeat Ci 317 908 A 12 236 Heartbeat By 0 40 Gap Count 0 Ao Sap Bytes o ao Ack Count 0 A0 Ack Bytes Filtered Bytes Chart Time Range minutes Tiri e pee eee e eee pe eee eee epee eee eee peepee eee pty 1 4 s 16 32 amp 123 2 System Metrics Domains 1 Hosts 1 Processes 3 Participants 3 Topics 1 Publishers 2 DataWriters 2 Subscribers 1 DataReaders 1 Number of Monitored Entities Time Range for Chart Panels 3 Using Monitor Figure 3 1 Monitor s Toolbar Entity soecific Panels 5 C aP O c 0 N a P N X O pig S SA SR ac ag sp ai Sg cd c so ON G S N Si E hb tov Rte Slaag oaan S S 5 E L a A c oO amp Fa QI System wide Panels
24. e data will be available about the remote entity generally just the infor mation discovered about the DomainParticipant Filter by match only appears for DataWriters and DataReaders If anything other than All matches is selected the data shown in the Status panel will only include data that 3 7 JOHUOIN Buisn e Using Monitor 3 8 belongs to the matching kind that you have selected a subset of the data for the entire entity Filter options for DataWriters I All matches J A selected locator All Matenes A All Matches Filter by match Display Mode Locators SHMEM 0 2 1 0 0 2 0 0 0 0 0 0 0 0 0 0 7411 I A selected matching endpoint UDPwi 110 5020 7411 DataReader UDPv4 192 168 2 2 7411 Matching Endpoints Filter options for DataReaders Host siestastiicom Process 472 LJ All matches Above Example filter options for a DataWriter The I A selected matching endpoint locators are for the transports The matching endpoint DataWriter is a DataReader Below Example filter options for a DataReader The matching endpoint is a DataWriter Filter by match Display Mode All Matches Matching Endpoints Host siestasticom Process 052 Entity Specific Panels 3 3 2 Chart Panel illi The Chart panel graphs the selected statistics on the Y axis over time the X axis for the selected entity You can control the time range with the slid
25. e domain IDs on a Windows system enclose the comma separated IDs in quotation marks For example initialDomainIds 31 32 initialDomainIds lt domain_id_list gt Default If not specified you will be prompted to enter a domain ID when Monitor starts Specifies the period at which to refresh the system overview matchRefreshPeriodSeconds lt seconds gt panel s matches Default 5 seconds ee sie Specifies the number of notifications to keep per entity notificationHistoryDepth lt value gt bha tee Default 12 notifications Sets the period at which Monitor should clean up user interface objects such as the Host and Process nodes in the tree views that are no longer current have no more children nodes in the tree view This value should be increased when dealing with very large systems where the time to complete discovery is lon ger than the default value of 3 seconds pruneDeadObjectsPeriodSeconds lt seconds gt Default 3 seconds 2 2 Command line Options Table 2 1 Command line Options Instructs Monitor to use multiple threads according to the number of cores on the host to retrieve data from its Connext DataReaders which contain monitoring data This is typically spawnReadThreads only needed for very large systems Default Not specified use a single read thread to retrieve data at a period of 1 second Sets the verbosity for Monitor and Connext 0 silent both Connext and Monitor
26. er at the bottom of the main window and other chart properties by right clicking within the chart area Filter by match only appears for DataWriters and DataReaders Section 3 3 1 describes the choices The Chart Data options depend on the type of the selected entity The number of samples that can be displayed in the chart is controlled by the historyD epth command line option see Table 2 1 for details To plot multiple chart data for the same entity at the same time create multiple Chart Panels Figure 3 4 Chart Panel Chart Panel j System gt Host slesta rti com gt Process 7472 gt DP 0 gt Subscriber gt DR Square Filter by match All Matches Chart Data 6 0 aia a 42 4 0 10 57 00 PM 10 57 30 PM Time Heartbeats Gaps Acks WNacks hart Time Range minutes T TE LUI II II III III III II III III III III III III 2 4 5 16 a2 g4 1285 Slider controls the time range for all charts 3 9 JOWUOW Buisn e Using Monitor 3 3 3 Description Panel The Description panel s contents depend on what is selected in the tree view There are three tabs which may appear _I QoS appears for all Connext entities Shows the QoS settings for the selected entity Figure 3 5 Description Panel s QoS Tab Description Panel System gt Host siesta rti com gt Process 7472 gt DP 0 gt Sherer DEIS v RE gos m durability F kind VOLATILE_DURABI
27. ine 3 6 Oe C hare IDE oc drs sa norsk E E amhain 3 9 DO WDESCRIP MOM anne xis Ge eaa rosea coved sassceucaty nausea iwc eshalin eee detanadteadnes ats 3 10 Deo ANOUMCATIONS Pane loper E R r E AE 3 12 poor Distributed Logger Paneinereain e AS 3 15 System Wide Panels and lapleSesiunninii a mates iste 3 19 Oe System Overview Panel Ge cctcrdecsnsiusta vised cuted Ena AE AE 3 19 JE AIPINOONCAT ONS Table saro iea aa dagen E AN 3 23 Oo yten ly pes ablenne a A E ae 3 24 Skt Processes Table 25 cse its vaiastchattseetstacaduaptcsaap nec N osasseooeemneuerobneasautas 3 24 lomis and Leavis DOM ais enaena a a a ee ssev ee wonalta ee 3 25 Davine anc Loading Dat ar sscacsisccsecsacsascuases aa nacgtiecseovaiecang NS 3 25 Connecting and Disconnectine the Display s cscsswessscsssvassanrnaissneassadnoaseentar encanta 3 26 Changing Transport Settings in the Configuration File eee cece eee 3 27 Chapter 1 Welcome RTI Monitor is a graphical tool that displays monitoring data from RTI Connext for merly RTI Data Distribution Service applications Monitor will help you I Understand your sys tem with an easy to use graphical view into your entire Connext applica Eag tion Notifications Matches Measurement Measureme Key Selected 0 I Verify your design by a HH Im e making sure the entities SSS SS Ls in your Connext applica tions are communicating
28. mple with Distributed Logger and is detailed in the Distributed Logger Getting Started Guide The File Logger tab provides inputs for the file path and the queue size There are dis plays that show how many messages have been written as well as dropped due to queue size The current and maximum queue sizes are also displayed Note The File Size may not update as quickly as the Messages Written count In fact the File Size is usually zero until several messages have been written This is because buffering is used to increase the throughput performance while writing to the file 3 18 System Wide Panels and Tables Figure 3 13 Distributed Logger Panel s File Logger Tab 3 4 3 4 1 La Distributed Logger m 5 System gt Hos 19216803 gt Process 3276 iiessages State and Conirgis Siep Queue Sire Log File Path Running rue File Path cllemplapplication_jog td File Size 1 089 536 4 139 284 Message Written 7 089 A900 Messages Dropped Count a Last Exception Lar Queue Site 204 Queue Size i MA5 6 System Wide Panels and Tables System wide panels and tables show a summary of the states of the whole system System Overview Panel The System Overview panel displays a map of the entities in the system You can change the criteria for how items in the map are highlighted by selecting the Notifications Matches or Measurement option A Key is provided to indi
29. n is present for both the DataWriter and DataReader a If the DataReader s TypeConsistencyEnforcementQosPolicy s kind is set to DISALLOW_TYPE_COERCION e Ifthe types are not structurally identical then they are inconsistent e Otherwise they are consistent b If the DataReader s TypeConsistencyEnforcementQosPolicy s kind is set to ALLOW_TYPE_COERCION e If the DataReader type is not assignable to the DataWriter type then they are inconsistent e Otherwise they are consistent Distributed Logger Panel H Monitor s Distributed Logger panel allows you to see messages from Distributed Logger a separate library that can be integrated with Connext applications You can also use this panel to control Distributed Logger Distributed Logger is integrated into Monitor s entity state normal warning and error tracking feature Therefore error and warning messages logged to an application s log ging system and sent to Monitor through Distributed Logger will change a process status to Error and Warning respectively The Distributed Logger panel is associated with Process entities Therefore it only dis plays information when a Process is selected from the Physical View and that Process is running an instance of Distributed Logger As seen in Figure 3 10 the Distributed Logger panel has three tabs I Messages Tab Section 3 3 5 1 J State and Controls Tab Section 3 3 5 2 3 15 JOWUOW Buisn e Using Monitor
30. on ok Cancel You can also join and leave domains by using the and a buttons on the toolbar or the com mands in the Domain menu Actions Window Help Join Domain lt lt Leave Domain To see the currently joined domains select lt gt Show Current Domains Domain Show Current Domains from the menu Saving and Loading Data Monitor can work with live data or data that s been saved to a file To save monitoring data use the button on the toolbar or select File Save Data from the menu The file will be saved in a Serialized Java Objects format ser 3 25 JOWUOW Buisn e Using Monitor 3 7 3 26 To load a data file use the button on the toolbar or select m File Load Data from the menu Bena Actions Nil l l R Save Data When Monitor is working with saved data you will see Histor R Load Data ical data mode in the title bar followed by the filename For Exit example File Domain Actions Window Help Monitor will save notifications descriptions and statistics for DomainParticipants DataReaders and DataWriters up to the history depth or notification history depth for every object being monitored Notes I While viewing saved data you will not see built in topic data or the IDL repre sentation of the data type in the Description panel This information is not saved in the data file J You cannot save data while using
31. s reasons for a mismatch such as incompatible QoS or data types misconfigured discovery peers or use of the Connext ignore_ APIs among other reasons The matches are shown at the peer level only That is if you select a Publisher you will not see matches for the DataWriters that belong to it Table 3 2 provides more informa tion on what matches are shown for selected entities Table 3 2 Peer Level Objects If you select this type of object You will see matching information for Host DomainParticipant DomainParticipants 3 20 System Wide Panels and Tables Table 3 2 Peer Level Objects If you select this type of object Subscriber Publishers You will see matching information for If an entity is highlighted as Partially Matched some not all of its child entities are not matched such as a Publisher that has one matched DataWriter and one or more unmatched DataWriters The matchRefreshPeriodSeconds command line option controls how often the match ing information is refreshed see Table 2 1 for details Figure 3 15 System Overview Panel Matches Option System Overview Panel Highlight Mode Notifications Matches Q Measurement Measuremen Key Display Name Controls Host Terse Topic Terse v Process Terse Subscriber Terse v DomainParticipant Terse iv Publisher Terse iv aga pw ow owi DP pelor u DP
32. s you all the current errors and warnings for the entire system not just the currently selected entity Figure 3 17 All Notifications Table Entity State Status Is System gt Host siesta ti com Process T052 gt DP 0 P WARN l A All Notifications Table Nees Saleactin Views Show Problem Types v Warming v Error system gt Host siesta rti com gt Process 6280 gt DP s 5 ERROR I System gt Host siesta rti cum gt Process 052 gt DP 0 gt P ERROR This panel has filters to include or exclude warnings errors Errors are shown in red Warnings are shown in yellow If a row is selected in the table the Select in Views button selects the entity in tree views on the left The Find button is useful for searching through a large table This is a simple string search so you must use the exact same form as displayed in the table Clicking on a column heading will sort the table by the values in that column Clicking it again will sort in the opposite order The E button just above the vertical scrollbar allows you to choose which columns appear in the table It also has options to pack resizes columns and enable a horizontal scrollbar Note to enable the Pack Selected Column option select a cell in the top row All Notifications Table 2A Types W Warning w Error I aiec all State Status qe v DP 0
33. tus iep Eite sein senec RAMP baseline 1 new value 1 Publication Sequence Number 10 Details for the selected message Using Monitor 3 3 5 2 State and Controls Tab The State and Controls tab shown in Figure 3 12 provides the ability to control the ver bosity of the Distributed Logger instance directly from Monitor It also provides control over the RII Logger verbosity and shows the most recent if any response to com mands it has processed Figure 3 12 Distributed Logger Panel s State and Controls Tab Dhtrdbused Logger ee sie Dan Distributed Logger Applicaton King Control Liw Trace Trace v RTI Logger Print Format Doui Delauh T Connext Plattorm Verbosity Error Error fs Verbosity Communication verbosity Emor Error T Control Database Verbosity Eno Error 7 Entes Verbosity Error Eno i Aid Verboaity Emor Exror Command Response Result OK Message Most recent lneeocanan U Last Update OSM022011 05 40 56 267 PM response to Host Ik 0280003 App ID 171c a command 3 3 5 3 File Logger Tab The File Logger tab shown in Figure 3 13 provides a way to save log messages for a sin gle Process to a file This is especially useful when issues are noticed for a Process and you want to capture the output to share with others for analysis Another more general purpose way to save log messages to a file is provided as an exa
Download Pdf Manuals
Related Search