Home
IBM® Domino 10.0.1 Documentation
Welcome to the IBM® Domino 10.0.1 Administrator Help.
Administering
This documentation provides information about the administration tools for managing and monitoring IBM Domino® servers and databases.
Monitoring
This section describes how to use the tools and features that help you monitor a Domino® system.
Monitoring the Domino® system
You can monitor system activity and platform use using one of three tools -- the Domino® Administrator, the Web Administrator, or the server console.
Event handlers
An event handler defines the action that Domino® takes when a specific event occurs.
Disabling an event handler
You may want to disable an event handler that you created. For example, if you create an event handler to help you troubleshoot replication problems, after you resolve the problems, you can disable the event handler. Then, when you need to do replication troubleshooting again, just enable the event handler.

IBM® Domino 10.0.1 Documentation
Welcome to the IBM® Domino 10.0.1 Administrator Help.
- What's new in IBM® Domino® 10?
  Learn about all of the new features for administrators in IBM® Domino® 10.
- Overview
  Welcome to IBM® Domino® Administrator Help.
- Installing
  Use this documentation to install the IBM® Domino® server and subsequently deploy the IBM Notes® client.
- Planning
  Use this topic as an overview of planning task.
- Configuring
  Use this information to configure an IBM® Domino® network, users, servers (including Web servers), directory services, security, messaging, widgets and live text, and server clusters. Also use this information to set up IBM iNotes® on a server using Domino Off-Line Services (DOLS).
- Securing
  This section describes IBM® Domino® security features, including execution control lists, IDs, and SSL.
- Administering
  This documentation provides information about the administration tools for managing and monitoring IBM Domino® servers and databases.
  - Administration tools
    Topics in this section describe the tools you can use to administer a Domino® server.
  - Monitoring
    This section describes how to use the tools and features that help you monitor a Domino® system.
    - Monitoring the Domino® system
      You can monitor system activity and platform use using one of three tools -- the Domino® Administrator, the Web Administrator, or the server console.
      - Monitoring Configuration application (EVENTS4.NSF)
        The Monitoring Configuration application includes a configuration user interface for use with Domino® Domain Monitoring (DDM). Use this interface to set up DDM probes and a collection hierarchy of servers that collect information from other servers.
      - Monitoring server shutdown
        Domino's Shutdown Monitor task ensures that Domino® terminates when requested to do so, that is, the server does not hang while attempting to shut down.
      - Monitoring processes running in the Domino® server environment
        Domino's "Process Monitor" task applies to Domino® on Microsoft™ Windows™ platforms only. This task monitors the processes that should be running as part of the Domino server environment.
      - Monitoring events on the Domino® system
        Events signal both that the system is working smoothly, processing data, and performing tasks; or that the system is malfunctioning, perhaps by not processing data or performing required tasks.
      - Event generators
        Event generators gather information by monitoring a task or a statistic or by probing a server for access or connectivity. Each event generator has a specified threshold or condition, which, when met, causes an event to be created The event is passed to the Event Monitor task, which checks whether an associated event handler has been defined. If an event handler has not been defined, the Event Monitor task does nothing. If an event handler has been defined, the Event Monitor carries out the instructions in the event handler. The Event Monitor task, formerly know as the Event task, starts automatically when you start the server and must run on all servers that you want to monitor.
      - Monitoring iNotes® activity
        You can determine the number of active IBM® iNotes® users on a system and log iNotes request information. To monitor this activity, set up activity logging to include iNotes.
      - Event handlers
        An event handler defines the action that Domino® takes when a specific event occurs.
        Event handler notification methods
        Depending on the type or severity of an event, you may want to be notified immediately by an alarm, email message, or server-console message. When you specify a handler notification method, you also specify where events are reported.
        Event types used to specify event criteria
        When you create an event handler based on matching the event criteria, you must specify the type of event.
        Creating an event handler
        When you create an event generator, you can launch the event handler wizard to create an event handler at the same time. You can also manually create an Event Handler document in the Monitoring Configuration database (EVENTS4.NSF).
        Disabling an event handler
        You may want to disable an event handler that you created. For example, if you create an event handler to help you troubleshoot replication problems, after you resolve the problems, you can disable the event handler. Then, when you need to do replication troubleshooting again, just enable the event handler.
        Creating log filters
        By default, Domino® logs all events to the log file (LOG.NSF), which can become quite large, depending on the log level set for each event. To prevent events from being logged either to the log file or to the server console, create a log filter that specifies both the type and severity of the event to filter. Then only events that meet the specified criteria appear in the log file.
        Viewing event handlers and log filters
        You can view default and custom event handlers and log filters.
      - Viewing an event report
        The Monitoring Results database (STATREP.NSF) stores statistic and event information, depending on how you configured the Statistic Collector server task and event handler documents. For each event, a report records the server that originated the event; the time, severity, type and error code of the event; and a brief description of the event.
      - Viewing event messages, causes, and solutions
        Each event that occurs on the Domino® system has an associated event message that is stored in the Monitoring Configuration database (EVENTS4.NSF). The message text often provides information about possible causes and solutions.
      - Customizing the Domino® server and administrator console
        By creating a Server Console configuration document for the server you are monitoring, you can specify the text, background, and color attributes that the Domino® server console uses to display monitoring information. By default, the Domino Administrator server console uses the same attributes, but you can override the defaults and customize the appearance of the Domino Administrator server console.
      - Monitoring system statistics
        Domino® continuously generates and updates server statistics, which you can collect and monitor in a number of ways. From the server, you can use the Show Statistic or Show Platform Statistic commands. From the Domino Administrator, you can create statistics profiles and charts.
      - Platform statistics
        In addition to tracking server statistics, Domino® tracks operating-system performance statistics. You can view these statistics from the Domino Administrator, along with your Domino statistics, which helps you with Domino server monitoring and tuning. You can include platform statistics in any statistic monitoring task you perform with the Domino statistics, including using them in monitoring and statistic profiles, and charting them.
      - Using the Domino® Administrator to monitor statistics
        Using the Domino® Administrator, you can create a statistic profile that you use to monitor the same set of statistics periodically or to compare performance on different servers.
      - Using mail-in statistics
        If you can access Notes® mail on a server, you can collect statistics from the server and mail them to yourself. Use mail-in statistics when the Domino® Administrator is not available or you do not have administrator access to a server.
      - Charting statistics
        You can graphically display the statistics generated by Domino®, by creating statistics charts. To chart sets of statistics on a regular basis, you can define statistics profiles. Using statistics charts you can track and visualize statistics in real time or historically. Real-time charts reflect the current server activity. Historical charts pull information from the local Monitoring Results database (STATREP.NSF). You can also create statistic profiles so that you can chart a specified set of statistics routinely.
      - Publishing Domino statistics to external services
        You can set up Domino to publish Domino statistics to an external monitoring service, for example, Hosted Graphite. The service must be able to accept time series data via HTTP POST requests.
    - Server Health Monitor
      You can monitor and troubleshoot performance issues using a number of different tools.
    - Domino® domain monitoring (DDM)
      Domino® domain monitoring (DDM) provides one location in the Domino Administrator client that you can use to view the overall status of multiple servers across one or more domains, and then use the information provided by DDM to quickly resolve problems.
    - The Domino® SNMP Agent
      The Domino® SNMP Agent enhances the monitoring and control features of Domino by enabling third-party management stations, which use industry standard SNMP, to manage aspects of the Domino server.
    - Overview of server maintenance
      As a Domino® administrator, a major part of your job is maintaining each server that you administer.
    - Tools for mail monitoring
      Domino® provides three tools that you can use to monitor mail. Message tracking allows you to track specific mail messages to determine if the intended recipients received them. Mail usage reports provide the information you need to resolve mail problems and improve the efficiency of your mail network. Mail probes test and gather statistics on mail routes.
    - Monitoring directory assistance
      You can monitor directory assistance by using Show Xdir command to display information about all the directories a server uses for directory services. You can also view directory assistance statistics.
    - Monitoring databases
      You can monitor database activity, replication, and document deletions.
    - Monitoring a cluster
      Domino® provides several ways to find out what is happening in a cluster and make adjustments to keep the cluster running smoothly and efficiently, so that no server is overloaded. You can monitor failover, workload balancing, and cluster replication to see how efficiently the cluster is running.
    - Monitoring slow or unresponsive servers with the Domino® Diagnostic Probe
      Use the Domino® Diagnostic Probe (DDP), a Java™ utility provided by IBM® Support, to monitor Domino 8.x and later servers that have been intermittently slow or unresponsive. The probe is a Java process (dbopen.jar) that runs in the background. The utility probes a specific Domino server over time by invoking database open transactions. If the probe detects a slow response, it will invoke Notes® System Diagnostic (NSD) to gather diagnostic data. This data is used by IBM Support to troubleshoot and determine the cause or causes of the performance degradation.
    - Monitoring quality of service
      Quality of Service, or QoS, is designed to react to the general operation of a Domino® server in order to keep that server functioning reliably and always available. If QoS detects that a server is not responding or hung, QoS probing can be configured to email an administrator about the problem and/or automatically terminate the server and restart it. QoS log information can also be useful for analysis by IBM® Support.
    - Understanding Quality of Service (QoS) behavior and logging
      This topic covers details of QoS including server and server controller behavior during kill events, failover trigger, and log file content.
  - Managing servers
    Manage Domino® servers by performing any of these tasks.
  - Managing databases
    Topics in this section describe how to set up and manage Domino® databases.
- Tuning
  Use this information to improve IBM® Domino® server, Domino Web server, and messaging performance through the use of resource balancing and activity trends, Server.Load commands, advanced database properties, cluster statistics, and the Server Health Monitor.
- Troubleshooting
  This section describes how to find and solve problems with IBM® Domino® server and Administrator client.
- Glossary

Disabling an event handler

You may want to disable an event handler that you created. For example, if you create an event handler to help you troubleshoot replication problems, after you resolve the problems, you can disable the event handler. Then, when you need to do replication troubleshooting again, just enable the event handler.

Procedure

From the Domino® Administrator, click the Configuration tab, and then open the Monitoring Configuration view.
Open the Event Handlers > All view.
Open the event handler you want to disable in edit mode.
Click the Action tab, and choose the field Disable this notification.
Save and close.