Creating Events

Contents:

Filtering Event Triggers

 

Choosing and Defining Event Triggers

 

 

 

The Event Triggers tab is accessed from PHP Intelligence | Event Triggers.

 

Event generation is an out-of-the-box feature. Directly after installation, Platform’s PHP Intelligence will begin to monitor events according to Default Settings. To further enhance the effectiveness of PHP Intelligence, events thresholds can be customized. In a similar manner thresholds can be gradually modified to not only reflect improvements in performance but also to verify that problematic issues have been resolved.

Configuring Events

Events can be configured according to each environment’s specific requirements. The main configuration changes that should be done are to do with tuning Event Trigger values and defining a list of Functions and PHP errors to be monitored.

 

 

Instructions on how to complete a procedure

To Configure Event Triggers:

Go to PHP Intelligence | Event Triggers and change the default settings according to your requirements.

A help button help_button.png appears next to each Event Type. Pressing this button will display a description of the selected Event and the Event’s parameters (alternately go to Choosing and Defining Event Triggers).

 

Disabling Events (Triggers)

In some cases there may be Events that are either not applicable to your system or unnecessary. Events are disabled from the PHP Intelligence module. When an event is disabled the event will not be monitored and no event information will be stored.

 

 

Instructions on how to complete a procedure

To disable Event Triggers:

  1. Go to PHP Intelligence | Event Triggers and select "Configure Event Triggers".

  2. In the Define Event Triggers Table, the Check box in the Active Column indicates if an Event Type is monitored or not.

To prevent a selected Event from being monitored, disable the Rule by de-selecting the Check Box. This will deactivate and stop collecting event related information.

List Entry of Watched Functions

Platform allows you to monitor a list of functions by referencing a text file that includes the functions you wish to monitor. Users who must monitor large numbers of functions will find this method of defining watched functions a convenient alternative to editing the 'php.ini' file line by line.

Use the following PHP functions to reference a text file containing the list of functions to monitor.

The following function is typically used to create a list of functions to watch. It forms part of the 'php.ini' file.

zend_monitor.watch_functions=mysql_connect,mysql_query

The following function refers zend_monitor.watch_functions to a text file at a specific location. This file contains the list of functions to monitor.

Note:

Functions returning 'null' as an expected result, should not be included in this list.

UNIX, Linux, i5/OS and Mac:

'zend_monitor.watch_functions=@<installation_dir>/lib/watch_funcs.txt'  

'zend_monitor.watch_results=@/<installation_dir>/lib/watch_res.txt'

Windows:

'zend_monitor.watch_functions="@<installation_dir>\lib\watch_funcs.txt"'

'zend_monitor.watch_results="@<installation_dir>\lib\watch_res.txt"'

(In Windows the quotes must be present)

The text file should contain one function name per line.

Usage Example

Example:

mysql_connect

mysql_pconnect

mysql_query

mysql_db_query

mysql_unbuffered_query

User functions can also be included in the Watch Functions file. Each user function must be added with its Class (class::function).

If necessary, inheritances should also be included in the file as only functions explicitly specified in the Watched Functions file are watched.

 

 

Related Links

Related Links:
The Problem Resolution Lifecycle

Finding Events that Interest You

Why Configure Event Triggers?