Working with Probe Connections

Table Of Contents

Working with Probe Connections

Viewing Basic Information for Probe Connections

Right-Click Menu for All Probe Connections

Right-Click Menu for a Specific Probe Connection

Probe Connection Table

Viewing Detailed Information for a Probe Connection

Probe Connection Details: Right-Click Menu

Probe Connection Details: Components

Probe Connection Details: Configuration Data

Naming Information

Status Information

Statistics Information

Probe Connection Details: Notes

Probe Connection Details: Recent Events

Viewing Real-Time Data for a Probe Connection

Probe Connection Statistics Details: Poll Settings

Probe Connection Statistics Details: Components

Probe Connection Statistics Details: Configuration Data

Probe Connection Statistics Details: Notes

Probe Connection Statistics Details: Recent Events

Probe Connection Statistics Details: Statistics

Attaching a Note to a Probe Connection

Viewing Notes for a Probe Connection

Deleting a Probe Connection

Deleting a Probe Connection from Your Network

Deleting a Probe Connection from the SGM Database

Ignoring a Probe Connection

Viewing Ignored Probe Connections

Viewing Probe Connection Information Using a Web Browser

Viewing the Network Status Probe Connection Dashboard

Viewing ITP Probe Connection Status

Viewing ITP Probe Connection Details

Working with Probe Connections

---

SGM enables you to view information about all discovered probe connections, including their status, congestion levels, and other important information.

This section includes the following information:

•Viewing Basic Information for Probe Connections

•Viewing Detailed Information for a Probe Connection

•Viewing Real-Time Data for a Probe Connection

•Attaching a Note to a Probe Connection

•Viewing Notes for a Probe Connection

•Deleting a Probe Connection

•Ignoring a Probe Connection

•Viewing Ignored Probe Connections

•Viewing Probe Connection Information Using a Web Browser

Related Topics:

•Changing SGM Client Preference Settings

•Resizing, Sorting, and Hiding Table Columns

Viewing Basic Information for Probe Connections

To view basic information for probe connections, select Probe Connections in the left pane of the SGM Main Window. SGM displays the Probe Connection Window.

The Probe Connection Window provides information about all probe connections that have been discovered by SGM, including their status and other important information.

The Probe Connection Window is composed of the following sections:

•Right-Click Menu for All Probe Connections

•Right-Click Menu for a Specific Probe Connection

•Probe Connection Table

Related Topics:

•Attaching a Note to a Probe Connection

•Viewing Detailed Information for a Probe Connection

•Changing SGM Client Preference Settings

•Resizing, Sorting, and Hiding Table Columns

•Using the SGM Main Menu

•Viewing Notes for a Probe Connection

Right-Click Menu for All Probe Connections

To see the right-click menu for all probe connections, select Probe Connections in the left pane and click the right mouse button. The probe connection right-click menu provides the following options:

Menu Command	Description
Show In New Window	Opens the Probe Connection Window in a new window.
Sort Tree By Status	Sorts the entire tree in the left pane by the status of each object.
Sort Tree By Name	Sorts the entire tree in the left pane by the name of each object.
Back > List of Windows	Navigates back to a window viewed in this session. SGM maintains a list of up to 10 Back windows.
Forward > List of Windows	Navigates forward to a window viewed in this session. SGM maintains a list of up to 10 Forward windows.

Right-Click Menu for a Specific Probe Connection

The Probe Connection Window provides a subset of the SGM Main Menu as a right-click menu. To see this menu, select a probe connection and click the right mouse button. The probe connection right-click menu provides the following options:

Menu Command	Description
Edit Notes	Opens the Edit Notes Dialog for the selected probe connection. If you have implemented SGM User-Based Access, this option is available to users with authentication level Power User (Level 2) and higher.
Clear Event Icon	Deletes the event icon (orange triangle) from SGM displays for the selected probe connection, for this SGM client only. The actual events are not deleted from SGM, only the event icon for the selected probe connection for this SGM client. This option is grayed-out if the selected probe connection has no associated event icon.
Delete	Deletes the currently selected probe connection from the SGM database. SGM displays the Confirm Deletion dialog: •To delete the selected probe connection, click Yes. The probe connection is deleted from the SGM database and the Confirm Deletion dialog is closed. •To retain the selected probe connection, click No. The probe connection is kept in the SGM database and the Confirm Deletion dialog is closed. •To prevent SGM from displaying the Confirm Deletion dialog, select the Do not show this again checkbox. Note If you select the Do not show this again checkbox, and you later decide you want SGM to begin displaying the Confirm Deletion dialog again, you must select the Confirm Deletions checkbox in the General GUI settings in the Preferences window. For more information, see the description of the Confirm Deletions checkbox in the "Startup/Exit Settings" section. If you have implemented SGM User-Based Access, this option is available to users with authentication level Network Administrator (Level 4) and higher.
Go To > Node	Displays the Node Window for the node associated with this probe connection.
Back > List of Windows	Navigates back to a window viewed in this session. SGM maintains a list of up to 10 Back windows.
Forward > List of Windows	Navigates forward to a window viewed in this session. SGM maintains a list of up to 10 Forward windows.
View > Configuration Details	Displays the Configuration Data panel for the selected probe connection.
View > Notes	Displays the Notes panel for the selected probe connection. If there are no notes associated with the selected probe connection, this option is grayed-out.
View > Events	Displays the Recent Events panel for the selected probe connection.
View > Real-Time Data and Charts	Displays the SGM Real-Time Statistics Window for the selected probe connection.
Event History > Status Change Messages	Displays the SGM Network Status Log for Status Change Messages in a Web browser, with messages displayed for only the selected probe connection.
Event History > SNMP Trap Messages	Displays the SGM Network Status Log for SNMP Trap Messages in a Web browser, with messages displayed for only the selected probe connection.
Event History > Status and Trap Messages	Displays the SGM Network Status Log for Status Change Messages and SNMP Trap Messages in a Web browser, with messages displayed for only the selected probe connection.
Event History > Network Status Metrics	Displays the SGM Network Status Log for Metrics in a Web browser, with messages displayed for only the selected probe connection.
Ignore	Ignores the selected probe connection at the next polling cycle. If you have implemented SGM User-Based Access, this option is available to users with authentication level Power User (Level 2) and higher.
Unignore	Stops ignoring the selected probe connection at the next polling cycle. If you have implemented SGM User-Based Access, this option is available to users with authentication level Power User (Level 2) and higher.
Latest Reports > Probe Connection Statistics	Displays the most recent Probe Connection Statistics - Hourly Report for the probe connection, in a Web browser. This option is not available if the node associated with the probe connection is in Unknown or Unmanaged status.
Latest Reports > Probe Link Statistics	Displays the most recent Probe Link Statistics - Hourly Report for the probe links associated with the probe connection, in a Web browser. This option is not available if the node associated with the probe connection is in Unknown or Unmanaged status.

Probe Connection Table

The probe connection table displays information about the probe connections that have been discovered by SGM.

To see mouse over help popup for each column in the table, place the cursor over a column header.

If a cell is too small to show all of its data, place the cursor over the cell to see the full data in a mouse over help popup.

You can resize each column, or sort the table based on the information in one of the columns. By default, this table is sorted by Status, and SGM displays all of the columns in the probe connection table except Internal ID.

•To display hidden columns, right-click in the table header and select the checkboxes for the columns you want to display.

•To hide columns, right-click in the table header and clear the checkboxes for the columns you want to hide.

See the "Resizing, Sorting, and Hiding Table Columns" section for more information about resizing, sorting, displaying, or hiding columns.

The probe connection table contains the following columns:

Column	Description
Internal ID	Internal ID of the probe connection. The internal ID is a unique ID for every object, assigned by SGM for its own internal use. It can also be useful when the TAC is debugging problems.
Node	Node associated with the probe connection.
Port	Port number used to establish the TCP connection for the probe.
Congested	Indicates whether the probe connection is congested.
Ignored	Indicates whether the probe connection is to be included when aggregating and displaying SGM status information: •Clear the checkbox to include the probe connection. This is the default setting. •Select the checkbox to exclude the probe connection. This field can be edited by users with authentication level Power User (Level 2) and higher.
Notes	Indicates whether there is a note associated with the probe connection.
Events	Indicates whether there is a recent event associated with the probe connection. (Even if the server purges all of the events associated with the probe connection, SGM continues to display the event icon in this field.) •To delete the event icon (orange triangle) from SGM displays for a specific probe connection, select the probe connection and click the icon. •To delete the event icon from SGM displays for all probe connections, select Edit > Clear All Events from the SGM Main Menu. Note During Discovery, SGM might flag most probe connections with an event icon. If the event icons are too distracting, use the Edit > Clear All Events menu option to remove them.
Last Status Change	Date and time that the status of the probe connection last changed.
Status	Current status of the probe connection. Possible values are: Active (green) Inactive (red) Unknown (red) Warning (yellow) For detailed definitions of each status, see the "Status Definitions for Probe Connections" section.
Status Reason	Reason for the current status of the probe connection. For a full list of possible reasons, see the stateReasons.html file: •If you installed SGM in the default directory, /opt, then the file is located at /opt/CSCOsgm/apache/share/htdocs/eventHelp directory. •If you installed SGM in a different directory, then the help directory and file are located in that directory. If the cell is too small to show all of the status reason, place the cursor over the cell to see the full status reason in a mouse over help popup. The status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude is displayed. If the status reason is Unsupported Configuration, correct the configuration and enter the sgm cleandiscover command to delete all current network data and begin a clean discovery of the ITP network. If the status reason is still Unsupported Configuration, enter the sgm clean command to restore the SGM server to a "clean" state, such as would exist after a new installation of SGM. For more information on the use of these commands, see the "SGM Command Reference" section.

Viewing Detailed Information for a Probe Connection

SGM can display detailed information about a selected probe connection, including its status, statistics information, and other information.

Updates for the probe connection that are received from the SGM server are reflected automatically in this window.

To display detailed information for a probe connection, use one of the following procedures:

•Select Probe Connections in the left pane of the SGM Main Window, right-click a probe connection in the right pane, then select View > Configuration Details in the right-click menu.

•Select the turner beside Probe Connections in the left pane of the SGM Main Window, then select a probe connection.

SGM displays the Probe Connection Details Window.

The Probe Connection Details Window is composed of the following sections:

•Probe Connection Details: Right-Click Menu

•Probe Connection Details: Components

•Probe Connection Details: Configuration Data

•Probe Connection Details: Notes

•Probe Connection Details: Recent Events

Related Topics:

•Viewing Basic Information for Probe Connections

Probe Connection Details: Right-Click Menu

The Probe Connection Details Window provides a right-click menu. To see this menu for a probe connection, select a probe connection in the left pane and click the right mouse button. The probe connection details right-click menu provides the following options:

Menu Command	Description
Show In New Window	Opens the Probe Connection Details Window for the selected probe connection in a new window.
Edit Notes	Opens the Edit Notes Dialog for the selected probe connection. If you have implemented SGM User-Based Access, this option is available to users with authentication level Power User (Level 2) and higher.
Clear Event Icon	Deletes the event icon (orange triangle) from SGM displays for the selected probe connection, for this SGM client only. The actual events are not deleted from SGM, only the event icon for the selected probe connection for this SGM client. This option is grayed-out if the selected probe connection has no associated event icon.
Delete	Deletes the currently selected probe connection from the SGM database. SGM displays the Confirm Deletion dialog: •To delete the selected probe connection, click Yes. The probe connection is deleted from the SGM database and the Confirm Deletion dialog is closed. •To retain the selected probe connection, click No. The probe connection is kept in the SGM database and the Confirm Deletion dialog is closed. •To prevent SGM from displaying the Confirm Deletion dialog, select the Do not show this again checkbox. Note If you select the Do not show this again checkbox, and you later decide you want SGM to begin displaying the Confirm Deletion dialog again, you must select the Confirm Deletions checkbox in the General GUI settings in the Preferences window. For more information, see the description of the Confirm Deletions checkbox in the "Startup/Exit Settings" section. If you have implemented SGM User-Based Access, this option is available to users with authentication level Network Administrator (Level 4) and higher.
Go To > Node	Displays the Node Window for the node associated with this probe connection.
Back > List of Windows	Navigates back to a window viewed in this session. SGM maintains a list of up to 10 Back windows.
Forward > List of Windows	Navigates forward to a window viewed in this session. SGM maintains a list of up to 10 Forward windows.
View > Configuration Details	Displays the Configuration Data panel for the selected probe connection.
View > Notes	Displays the Notes panel for the selected probe connection. If there are no notes associated with the selected probe connection, this option is grayed-out.
View > Events	Displays the Recent Events panel for the selected probe connection.
View > Real-Time Data and Charts	Displays the SGM Real-Time Statistics Window for the selected probe connection.
Event History > Status Change Messages	Displays the SGM Network Status Log for Status Change Messages in a Web browser, with messages displayed for only the selected probe connection.
Event History > SNMP Trap Messages	Displays the SGM Network Status Log for SNMP Trap Messages in a Web browser, with messages displayed for only the selected probe connection.
Event History > Status and Trap Messages	Displays the SGM Network Status Log for Status Change Messages and SNMP Trap Messages in a Web browser, with messages displayed for only the selected probe connection.
Event History > Network Status Metrics	Displays the SGM Network Status Log for Metrics in a Web browser, with messages displayed for only the selected probe connection.
Ignore	Ignores the selected probe connection at the next polling cycle. If you have implemented SGM User-Based Access, this option is available to users with authentication level Power User (Level 2) and higher.
Unignore	Stops ignoring the selected probe connection at the next polling cycle. If you have implemented SGM User-Based Access, this option is available to users with authentication level Power User (Level 2) and higher.
Latest Reports: Probe Connection Statistics	Displays the most recent Probe Connection Statistics - Hourly Report for the probe connection, in a Web browser.
Latest Reports: Probe Link Statistics	Displays the most recent Probe Link Statistics - Hourly Report for the probe links associated with the probe connection, in a Web browser.

Probe Connection Details: Components

The Probe Connection Details: Components section displays information about the probe links that are associated with the selected probe connection. (If the probe connection is not associated with any probe links, the Probe Connection Details: Components section is empty.)

To see mouse over help popup for each column in the table, place the cursor over a column header.

If a cell is too small to show all of its data, place the cursor over the cell to see the full data in a mouse over help popup.

You can resize each column, or sort the table based on the information in one of the columns. By default, SGM displays all of the columns in the probe links table except Internal ID.

•To display hidden columns, right-click in the table header and select the checkboxes for the columns you want to display.

•To hide columns, right-click in the table header and clear the checkboxes for the columns you want to hide.

See the "Resizing, Sorting, and Hiding Table Columns" section for more information about resizing, sorting, displaying, or hiding columns.

The probe links table contains the following columns:

Column	Description
Internal ID	Internal ID of the probe link. The internal ID is a unique ID for every object, assigned by SGM for its own internal use. It can also be useful when the TAC is debugging problems.
Node	Node associated with the probe link.
Port	Port number used to establish the TCP connection for the probe.
Name	Name of the probe link.
Slot Number	Slot number support interface for the probe link.
Ignored	Indicates whether the probe link is to be included when aggregating and displaying SGM status information: •Clear the checkbox to include the probe link. This is the default setting. •Select the checkbox to exclude the probe link. This field can be edited by users with authentication level Power User (Level 2) and higher.
Notes	Indicates whether there is a note associated with the probe link.
Events	Indicates whether there is a recent event associated with the probe link. (Even if the server purges all of the events associated with the probe link, SGM continues to display the event icon in this field.) •To delete the event icon (orange triangle) from SGM displays for a specific probe link, select the probe link and click the icon. •To delete the event icon from SGM displays for all probe links, select Edit > Clear All Events from the SGM Main Menu. Note During Discovery, SGM might flag most probe links with an event icon. If the event icons are too distracting, use the Edit > Clear All Events menu option to remove them.
Last Status Change	Date and time that the status of the probe link last changed.
Status	Current status of the probe link. Possible values are: Active (green) Inactive (red) Unknown (red) For detailed definitions of each status, see the "Status Definitions for Probe Links" section.
Status Reason	Reason for the current status of the probe link. For a full list of possible reasons, see the stateReasons.html file: •If you installed SGM in the default directory, /opt, then the file is located at /opt/CSCOsgm/apache/share/htdocs/eventHelp directory. •If you installed SGM in a different directory, then the help directory and file are located in that directory. If the cell is too small to show all of the status reason, place the cursor over the cell to see the full status reason in a mouse over help popup. The status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude is displayed. If the status reason is Unsupported Configuration, correct the configuration and enter the sgm cleandiscover command to delete all current network data and begin a clean discovery of the ITP network. If the status reason is still Unsupported Configuration, enter the sgm clean command to restore the SGM server to a "clean" state, such as would exist after a new installation of SGM. For more information on the use of these commands, see the "SGM Command Reference" section.

Probe Connection Details: Configuration Data

The Probe Connection Details: Configuration Data section is composed of the following sub-sections:

•Naming Information

•Status Information

•Statistics Information

Naming Information

The Naming Information sub-section contains the following fields:

Field	Description
Node	Name of the node associated with the probe connection.
Port	Port number used to establish the TCP connection for the probe.
Links	Total number of probe links in the probe connection.
Active Links	Number of probe links in the probe connection that are Active.

Status Information

The Status Information sub-section contains the following fields:

Field	Description
Is Ignored	Indicates whether the probe connection is Ignored (that is, whether the probe connection is to be included when aggregating and displaying SGM status information).
Congested	Indicates whether there is congestion on the probe connection. A probe connection is congested if it has too many packets waiting to be sent. This condition could be caused by the failure of an element in your network.
Status	Current status of the probe connection. Possible values are: Active (green) Inactive (red) Unknown (red) Warning (yellow) For detailed definitions of each status, see the "Status Definitions for Probe Connections" section.
Last Status Change	Date and time that the status of the probe connection last changed.
Status Reason	Reason for the current status of the probe connection. For a full list of possible reasons, see the stateReasons.html file: •If you installed SGM in the default directory, /opt, then the file is located at /opt/CSCOsgm/apache/share/htdocs/eventHelp directory. •If you installed SGM in a different directory, then the help directory and file are located in that directory. If the cell is too small to show all of the status reason, place the cursor over the cell to see the full status reason in a mouse over help popup. The status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude is displayed. If the status reason is Unsupported Configuration, correct the configuration and enter the sgm cleandiscover command to delete all current network data and begin a clean discovery of the ITP network. If the status reason is still Unsupported Configuration, enter the sgm clean command to restore the SGM server to a "clean" state, such as would exist after a new installation of SGM. For more information on the use of these commands, see the "SGM Command Reference" section.

Statistics Information

The Statistics Information sub-section contains the following fields:

Field	Description
Keepalive (msecs)	Keepalive timeout value, in milliseconds. Keepalive packets are sent between the ITP monitor and the remote server to ensure that the TCP session is active and to detect session failures. During idle periods, the monitor sends keepalive packets to the remote server at intervals specified by the Keepalive value. The monitor expects to receive keepalive packets from the remote server at the same interval. If the monitor does not receive a keepalive packet from the remote server in twice the Keepalive value, the monitor closes the TCP session. A Keepalive value of 0 means keepalive processing is not enabled.
Maximum Queue Depth	Maximum number of TCP packets that can be queued by the ITP monitor. If the monitor cannot send a TCP packet immediately, it queues the packet for resending. The Maximum Queue Depth field identifies the maximum number of TCP packets that can be in the queue. If the Maximum Queue Depth value is reached, additional TCP packets are dropped.
Congestion Onset	Number of queued TCP packets that indicates the onset of congestion. When the queue depth reaches the value specified by the Congestion Onset field, the connection is considered congested. The congestion remains congested until the queue depth drops below the value specified by the Congestion Abate field.
Congestion Abate	Number of queued TCP packets that indicates the end of congestion. When the queue depth drops below the value specified by the Congestion Abate field, the connection is considered no longer congested.
Receive Window Size (bytes)	Current TCP receive window size for this probe link, in bytes. That is, the number of outstanding (unacknowledged) bytes that the ITP monitor can receive on the TCP connection.
Fast Start	Indicates whether the fast-start option for establishing TCP connectivity is enabled or disabled. Typically, after the TCP session with the remote server is established, the ITP monitor does not send MSUs from the monitored links to the server until the server responds to the first keepalive. This prevents the ITP from over-running the server until the TCP session and receive window sizes are fully established. Fast-start overrides this mechanism and allows the ITP to start sending MSUs to the server immediately after the TCP session is established.

Probe Connection Details: Notes

The Probe Connection Details: Notes section displays:

•Notes associated with the selected probe connection.

•The date and time the notes associated with the probe connection were last updated, or the phrase Not Set if there are no notes associated with the probe connection.

•The phrase No Notes if there are no notes associated with the probe connection.

Probe Connection Details: Recent Events

The Probe Connection Details: Recent Events table displays about all recent events associated with the probe connection, and enables you to perform event-related tasks, such as setting filters and acknowledging events.

To see mouse over help popup for each column in the table, place the cursor over a column header.

If a cell is too small to show all of its data, place the cursor over the cell to see the full data in a mouse over help popup.

You can resize each column, or sort the table based on the information in one of the columns. By default, SGM displays all of the columns in the table except Internal ID, Note, Message Name, Ack By, Ack Time, Node, SP, Linkset, Link, SGMP, ASP, AS, ASPA, Probe Conn, and Probe Link.

•To display hidden columns, right-click in the table header and select the checkboxes for the columns you want to display.

•To hide columns, right-click in the table header and clear the checkboxes for the columns you want to hide.

See the "Resizing, Sorting, and Hiding Table Columns" section for more information about resizing, sorting, displaying, or hiding columns.

The Probe Connection Details: Recent Events table contains the following toolbar buttons and columns:

Toolbar Button or Column	Description
Set Filter	Opens the Event Filter dialog.
Apply Filter or Remove Filter	Activates and deactivates the event filter specified in the Event Filter dialog: •If the filter is activated, SGM displays only those events that pass the filter. •If the filter is deactivated, SGM displays all events. •If you activate a filter in an object's Recent Events table in the SGM Main Window, the filter is activated in all Recent Events tables in the SGM Main Window for all other objects. The filter is not activated in Recent Events tables in Show In New Window windows or Real-Time Data and Charts windows.
Pause or Resume	Pauses or resumes the table. While the table is paused, SGM does not display new events in the table (unless you apply an event filter or edit your event preferences). When the table is resumed, all new events since the table was paused are added to the display. If events are deleted while the table is paused, they are not removed from the table. Instead, they are grayed-out and cannot be acknowledged or edited. Deleted events are removed from the table when you resume the table.
Acknowledge	Makes the selected event or events acknowledged.
Unacknowledge	Makes the selected event or events unacknowledged.
Event Properties	Opens the Event Properties window.
Edit Notes	Opens the Edit Event Dialog.
Time Difference	Displays the difference in days, minutes, hours, and seconds between two events.
Find	Finds specific text in the event table.
Create Sound Filter	Opens the Event Sound Filters dialog and the Event Sound Filters List dialog, with fields populated based on the selected event.
Adjust Row Height	Adjusts the table row height and wraps the message text as follows: •Click once to double the row height and wrap the message text. •Click again to triple the row height and wrap the message text. •Click again for single row height and no message text wrapping. This is the default setting. This setting is saved automatically with your preferences.
Help for Event	Displays context-sensitive help for the selected event in a separate Web browser.
Internal ID	Internal ID of the event. The internal ID is a unique ID for every object, assigned by SGM for its own internal use. It can also be useful when the TAC is debugging problems.
Ack	Indicates whether the event has been acknowledged: •To acknowledge an unacknowledged event, use the Acknowledge toolbar button. •To make a previously acknowledged event unacknowledged, use the Unacknowledge toolbar button.
Category	Type of the event. Default values are: •Create—Creation event, such as the creation of a seed file. •Delete—Deletion event, such as the deletion of an object or file. •Discover—Discovery event, such as Discovery beginning. •Edit—Edit event. A user has edited an object. •Ignore—Ignore event. A user has Ignored a link or linkset. •Login—Login event. A user has logged in to SGM. •LoginDisable—LoginDisable event. SGM has disabled a user's User-Based Access authentication as a result of too many failed attempts to log in to SGM. •LoginFail—LoginFail event. An attempt by a user to log in to SGM has failed. •Logout—Logout event. A user has logged out of SGM. •OverWrite—OverWrite event. An existing file, such as a seed file or route file, has been overwritten. •Poll—Poll event, such as an SNMP poll. •Purge—Purge event. A user has requested Discovery with Delete Existing Data selected, and SGM has deleted the existing SGM database. •Status—Status change message generated. •Trap—SNMP trap message generated. You can customize this field. See the "Changing Event Categories" section for more information.
Severity	Severity of the event. Default values are: •Admin—The default color is cyan. •Error—The default color is coral. •None—The default color is white. •Normal—The default color is light green. •Warning—The default color is yellow. You can customize this field. See the "Changing Event Severities and Colors" section for more information.
Note	Indicates whether there is a note associated with the event.
Message Name	User-specified message name for the event, used by SGM for trap forwarding. The default message name is SGM. For more information about user-specified message names and trap forwarding, see the "Forwarding Events as Traps to Other Hosts" section.
Time	Date and time the event was logged.
Ack By	If you have not implemented SGM User-Based Access, name of the device that last acknowledged the event. If you have implemented SGM User-Based Access, name of the user who last acknowledged the event. If no one has acknowledged the event, this field is blank.
Ack Time	Date and time the event was last acknowledged or unacknowledged.
Node	Name of the node associated with the event. If there is no node associated with the event, None is displayed.
SP	Name of the signaling point associated with the event. If there is no signaling point associated with the event, None is displayed.
Linkset	Name of the linkset associated with the event. If there is no linkset associated with the event, None is displayed.
Link	Name of the link associated with the event. If there is no link associated with the event, None is displayed.
SGMP	Name of the signaling gateway mated pair associated with the event. If there is no signaling gateway mated pair associated with the event, None is displayed.
ASP	Name of the application server process associated with the event. If there is no application server process associated with the event, None is displayed.
AS	Name of the application server associated with the event. If there is no application server associated with the event, None is displayed.
ASPA	Name of the application server process association associated with the event. If there is no application server process association associated with the event, None is displayed.
Probe Conn	Name of the probe connection associated with the event. If there is no probe connection associated with the event, None is displayed.
Probe Link	Name of the probe link associated with the event. If there is no probe link associated with the event, None is displayed.
Message	Text of the message. You can customize this field. See the "Changing the Way SGM Processes Events" section for more information.

Viewing Real-Time Data for a Probe Connection

SGM enables you to view detailed statistics for a selected probe connection.

To display detailed statistics for a probe connection, select Probe Connections in the left pane of the SGM Main Window, right-click a probe connection in the right pane, then select View > Real-Time Data and Charts in the right-click menu. SGM displays the Statistics Details Window for a Probe Connection.

Updates for the probe connection that are received from the SGM server are reflected automatically in this window.

Changes you make in this window might not be reflected throughout SGM until the next poll (by default, every 15 seconds). For information about changing the poll interval, see the "Probe Connection Statistics Details: Poll Settings" section.

---

Note This window polls your network periodically. To prevent unnecessary traffic on your network, close this window when you no longer need to refer to it.

---

The Statistics Details Window for a Probe Connection is composed of the following sections:

•Probe Connection Statistics Details: Poll Settings

•Probe Connection Statistics Details: Components

•Probe Connection Statistics Details: Configuration Data

•Probe Connection Statistics Details: Notes

•Probe Connection Statistics Details: Recent Events

•Probe Connection Statistics Details: Statistics

Probe Connection Statistics Details: Poll Settings

To view or change poll settings for the Probe Connection Statistics Details Window, select Poll Settings in the left pane. SGM displays the Probe Connection Statistics Details Poll Settings panel in the right pane.

The Probe Connection Statistics Details Poll Settings panel contains the following fields:

Field	Description
Poll Interval (secs)	New poll interval for the Probe Connection Statistics Details Window, in seconds. Enter the new poll interval in this field. The valid range is 15 seconds to an unlimited number of seconds. The default value is 15 seconds.
Current Poll Interval	Current poll interval for the Probe Connection Statistics Details Window, in seconds.
Number of Polls Received	Total number of polls received since polling began for the Probe Connection Statistics Details Window.
Running Time	Total elapsed time since polling began for the Probe Connection Statistics Details Window.
Last Message	Date and time of the last poll for the Probe Connection Statistics Details Window.
Poll Counter Mode	Displays the current mode for poll counters, and the date and time that counters were last reset. Possible modes are: •Since Reboot—Counters display values aggregated since the last reboot of the ITP, or since ITP last reset the counters. •Since Last Poll—Counters display values aggregated since the last poll. •Since User Reset—Counters display values aggregated since the last time they were reset by the user.
Reset Counters	Opens the SGM Reset Counters Dialog, which enables you to change SGM poller and counter settings. For more information, see the "Changing Real-Time Poller and Counter Settings" section.

Probe Connection Statistics Details: Components

The information presented in the Probe Connection Statistics Details: Components section is the same as that presented by the "Probe Connection Details: Components" section.

Probe Connection Statistics Details: Configuration Data

The information presented in the Probe Connection Statistics Details: Configuration Data section is the same as that presented by the "Probe Connection Details: Configuration Data" section.

Probe Connection Statistics Details: Notes

The information presented in the Probe Connection Statistics Details: Notes section is the same as that presented by the "Probe Connection Details: Notes" section.

Probe Connection Statistics Details: Recent Events

The information presented in the Probe Connection Statistics Details: Recent Events section is the same as that presented by the "Probe Connection Details: Recent Events" section.

Probe Connection Statistics Details: Statistics

The Probe Connection Statistics Details: Statistics section contains the following fields:

Field	Description
Port	Port number used to establish the TCP connection for the probe.
Queue Depth	Current number of TCP packets that are queued for resending by the ITP monitor.
Congestion Count	Number of times the probe connection has entered congestion since SGM polling began for the probe connection, or since SGM last reset the averages as a result of bad data.

Attaching a Note to a Probe Connection

SGM enables you to annotate a probe connection, attaching a descriptive string to it.

To attach a note to a probe connection, right-click the probe connection in a window, then select Edit > Notes in the right-click menu. SGM displays the Edit Notes Dialog for a Probe Connection.

The Edit Notes Dialog for a Probe Connection contains the following fields and buttons:

Field or Button	Description
Name	Name of the probe connection. You cannot edit this field.
Note Last Updated	Date and time the Notes field for this probe connection was last updated. If there is no note currently associated with this probe connection, this field displays the value Not Set. You cannot edit this field.
Notes	Notes to associate with this probe connection. In this field, you can enter any important information about the probe connection, such as a detailed description, its location, its service history, and so on.
Save	Saves changes you have made to the probe connection's notes, updates all SGM windows to reflect your changes, and exits the dialog. When you annotate a probe connection, the topology map in the Topology Window displays a note icon in the upper left corner of the probe connection element.
Cancel	Exits the dialog without saving any changes.
Help	Displays online help for the dialog.

Related Topics:

•Viewing Basic Information for Probe Connections

•Viewing Detailed Information for a Probe Connection

•Viewing Notes for a Probe Connection

Viewing Notes for a Probe Connection

SGM enables you to view any notes that have been associated with a probe connection.

To view a note for a probe connection, right-click a probe connection in a window, then select View > Notes in the right-click menu. (The Notes option is grayed-out if there is no note associated with the selected probe connection.)

SGM displays the Notes panel for the selected probe connection, which displays:

•Notes associated with the selected probe connection.

•The date and time the notes associated with the probe connection were last updated, or the phrase Not Set if there are no notes associated with the probe connection.

•The phrase No Notes if there are no notes associated with the probe connection.

Related Topics:

•Attaching a Note to a Probe Connection

Deleting a Probe Connection

After Discovery, the probe connections in your network are known to SGM and added to the SGM database. Physically deleting probe connections from your network is not the same as deleting them from the SGM database. The following sections describe the differences between deleting probe connections from your network and deleting them from the SGM database, and the procedures for doing so:

•Deleting a Probe Connection from Your Network

•Deleting a Probe Connection from the SGM Database

Deleting a Probe Connection from Your Network

If you physically delete a known probe connection from your network (for example, by powering down an ITP), it remains in the SGM database, SGM labels it Unknown, and it is the system administrator's responsibility to delete it from the SGM database, if you choose to do so.

Deleting a Probe Connection from the SGM Database

Typically, you delete a probe connection from the SGM database for one of the following reasons:

•You have physically deleted the probe connection from your network. This is the most common reason for deleting a probe connection from the SGM database.

•The probe connection is Down, Inactive, or Unknown, you are aware of the reason, and you no longer want to see it in SGM displays. For example, the probe connection might be a test lab device.

If you have physically deleted a known probe connection from your network, and you then delete it from SGM, it is no longer in the SGM database, it does not appear in SGM windows, and it is not discovered when you run Discovery.

If you have not physically deleted a known probe connection from your network, and you delete it from SGM, at the next poll SGM finds the probe connection and adds it back to the SGM database, setting the status appropriately. If this happens, do not delete the probe connection again. Instead, set it to Ignored. See the "Ignoring a Probe Connection" section for more information.

---

Note If you delete a probe connection from the SGM database, the probe connection is deleted for all SGM clients and views connected to that SGM server.

---

To delete a probe connection from the SGM database, use one of the following procedures:

•Select one or more probe connections in a window, then select Edit > Delete from the SGM Main Menu.

•Right-click a probe connection in a window, then select Delete in the right-click menu. (You cannot delete more than one probe connection at a time from the right-click menu.)

SGM asks you to confirm the deletion:

•Select Yes to delete the selected probe connections. SGM deletes the probe connections from the SGM database.

•Select No to return to the window without deleting any probe connections from the SGM database.

Ignoring a Probe Connection

You can instruct SGM to ignore a probe connection when it aggregates and displays network data. Setting probe connections to Ignored prevents known probe connection problems from affecting SGM displays for associated objects. In effect, you are preventing a known problem from distracting you from other, more urgent network problems.

For example, you can set a probe connection to Ignored before shutting down the probe connection for maintenance.

---

Note If you set a probe connection to Ignored, the probe connection is ignored for all SGM clients and views connected to that SGM server.

Also, if you set a probe connection to Ignored, make a note of the change, and do not forget to reset the probe connection when the problem is corrected or the maintenance is complete.

---

To set a probe connection to Ignored, right-click the probe connection in the Probe Connection Details window, then select Ignore from the right-click menu.

Viewing Ignored Probe Connections

To display all probe connections that are Ignored, display the Probe Connection Window and click the Ignored column header. SGM displays all ignored probe connections at the top of the table.

Viewing Probe Connection Information Using a Web Browser

SGM enables you to use a Web browser to view the following information about probe connections:

•Viewing the Network Status Probe Connection Dashboard

•Viewing ITP Probe Connection Status

•Viewing ITP Probe Connection Details

Viewing the Network Status Probe Connection Dashboard

The SGM Probe Connection Dashboard page lists all discovered probe connections, and provides links to messages and metrics for each probe connection.

To access the SGM Probe Connection Dashboard page, select Network Status Dashboard from the SGM Server Home Page, then click Probe Connection Dashboard.

The Probe Connection Dashboard table contains the following columns:

Column	Description
Server Name (in header)	Name of the SGM server associated with the probe connection.
Update Interval (in header)	Time between automatic updates for the page. None means the page is not automatically updated.
Last Update (in header)	Date and time the information on the page was last updated by SGM.
Probe Connections	Probe connections discovered by SGM. You can sort the table based on the information in the Probe Connections column. See the "Resizing, Sorting, and Hiding Table Columns" section for more details.
Drill-Down Links: Messages	Displays messages associated with a given probe connection. To see status change messages and SNMP trap messages associated with the probe connection, click Messages.
Drill-Down Links: Metrics	Displays metrics associated with a given probe connection. To see network status metrics associated with the probe connection, click Metrics.
Latest Reports: Probe Connection Statistics	Displays the most recent Probe Connection Statistics - Hourly Report for the probe connection, in a Web browser.
Latest Reports: Probe Link Statistics	Displays the most recent Probe Link Statistics - Hourly Report for the probe links associated with the probe connection, in a Web browser.
Displaying Results	Shows the total number of results found, and allows you to page through the results. To configure the page range counts, see the "Changing SGM Web Preferences" section.

Viewing ITP Probe Connection Status

The SGM ITP Probe Connections Status page displays information about all discovered probe connections, including their names, status, and other important information.

To access the SGM ITP Probe Connections Status page, select Probe Connection Status from the menu bar of any network object status Web page.

You can sort the Probe Connections Status table based on the information in any column. See the "Resizing, Sorting, and Hiding Table Columns" section for more details.

The Probe Connections Status table contains the following columns:

Column	Description
Server Name (in header)	Name of the SGM server associated with the probe connection.
Update Interval (in header)	Time between automatic updates for the page.
Last Update (in header)	Date and time the information on the page was last updated by SGM.
Node Name	Name of the node associated with the probe connection. To see detailed information for the node, click the node name.
Port	Port number used to establish the TCP connection for the probe.
Congested	Indicates whether the probe connection is congested.
Status	Current status of the probe connection, with a color-coded background. Possible values are: Active (green) Inactive (red) Unknown (red) Warning (yellow) For detailed definitions of each status, see the "Status Definitions for Signaling Gateway Mated Pairs" section.
Status Reason	Reason for the current status of the probe connection. For a full list of possible reasons, see the stateReasons.html file: •If you installed SGM in the default directory, /opt, then the file is located at /opt/CSCOsgm/apache/share/htdocs/eventHelp directory. •If you installed SGM in a different directory, then the help directory and file are located in that directory. If the cell is too small to show all of the status reason, place the cursor over the cell to see the full status reason in a mouse over help popup. The status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude is displayed. If the status reason is Unsupported Configuration, correct the configuration and enter the sgm cleandiscover command to delete all current network data and begin a clean discovery of the ITP network. If the status reason is still Unsupported Configuration, enter the sgm clean command to restore the SGM server to a "clean" state, such as would exist after a new installation of SGM. For more information on the use of these commands, see the "SGM Command Reference" section.

Viewing ITP Probe Connection Details

The SGM Probe Connections Details page displays detailed information about a probe connection.

To access the SGM Probe Connections Details page, click the Port connection number on the SGM ITP Probe Connections Status page.

You can sort the Probe Connections Details table based on the information in any column. See the "Resizing, Sorting, and Hiding Table Columns" section for more details.

The Probe Connections Details table contains the following fields:

Column	Description
Server Name (in header)	Name of the SGM server associated with the probe connection.
Update Interval (in header)	Time between automatic updates for the page.
Last Update (in header)	Date and time the information on the page was last updated by SGM.
Node	Name of the node associated with the probe connection. To see detailed information for the node, click the node name.
Probe Connection Port	Port number used to establish the TCP connection for the probe.
Drill-Down Links: Messages	Displays messages associated with a given probe connection. To see status change messages and SNMP trap messages associated with the probe connection, click Messages.
Drill-Down Links: Metrics	Displays metrics associated with a given probe connection. To see network status metrics associated with the probe connection, click Metrics.
Latest Reports: Probe Connection Statistics	Displays the most recent Probe Connection Statistics - Hourly Report for the probe connection, in a Web browser.
Latest Reports: Probe Link Statistics	Displays the most recent Probe Link Statistics - Hourly Report for the probe links associated with the probe connection, in a Web browser.
Port	Port number used to establish the TCP connection for the probe.
Links	Total number of probe links in the probe connection.
Active Links	Number of probe links in the probe connection that are Active.
Congested	Indicates whether the probe connection is congested.
Status	Current status of the probe connection, with a color-coded background. Possible values are: Active (green) Inactive (red) Unknown (red) Warning (yellow) For detailed definitions of each status, see the "Status Definitions for Probe Connections" section.
Last Status Change	Date and time that the status of the probe connection last changed.
Status Reason	Reason for the current status of the probe connection. For a full list of possible reasons, see the stateReasons.html file: •If you installed SGM in the default directory, /opt, then the file is located at /opt/CSCOsgm/apache/share/htdocs/eventHelp directory. •If you installed SGM in a different directory, then the help directory and file are located in that directory. If the cell is too small to show all of the status reason, place the cursor over the cell to see the full status reason in a mouse over help popup. The status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude is displayed. If the status reason is Unsupported Configuration, correct the configuration and enter the sgm cleandiscover command to delete all current network data and begin a clean discovery of the ITP network. If the status reason is still Unsupported Configuration, enter the sgm clean command to restore the SGM server to a "clean" state, such as would exist after a new installation of SGM. For more information on the use of these commands, see the "SGM Command Reference" section.
Is Ignored	Indicates whether the probe connection is Ignored (that is, whether the probe connection is to be included when aggregating and displaying SGM status information).
Keepalive (msecs)	Keepalive timeout value, in milliseconds. Keepalive packets are sent between the ITP monitor and the remote server to ensure that the TCP session is active and to detect session failures. During idle periods, the monitor sends keepalive packets to the remote server at intervals specified by the Keepalive value. The monitor expects to receive keepalive packets from the remote server at the same interval. If the monitor does not receive a keepalive packet from the remote server in twice the Keepalive value, the monitor closes the TCP session. A Keepalive value of 0 means keepalive processing is not enabled.
Maximum Queue Depth	Maximum number of TCP packets that can be queued by the ITP monitor. If the monitor cannot send a TCP packet immediately, it queues the packet for resending. The Maximum Queue Depth field identifies the maximum number of TCP packets that can be in the queue. If the Maximum Queue Depth value is reached, additional TCP packets are dropped.
Congestion Onset	Number of queued TCP packets that indicates the onset of congestion. When the queue depth reaches the value specified by the Congestion Onset field, the connection is considered congested. The congestion remains congested until the queue depth drops below the value specified by the Congestion Abate field.
Congestion Abate	Number of queued TCP packets that indicates the end of congestion. When the queue depth drops below the value specified by the Congestion Abate field, the connection is considered no longer congested.
Receive Window Size (bytes)	Current TCP receive window size for this probe link, in bytes. That is, the number of outstanding (unacknowledged) bytes that the ITP monitor can receive on the TCP connection.
Fast Start	Indicates whether the fast-start option for establishing TCP connectivity is enabled or disabled. Typically, after the TCP session with the remote server is established, the ITP monitor does not send MSUs from the monitored links to the server until the server responds to the first keepalive. This prevents the ITP from over-running the server until the TCP session and receive window sizes are fully established. Fast-start overrides this mechanism and allows the ITP to start sending MSUs to the server immediately after the TCP session is established.
Queue Depth	Current number of TCP packets that are queued for resending by the ITP monitor.
Congestion Count	Number of times the probe connection has entered congestion since SGM polling began for the probe connection, or since SGM last reset the averages as a result of bad data.
Note	Note associated with this probe connection. If there is no note associated with this probe connection, this field is blank.

The Probe Connection Links section of the Probe Connections Details table contains the following fields:

Column	Description
Name	Name of the probe link associated with the probe connection.
Status	Current status of the probe link, with a color-coded background. Possible values are: Active (green) Inactive (red) Unknown (red) For detailed definitions of each status, see the "Status Definitions for Probe Links" section.
Drill-Down Links: Messages	Displays messages associated with a given probe link. To see status change messages and SNMP trap messages associated with the probe link, click Messages.
Drill-Down Links: Metrics	Displays metrics associated with a given probe link. To see network status metrics associated with the probe link, click Metrics.
Latest Reports: Probe Link Statistics	Displays the most recent Probe Link Statistics - Hourly Report for the probe link, in a Web browser.
Last Status Change	Date and time that the status of the probe link last changed.
Status Reason	Reason for the current status of the probe link. For a full list of possible reasons, see the stateReasons.html file: •If you installed SGM in the default directory, /opt, then the file is located at /opt/CSCOsgm/apache/share/htdocs/eventHelp directory. •If you installed SGM in a different directory, then the help directory and file are located in that directory. If the cell is too small to show all of the status reason, place the cursor over the cell to see the full status reason in a mouse over help popup. The status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude is displayed. If the status reason is Unsupported Configuration, correct the configuration and enter the sgm cleandiscover command to delete all current network data and begin a clean discovery of the ITP network. If the status reason is still Unsupported Configuration, enter the sgm clean command to restore the SGM server to a "clean" state, such as would exist after a new installation of SGM. For more information on the use of these commands, see the "SGM Command Reference" section.
Is Ignored	Indicates whether the probe link is Ignored (that is, whether the probe link is to be included when aggregating and displaying SGM status information).
Slot Number	Slot number support interface for the probe link.
Bits Rcvd (per sec)	Number of bits or bytes (as set in the Preferences window) received by the probe link per second. This field initially displays the phrase Waiting for second poll. After two polling cycles, SGM populates this field with actual calculated rates.
Bits Sent (per sec)	Number of bits or bytes (as set in the Preferences window) sent by the probe link per second. This field initially displays the phrase Waiting for second poll. After two polling cycles, SGM populates this field with actual calculated rates.
MSUs Rcvd (per sec)	Number of MTP3 MSUs received by the probe link per second.
MSUs Sent (per sec)	Number of MTP3 MSUs sent by the probe link per second.
MSUs Rcvd Count	Total number of MTP3 MSUs received by the probe link since SGM polling began for the probe link, or since SGM last reset the averages as a result of bad data.
MSUs Sent Count	Total number of MTP3 MSUs sent by the probe link since SGM polling began for the probe link, or since SGM last reset the averages as a result of bad data.
MSUs Rcvd Drops	Total number of MTP3 MSUs received by the probe link that were dropped as a result of congestion, since SGM polling began for the probe link, or since SGM last reset the averages as a result of bad data.
MSUs Sent Drops	Total number of MTP3 MSUs sent by the probe link that were dropped as a result of congestion, since SGM polling began for the probe link, or since SGM last reset the averages as a result of bad data.
Note	Note associated with this probe link. If there is no note associated with this probe link, this field is blank.
Probe Link Index	Index number that uniquely identifies a probe link associated with a probe connection, if the probe connection is associated with more than one probe link.