Enabling statistic reporting in the Monitoring Results database

One way to monitor what is happening in a cluster is to collect statistics in the Monitoring Results database. You can then view this information from the Domino® Administrator or in the Monitoring Results database itself.

About this task

  • In order to enable statistic reporting in the Monitoring Results database, you do the following:
  • Enable statistic report generation
  • Create a server statistic collection
  • Start the Statistic Collector task, if it is not already started

Alarm documents are created in the Monitoring Results database (STATREP.NSF) by the Statistic Collector task as part of the statistics monitoring process. Alarm documents show which server the alarm applies to, the date and time the alarm was reported, the severity level of the alarm, the number of times the alarm has been reported, the threshold setting, and the current value of the statistic associated with the alarm. Alarm documents reside in the Monitoring Results > Alarms view of the Server > Analysis tab in the Domino® Administrator.

Enabling statistic report generation

About this task

You cannot use the Web Administrator to enable statistic report generation.

Procedure

  1. From the Domino® Administrator, choose File > Preferences > Administration Preferences.
  2. Click the Statistics tab.
  3. Select Generate statistic reports while monitoring or charting statistics.
  4. Change any of the other setting you want, and then click OK.

Creating a server statistic collection

About this task

A server statistic collection specifies which statistics to collect in the Monitoring Results database.

Procedure

  1. From the Domino® Administrator or the Web Administrator, click the Configuration tab.
  2. In the Task pane, expand Monitoring Configuration, and then click Server Statistic Collection.
  3. Click New Statistics Collection.
  4. In the Collecting server section of the Basics tab, designate the server that will collect the statistics.
  5. In the Collect from section of the Basics tab, choose one of the following:
    • All servers in this domain
    • All servers that are not explicitly listed to be collected
    • From the following servers
  6. If you choose From the following servers in step 5, do the following:
    1. In the Server(s) field, enter the names of the servers from which you want to collect statistics.
    2. To collect statistics from all the servers in a cluster, choose From the following servers, and then enter the names of the cluster servers in the Server(s) field.
  7. Click the Options tab, and select Log statistics to a database.
  8. Optional: Do any of the following:
    • In the Database to receive reports field, enter the name of a database to store reports. By default, this is STATREP.NSF (the Monitoring Results database).
    • In the Collection report interval field, enter the number of minutes between reports. The minimum is 15.
    • In the Collection alarm interval field, enter the number of minutes between alarms. The minimum is 15.
    • In the Statistic Filters field, select the types of statistics you do NOT want to collect. By default, the server statistic collection includes all the types of statistics.

      To collect cluster replication statistics, do not select REPLICA in this field. The Cluster Manager statistics are always collected in statistic collections.

  9. Click Save & Close.

Starting the Statistic Collector task

About this task

Use one of the following procedures to start the Statistic Collector task.

Starting the Statistic Collector task automatically at server startup

About this task

To start the Statistic Collector task automatically each time you start the server, append the COLLECT parameter to the ServerTasks setting in the NOTES.INI file. For example,

ServerTasks=ROUTER,REPLICA,ADMINP,HTTP,ICM,COLLECT

Starting the Statistic Collector task for the current session only

You can run the Statistic Collector task for the current session only from either the Domino® or Web Administrator, or from the server console.

From the Domino® Administrator or the Web Administrator

Procedure

  1. In the Server pane, expand either All Servers or Clusters.
  2. Select the server you want.
  3. Click the Server > Status tab.
  4. In the Task pane, do one of the following:
    • From the Domino® Administrator, click Server Tasks.
    • From the Web Administrator, click All Server Tasks.
  5. In the Tools pane, expand Task, and then click Start.
  6. Select Statistic Collector, and then click Start Task.
  7. Click Done.

From the server console

About this task

Send the following Domino® command from the server console:

load collect