Share via

Monitoring IAG sessions

  • Article

Applies To: Intelligent Application Gateway (IAG)

The Session window of the Whale Communications Intelligent Application Gateway (IAG) 2007 Web Monitor provides information about all the sessions that are currently open via all the IAG trunks you are monitoring.

Monitoring sessions

Monitor IAG sessions as follows.

To monitor sessions

  1. Open Web Monitor.

  2. To retrieve information about all sessions that are currently open, click Current Status in Session Monitor.

    A column chart displays each trunk in a separate column and shows the total number of authenticated and unauthenticated sessions that are currently open through the trunk. A table displays the active trunks and open sessions (authenticated and unauthenticated). By default, the window refreshes data every 15 seconds. For information about customizing the refresh rate, see Customizing Web Monitor.

  3. To monitor sessions over time, for a selected trunk or all trunks, in the Trunk Name list, next to a specific trunk name, click the icon. You can scroll to the period of time you want to monitor.

    Session behavior is displayed in a line chart, showing both authenticated and unauthenticated sessions and the total number of sessions, at predefined intervals. By default, the window refreshes the data at 10-second intervals.

  4. To receive a detailed snapshot of the sessions currently open for each trunk, click Active Session Monitor. Then in the active sessions windows, select the trunk from the Trunk list. Session settings for the trunk are displayed as follows:

    • Session ID—Unique session identifier

    • Lead User—The user who initiated the session

    • Repository—Authentication server used for user authentication

    • Started At—Date and time when the session started

    • Duration—Duration of the session

    • Authenticated—Indicates whether the session is authenticated. A session is unauthenticated if the user's identity is unknown (for example prior to completion of login) or if the session is suspended before it is closed.

    • Events—Clicking the Events button generates a report of events related to the session. It is displayed in the event reports window.

    • Terminate—Clicking the Error icon terminates the session. You are prompted to verify the termination. After verifying, the status of the session is changed to unauthenticated. Note that you cannot terminate the current session or unauthenticated sessions.

    By default, the data is refreshed every five minutes.

Example of session lifecycle

The following example describes a life cycle of a session in a trunk where the Automatic Scheduled Logoff option is activated and the Logoff Scheme is triggered every 60 minutes:

  1. As soon as a user accesses the site, an unauthenticated session is established.

  2. Once the user is authenticated, the session’s status changes to “authenticated”.

  3. 60 minutes later, the Scheduled Logoff is triggered, the session’s status changes to “unauthenticated”, and the user is prompted to re-authenticate.

  4. The user re-authenticates within the required timeframe, and the session is authenticated again.

  5. When the user finishes working with the site and logs off, the status of the session changes to “unauthenticated”. After a predefined period of time, the session closes. It is no longer displayed in the Session Monitor - Active Sessions window.

Session Details

The Session Details window is displayed when you click a session’s ID in any of the Web Monitor’s Active Sessions windows. You can use these windows to view and analyze the current status and history of IAG sessions, such as the number of concurrent sessions in a trunk. In-depth session information is provided, including the following:

  • General information about the session is provided on the General tab. The lead user is the user who initiated the session.

  • All of the applications for which a session user is authorized are displayed on the Applications tab.

  • Information about the client endpoint from which the session originated is displayed on the Endpoint Information tab. This includes information about the IP address and domain of the client endpoint, and it also includes information about IAG client components and other related software installed on the client endpoint.

  • Session parameters are displayed on the Parameters tab.

Monitoring session statistics

The session statistics window enables you to view and analyze both the history and the current status of IAG sessions, such as the number of concurrent sessions in a trunk. When you first access the window, the query form is displayed. You use the query form to submit a query. Query results are displayed in the statistics window.

Running a statistics query

Define a session statistics query as follows.

To run a session statistics query
  1. Open Web Monitor.

  2. In Session Monitor, click Statistics.

  3. In the Trunks list, select the trunk for which you want to generate the query.

  4. Specify a period of time for the query. You can either select a predefined period or define dates in Start date and End date.

  5. In Interval, define the interval at which the data is sampled. The available intervals depend upon the period of the query. For example, if the selected period is a day, only an “Hour” interval can be defined; for a period of a week, you can select an interval of either an hour or a day.

    By default, the maximum number of intervals that can be queried is 1,500. For more information about customizing this value, see Customizing Web Monitor. A value over 1,500 may slow down the performance of Web Monitor and is not recommended.

  6. In Query Type, select Sample Chart to specify that the number of concurrent sessions is sampled at the end of each interval. Select Peak Chart to specify that the number of concurrent sessions reported is the highest number of sessions that were open during the interval period.

  7. Click Submit to run the query. The results are displayed in the window.

    After you submit a query, when you return to the query form from the query results view, you can click Show last results to display the results of the last query submitted, regardless of any changes you might have made in the query form.

Query results are displayed in accordance with the settings you specified in the query. If query results are available only for a part of the defined period, this is also indicated under the Period field. A line chart displays the number of concurrent sessions for each of the trunks in the query. The color that represents each trunk on the chart is indicated in the legend to the left of the trunk name. A table displays information on each of the trunks that were queried. You view the data that is displayed in the chart in a tabular format by clicking the View Chart Data button. Use the paging and zooming controls to focus the view on the period of time you wish to monitor. When you zoom out to the smallest view, the window displays the entire period that is queried, up to the predefined interval limit. When you zoom in to the largest view, the window displays 10 intervals; to view additional intervals, use the paging controls. Click Show query form to return to the query form. The query results include the following:

  • Trunk—Indicates the trunk name.

  • Concurrent sessions—Minimum and maximum number of sessions concurrently open through the trunk during the query period.

  • Duration—Average and maximum duration of sessions open through the trunk during the query period. If the number of results exceeds the value specified in Max Report Results, duration is not reported. For more information about the Max Report Results value, see Configuring IAG log limits.

  • Concurrent Sessions Settings—Settings that are defined in the Session tab of the trunk properties. Threshold indicates the threshold above which each new session that opens generates a report, as defined in the Concurrent Sessions Threshold value in the Session tab. Limit indicates the maximum number of sessions that can be open through the trunk at the same time, as defined in the Max Concurrent Sessions value in the Session tab.

  • View—Clicking the View button adds the display of concurrent sessions threshold and limit to the chart; clicking the Hide Limit button removes the display from the chart.