User`s Manual - Community RTI Connext Users
Contents
1. 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 for the selected entity Parent list for the Figure 3 3 Status Panel selected entity Filter by match All Matches Gi Display Mode _ Basic Advanced Common Information Mon Dec 20 22 56 56 EST 2010 GUID 5 0 seconds Last Update c0as0203 1038 2 60002002 Update Period DataWriter Statistics Delta value mample statistics SNA ain Pushed Count Pushed Bytes Pulled Count Pulled Bytes Filtered Count Filtered Bytes Rejected Count Liveliness Lost 8 567 A 30 651 092 A 6 080 0 A0 0 A0 0 A0 0 A0 0 A0 Heartheat Statistics Heartbeat Count 270 Heartheat Bytes 8 840 AG4 Gap Count Gap Bytes Ack Count Ack Bytes Nack Count Nack Bytes Send Window Size sequence Mumbers 1 A0 32 A0 269 A3 7 532 A84 1 A0 28 A0 change for the update period 4294967297 4294967297 4294967297 First Available Sample Last Available Sample Total Count 0 40 First Unacked Sample 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 th2. ERROR ERROR WARN 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 B 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 State Status E DP 0 gt S ERROR v Entity Click here to see DP 0 gt P ERROR v State these options DP 0 gt P WARN Saas Horizontal Scroll Pack All Columns Pac Selected Column You can change the order of the columns by simply dragging them to a new place in the table 3 2 JOHUOIN Buisn e Using Monitor 3 4 3 3 4 4 3 22 Clearing Notifications To clear the notifications select the button from the toolbar or Actions Clear All Notifications from the menu System
3. 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 LI A selected locator i SHMEM 40 2 1 0 0 2 0 0 0 0 0 0 0 0 0 0 7411 UDPv4 410 50 2 30 7411 UDFPv4 4192 188 2 2 7411 Matching Endpoints Host siesta rti com gt Process 7472 I A selected matching endpoint DataReader Filter options for DataReaders J 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 AllMatches A Display Mode All Matches Matching Endpoints Host siestartiicom Process 7052 3 JOWUOW Buisn e Using Monitor 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 slider 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 history
4. Types Table The System Types table displays all the known data types in the selected domain System Types Table Type Name Keyed Min Serialized Max Serialized Max Key Serialized Type Code Serialized R ShapeType 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 Processes Table The Processes table displays memory and CPU information for all the processes in the system Processes Table Select in Physical View Find ID Total CPU UserCPU Kernel CPU Physical Memory MB Total Memory MB R siestarticom 4 112 5 928 0 936 4 992 27 66 107 492 a siestarticom 6 280 of of Q 26 328 107 055 siestarticom 7 052 0 936 0 312 0 624 23 832 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 Joining and Leaving Domains 3 5 3 6 Like the All Notifications Table Section 3 4 2 this table also has a E button above the vertical scrollbar to control the columns that appear i
5. 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 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 1283
6. 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 multiple 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
7. in the builtin topic for the selected entity Figure 3 6 Description Panel s Builtin Topic Data Tab Field v a builtin topic data Li Key c0as0202 1030 1 80000007 m participant_key cOas0202 1030 1 1 1 topic_name Square i type_name Shapevlype ae durability L8 Kind VOLATILE_DURABILITY_Q0S lad direct communication true iy deadline i latency_budget t m liveliness 3 9 JOWUOW Buisn e Using Monitor L Data Type appears for DataWriters and DataReaders Shows the 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 slesta tti com gt Process 7472 gt DP 0 gt Subscriber gt DR T Sq ShapeType IDL Kepresentation struct ShapeType sting 128 color key long x long y long shapesize i The Description panel is not applicable when a system host or process is selected since they are not Connext entities 3 10 Entity Specific Panels 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 Notifications Panel System gt Host siesta iti com gt Process 7472 gt DP 0 gt Subscriber gt DR Square Builtin Topic Key cOas020
8. 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 administra tive permissions before opening the QoS file 3 25 JOWUOW Buisn e Using Monitor 3 26
9. normal state due to level 199 80267284 P rilog administrd rtilog ad com rtiz1 P rli log administr rtilog ad com rti l rilog administrd rtilog ad comz rti 1 Y Subscriber 15 05 02 2011 05 39 13 653 PM Info app LaunchSyste going to normal state due to level 199 80267284 3 DataReader Flow system J DataReader Level system SJ DataReader 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 gt DataReader rtilog ad com rti l 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 e DataWriter Miscomm DDS String 24 05 02 2011 05 39 18 898 PM app SampleCoun strategy RAMP baseline 1 new value 1 v Publisher gt DataWriter tti log com rti 1 gt DataWriter rtilog ad com rti 1 Moce Mah gt DataWriter rtilog ad comzrtiz 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 Dat
10. sa ncras hc O E T tse GMa alee an centavos 3 8 Oo DESCHIP WON r anel sieni anaE ean Meena eaves alin eae iedeaseales 3 9 Oo ANOUMCATIONS Pane loper E R E r E E 3 11 ac Distributed Logger Paneinereain e AS 3 13 System Wide Panels and Tablesisksitsssacosicicasyinentoavaiautintianuiaiaensicomsenaet mates ag asa GaiSe 3 17 3AL System Overview Panel screen Geasaiae aga na cuted en E AE A 3 17 JE AIPINOONCAT ONS Table aeo iea aa dagen E AN 3 21 Oo yten ly pes able ura A ae ene aes 3 22 Skt PROCESSES Table saeeainaa tan nhaana aoieanna nec Ssatencahesbareanoawnnanaahel E osa an EA CAS 3 22 lomis and Leavis DOM ais enaena a a a ee ssev ee wonalta ee 3 23 Davine anc Loading Dataran ONS 3 23 Connecting and Disconnecting the Display s sessssessssssserseeersersseseseesesresessrssesesseseneesees 3 24 Changing Transport Settings in the Configuration File eee ences enone 3 25 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 TE sem onnen Pe a08 tion Notifications Matches Measurement Measureme Key Selected 0 E Verify your design by zor Bin Terse gs Topic Terse is DataReader Terse _ ia Process Terse x Subscriber Terse S DataWriter Terse iv makin
11. single line is displayed in the table Figure 3 11 Distributed Logger Panel s Messages Tab is a Time 3 05022011 05 38 48 809 PH Danag ano samoiecoan pi RAMP baseline 1 ngwvaliag 0 Messages from 2 osm2r2011 05 38 58 898 Pia strategy RAMP baseline 1 new value 1 all Distributed Lui Loggerinstances aa for the selected a 05022011 053659689 PU iro appLaunchSyste going to normal state due to level 199 80267284 Process 7 05022011 053908 698 PU Debug app 3ampleCoun strategy RAMP baseline 1 new value 0 05022011 05 3909 388 Pu as paunntt_ gong ora et 199 80287284 15 Oh022011 05 39 13 653 PH irto ap LawinchiSyste 19 OSM22011 05 39 16406 Ph info app LaunechiSpate going to normal state due to level 199 20287284 23 05 02 2011 0s 39 38 558 Pa mo fenta going to normal stale due to level 199 80267284 24 airategy RAMP baseline 1 new valua 1 rea Details Publication Sequence Humber 10 i Time 11 05 m PM Details for the 53899396 selected Category app LaunchSystemController message Message going io warning state due to level 195 95065603657326 3 15 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 contr
12. 2 1d30 1 60000107 Last Update Tue Jul 27 21 03 06 EDT 2010 Reasons Field reguested 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 Fieasors 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 3 11 JO UON Buisn c Using Monitor Table 3 1 Warning and Error Conditions Entity Type conflicts equality comparison DataReader Deadlines missed Using push_on_write false with best effort reliabil ity or an asynchronous publisher mm On same host as another DomainParticipant that DomainParticipant Error does not agree on using shared memory Topic Inconsistent topic status Error 3 3 4 1 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 r
13. 6 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 seconds 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 aim 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
14. D 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 3 8 Chart Panel ma System gt Host sliesta rti com gt Process 7472 gt DF 0 gt Subscriber gt DE Square Filter by match All Matches 10 57 00 PM 10 57 30 PM Time Heartbeats Gaps Acks Nacks hart Time Range minutes UI III III III III II III II III II III III III III 1 4 amp 16 32 64 135 Slider controls the time range for all charts Entity Specific Panels 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 se System gt Host siesta ti com gt Process 74725 DF 0 gt Subscriber gt DR Square v i aos Y AS durability m kind VOLATILE_DURABILITY_QO0S Li direct communication true kd P deadline w period infinite a latency_budget Li duration 0 0 seconds Y Bi liveliness Li kind AUTOMATIC_LIVELINESS QOS 4 lease_duration infinite v ae reliability M kind RELIABLE_RELABILITY_QG0S Li max_blocking_time 100 milliseconds I Builtin Topic Data appears for DomainParticipants DataWriters and DataReaders Shows the propagated QoS
15. Notifications Panel Section 3 3 4 e Distributed Logger Panel Section 3 3 5 _I System wide Panels and Tables e System Overview Panel Section 3 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 rti RTI Monitor Fie Domain Actions Window Help ES gt 46738538 Su EE 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
16. RTI Monitor User s Manual Version 4 5 t Your systems Working as one 2010 2012 Real Time Innovations Inc All rights reserved Printed in U S A First printing March 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 ai 3 2 3 3 3 4 3 5 3 6 3 7 3 8 Starting Monitor Command Jine OPNS e niea E eae ee aes 2 1 Using Monitor MRCS VIEW Coinn A TN ec ote 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 ais SIBH DEABUS PANE E a E caste ae E aabeean ten aine 3 6 Oe C hare DE kaa sins
17. S SA SR ac ag sp ai Sg cd c so ON G YO N Si E Pe tov Rte Slaag oaan S S 5 E L a A amp oO amp Fa QI System wide Panels 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 View F je 9 Entity Description Type Entity Description Type v 2 System v 2 System v amp siesta rti com Y Domain 0 Y 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 Squar
18. UOW Buisn e Using Monitor 3 7 3 24 To load a data file use the button on the toolbar or select File Load Data from the menu Domain Actions a l l R Save Data When Monitor is working with saved data you will see Histor GF Load Data ical data mode in the title bar followed by the filename For Exit example r a E i SORA A a 7 7 4 kha Historical data mode CAR AE OPE Pe RA Pe i File Domain Actions Window Help ab a s BHE Z nazg 84385 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 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 F 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
19. aWriters 13 Subscribers 2 DataReaders 9 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 _ 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 14 Entity Specific Panels 3 3 5 1 Messages Tab The Messages Tab shown in Figure 3 10 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 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
20. dpoints 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 17 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 various 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 sel
21. e ShapeType J DataReader Circle ShapeType gt DataWriter Square ShapeType J DataReader Square ShapeType v Triangle Triangle ShapeType a DataReader 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
22. e statuses of all the entities that belong to that selected item For example if 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 Basic and Advanced options are provided Basic data only includes Sample Statistics and Heartbeat Statistics for reliable readers or writers only The Advanced option 3 6 Entity Specific Panels 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 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
23. ect this type of object You will see matching information for Host DomainParticipant DomainParticipants 3 18 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 P 6896 siesta rti com DataReader Terse v DataWriter Terse I All Terse 3 19 JOWUOW 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 Overv
24. epresentative 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 12 Entity Specific Panels Figure 3 9 Notifications Panel Integrating Log Message Level with Entity State 3 3 5 cOaB0003ccc 00 a Mon May 02 17 42 31 EDT 2011 Mon May 02 17 4227 EDT 2011 Distributed Logger Panel 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 s
25. g sure your Con eon a NLI mu NL nm next entities are commu nicating as expected I Tune performance by 7 J providing deep statis Fan tics on every aspect of the middleware s opera tion RTI Monitor I Optimize integration with detailed information on every Connext 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 Connext 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 Chapler2 Starting Monitor On Linux systems Start Monitor usin
26. g the provided rtimonitor script For example if you installed Monitor in opt rti start it by entering gt opt rti RTI_Monitor_ lt version 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
27. iew 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 7 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 20 System Wide Panels and Tables 3 4 2 All Notifications Table f The All Notifications Table shows you all the current errors and warnings for the entire system not just the currently selected entity Figure 3 17 All Notifications Table All Notifications Table Show Problem Types v Warning w Error System gt Host siesta ti com Process 6260 gt DP 0 gt 8 System Host siesta nti com Process 7052 gt DP 0 gt P System Host siesta riii cum Process 7052 gt DP 0 gt P State Status
28. 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 16 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 indicate 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 en
29. n 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 gt You must specify the domain s in which you want Monitor to monitor When Monitor starts you will be ga Join DDS Domain prompted to enter a domain ID unless f me Please enter the ID of the DDS domain you d like to join sie Soe Sa Se EC E command line option hoki cancel You can also join and leave domains by using the and buttons on the toolbar or the com mands in the Domain menu Emel Actions Window Help Join Domain qa Leave Domain To see the currently joined domains select Show Current Domains Domain Show Current Domains from the gt 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 23 JOW
30. ol 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 example 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
31. ystem 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 3 13 JONUOW Buisn e Using Monitor Figure 3 10 Distributed Logger Panel File Domain Actions Window nape Physica DDS Logical View Selected Process ae Entity Description Type v System v 192 168 0 3 5 Proce D 3084 CI v i Process ID 3276 1 05 02 2011 mm app pemp me strategy RAMP baseline 1 new value 0 4 Seman Batspant j Laps 2 05 02 2011 05 38 58 898 PM app SampleCoun strategy RAMP baseline 1 new value 1 B 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 19980267284 F Miscommunicat Miscomm DDS String 05 02 2011 05 39 08 898 PM app SampleCoun strategy RAMP baseline 1 new value 0 Pressure Pressure system T ProblematicTyp4 Problema Problema S Temperature Temperat system MMM SAA MIG Jone eMnOnNSle foo rtilog rtilog com rti l 14 05 02 2011 05 39 09 398 PM Info app LaunchSyste going to
Download Pdf Manuals
Related Search