User's Guide
Statistics Handling
The following sections describe how to work with WEbLogic Network Gatekeeper statistics:
About statistics handling
The statistics functions measures the usage of BEA WebLogic Network Gatekeeper and the network service provided by BEA WebLogic Network Gatekeeper. The usage is measured in the number of transactions handled by each service.
Statistics reports can be generated for the whole system or for individual SLEEs and/or network services. Also, the desired time period can be specified.
A pre-defined report type is the weekly report. It shows the total BEA WebLogic Network Gatekeeper usage hour by hour during a specified week. The weekly report also shows total usage for each day and the average transaction rate (transactions/second (tps)) during the busy hour of each day. A busy hour is defined as the 60 minutes during which the largest number of transactions are handled. That is, any 60 minutes (5 minute intervals are used) can be the identified as the busy hour.
Viewing statistics - system view
Following the instruction below to display statistics data in the Network Gatekeeper Management Tool. Two different report types are possible:
- Customized statistics reports where it is possible to specify SLEE, statistics type and the time period during which the statistics was generated.
- Complete system statistics for the last minute(s).
Procedure:
- Start an Network Gatekeeper Management Tool and log in.
- Select any SLEE in the SLEEs pane.
- Double-click the SLEE_statistics service in the Services pane.
- To create and view a customized statistics report, double-click the getStatistics method and continue with Step 5..
To view the complete system statistics for the last minute(s), double-click the getSystemStatistics method and enter the number of minutes in the minutes field. Complete the task by clicking Invoke.
- Specify the one or all SLEEs using the sleeName field. See table below:
To view statistics data for...
|
Enter:
|
...one SLEE.
|
The SLEE name as specified at BEA WebLogic Network Gatekeeper installation.
For information on how to display a SLEE's SLEE name, see Viewing SLEE name.
|
...all SLEEs
|
Leave field empty.
|
- Specify one or all statistics types using the statisticsType field. See table below:
To view statistics data for...
|
Enter:
|
...a specific statistics type.
|
The statistics type identifier.
Available statistics types can be listed using the listStatisticsTypes method.
|
...all statistics types.
|
-1 (including the dash)
|
- Specify a time period using the fromDate and toDate fields. See table below:
fromDate
|
toDate
|
Displays statistics data generated...
|
Date (In format: YYYY-MM-DD hh:mm)
|
Date
|
...within the specified time period.
|
Date
|
|
...after the specified from date.
|
|
Date
|
...before the specified to data.
|
|
|
....until now.
|
The specified statistics is now displayed in the Messages pane.
Viewing statistics - service provider and application view
Following the instruction below to display service provider or application statistics data in the Network Gatekeeper Management Tool.
- Start an Network Gatekeeper Management Tool and log in.
- Select any SLEE in the SLEEs pane.
- Double-click the SLEE_statistics service in the Services pane.
- Double-click the getStatisticsAppID method.
- Specify the one or all SLEEs using the sleeName field. See table below:
To view statistics data for...
|
Enter:
|
...all SLEEs. (the whole system)
|
Leave field empty.
|
...a specific SLEE. (only application statistics generate by the specified SLEE will be displayed)
|
The SLEE name as specified at BEA WebLogic Network Gatekeeper installation.
For information on how to display a SLEE's SLEE name, see Viewing SLEE name.
|
- Specify one or all statistics types using the statisticsType field. See table below:
To view statistics data for...
|
Enter:
|
...a specific statistics type.
|
The statistics type identifier.
Available statistics types can be listed using the listStatisticsTypes method.
|
...all statistics types.
|
-1 (including the dash)
|
- Specify a time period using the fromDate and toDate fields. See table below:
fromDate
|
toDate
|
Displays statistics data generated...
|
Date (In format: YYYY-MM-DD hh:mm)
|
Date
|
...within the specified time period.
|
Date
|
|
...after the specified from date.
|
|
Date
|
...before the specified to data.
|
|
|
....until now.
|
- Enter the Service Provider ID in the entOpID field.
- Enter the Application ID in the clientAppID field.
Use an empty string to get aggregated statistics for all applications belonging to the service provider.
The specified statistics is now displayed in the Messages pane.
Printing statistics to file
Follow the instruction below to print a customized statistics data report to file.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_statistics service.
- Double-click the saveStatisticsToFile method.
- Specify the one or all SLEEs using the sleeName field. See table below:
To print statistics data for...
|
Enter:
|
...one SLEE.
|
The SLEE name as specified at BEA WebLogic Network Gatekeeper installation.
For information on how to display a SLEE's SLEE name, see Viewing SLEE name.
|
...all SLEEs
|
Leave field empty.
|
- Specify a file name with or without a path in the fileName field.
If no path is specified, the file is stored in the current SLEE's working directory.
- Specify one or all statistics types using the statisticsType field. See table below:
To print statistics data for...
|
Enter:
|
...a specific statistics type.
|
The statistics type identifier.
Available statistics types can be listed using the listStatisticsTypes method.
|
...all statistics types.
|
-1 (including the dash)
|
- Specify a time period using the fromDate and toDate fields. See table below:
fromDate
|
toDate
|
Prints statistics data generated...
|
Date (In format: YYYY-MM-DD hh:mm)
|
Date
|
...within the specified time period.
|
Date
|
|
...after the specified from date.
|
|
Date
|
...before the specified to data.
|
|
|
....until now.
|
The specified statistics is now printed to file.
Creating a weekly system statistics report
Follow the instruction below to create a weekly system statistics report. The report shows:
- the total number of transactions during the specified week
- the number of transactions during each hour of the days in the week
- the number of transactions during each day of the week
- the transaction rate (transactions/second (tps)) during the busy hour of each day
Procedure:
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_statistics service.
- Double-click the createWeeklyReport method.
- Specify the first day in the week using the startDate field.
Use format YYYY-MM-DD.
- Specify a file name with or without a path in the fileName field.
If no path is specified, the file is stored in the current SLEE's working directory.
The specified weekly report is now printed to file.
Deleting statistics data from the database
Follow the instruction below to delete statistics data from the database.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_statistics service.
- Double-click the deleteStatistics method.
- Specify the one or all SLEEs using the sleeName field. See table below:
To delete statistics data for...
|
Enter:
|
...one SLEE.
|
The SLEE name as specified at BEA WebLogic Network Gatekeeper installation.
For information on how to display a SLEE's SLEE name, see Viewing SLEE name.
|
...all SLEEs
|
Leave field empty.
|
- Specify one or all statistics types using the statisticsType field. See table below:
To delete statistics data for...
|
Enter:
|
...a specific statistics type.
|
The statistics type identifier.
Available statistics types can be listed using the listStatisticsTypes method.
|
...all statistics types.
|
-1 (including the dash)
|
- Specify a time period using the fromDate and toDate fields. See table below:
fromDate
|
toDate
|
Deletes statistics data generated...
|
Date (In format: YYYY-MM-DD hh:mm)
|
Date
|
...within the specified time period.
|
Date
|
|
...after the specified from date.
|
|
Date
|
...before the specified to data.
|
|
|
....until now.
|
The specified statistics is now deleted from the database.