Zend Monitor - Configuration Directives

This topic lists all the configuration directives for Zend Monitor.

Configuration Directives Summary

The table below is a summary of all the Zend Monitor configuration directives, and displays the directive name, its default value, and a description:

Directive

Default Value

Description

zend_monitor.enable

1

Enables or disables the Monitor component.

zend_monitor.log_verbosity

2

Monitor extension log verbosity level.

zend_monitor.log_rotation_size

10

The maximum size of the log file before it is rotated.

zend_monitor.shm_size

4194304 / 2097152

Amount of shared memory to allocate for event collection.

zend_monitor.events_transport_parameter

events.sock / events

Communication transport for event reporting to the Monitor Node.

zend_monitor.report_super_globals

PRGCVF

PHP Super-global variables to include in event reports.

zend_monitor.security_black_list

PHP Super-global values that should not be included in Zend Monitor events.

zend_monitor.super_globals_to_secure

PGCV

PHP Super-globals to pass through the security black-list filter.

zend_monitor.max_super_globals_string_len

100

The maximum length of a superglobal to include in an event report.

zend_monitor.event.request_slow_exec.disabled_on_function_slow_exec_event

0

Disable reporting of Slow Request Execution events if a Slow Function Execution event was reported.

zend_monitor.event.request_slow_exec.disabled_on_high_load.threshold

0

Sets the load level to disable Slow Request Execution events for the same request that already triggered a high load event.

zend_monitor.event.request_relative_slow_exec.min_exec_time

100

The minimum request execution time for a relativity check.

zend_monitor.event.request_relative_large_mem_usage.min_mem_usage

100

The minimum request memory usage for a relativity check.

zend_monitor.event.request_relative_large_output_size.min_output_size

100

The minimum request output size for a relativity check

zend_monitor.event.zend_error.silence_level

1

Controls PHP Error event reporting when PHP error reporting is supressed

zend_monitor.requests_statistics.warmup_requests

500

How many requests to run before deviation events are calculated (to collect data for the average). This is used to calculate averages for relative events.

zend_monitor.requests_statistics.request_lifetime

300

The time duration (in seconds) before statistics are reset if a request is not called.

zend_monitor.events_rules_file_name

monitor_rules.json

Event rules configuration file.

zend_monitor.use_fast_timestamp

0

Enables fast time sampling which is dependent on CPU cycles and frequency, otherwise, the directive uses operating system timing (which may be less accurate).

zend_monitor.event_tracing_mode

2

Determines integration with tracer mechanism in case of events that require a trace data dump.

zend_monitor.aggregate_by_url_query

0

When enabled, use the URL's query string as part of the aggregation key.

zend_monitor.aggregate_by_route

1

When enabled, use the request route details as part of the aggregation key.

zend_monitor.event_generate_trace_file

0

When enabled, an event will also trigger a code-tracing file generation.

Configuration Directives Details

The list below contains information for all the available configuration directives for Zend Monitor: their description, type, units, default value, modification scope, and the Zend Server version they became available in.

zend_monitor.enable

Enables or disables the Monitor component. When set to On, Zend Monitor will collect and report PHP events. When set to Off, PHP will not be monitored.

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.log_verbosity

The extension's log verbosity level.

Default Value: 2

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_monitor.log_rotation_size

The maximum size of the log file before it is rotated.

Default Value: 10

Units: MBytes

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.shm_size

Amount of shared memory to allocate for event collection. If exceeded, an error message is reported to the log.

Default Value:

  • Windows, Linux: 4194304
  • Mac OS X, IBMi: 2097152

Type: int

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_monitor.events_transport_parameter

Defines the network communication transport to be used when sending event reports from the Monitor Extension to the Monitor Node.

Default Value:

  • Linux, Mac OS X, IBMi: events.sock
  • Windows: events

Type: string

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_monitor.report_super_globals

Default Value: PRGCVF

Type: string

Modification Scope: ZEND_INI_ALL

Available Since Version: 3.6

zend_monitor.security_black_list

Default Value:

Type: string

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 3.6

zend_monitor.super_globals_to_secure

Default Value: PGCV

Type: string

Modification Scope: ZEND_INI_ALL

Available Since Version: 3.6

zend_monitor.max_super_globals_string_len

When the string is passed, any characters that exceed the limit are truncated and '...' is appended to the end of the string to indicate that this is a partial value.

Default Value: 100

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 3.6

zend_monitor.event.request_slow_exec.disabled_on_function_slow_exec_event

Disable reporting of Slow Request Execution events if a Slow Function Execution event was reported in the same request. This reduces the chance of getting double slow-execution reports triggered by the same underlying cause.

Default Value: 0

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.event.request_slow_exec.disabled_on_high_load.threshold

Sets the load level to disable Slow Request Execution events for the same request that already triggered a high load event.

Default Value: 0

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.event.request_relative_slow_exec.min_exec_time

The minimum execution time for a request to be compared to the average request execution time.

Default Value: 100

Units: milliseconds

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.event.request_relative_large_mem_usage.min_mem_usage

The minimum memory usage of a request to be compared to the average request memory usage.

Default Value: 100

Units: KBytes

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.event.request_relative_large_output_size.min_output_size

The minimum output size of a request to be compared to the average request output size.

Default Value: 100

Units: KBytes

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.event.zend_error.silence_level

Controls PHP Error event reporting when the silencing operator (@) is used or when the error_reporting level is set to 0. The values are:

Default Value: 1

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.requests_statistics.warmup_requests

How many requests to run before deviation events are calculated (to collect data for the average). This is used to calculate averages for relative events.

Default Value: 500

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.requests_statistics.request_lifetime

The time duration (in seconds) for holding statistics in memory. If a request is not called within that time period, the statistics are reset.

Default Value: 300

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.events_rules_file_name

The name and path to the file that contains the defininitons for event rules and actions. This file should not be edited manually.

Default Value: monitor_rules.json

Type: string

Modification Scope: ZEND_INI_SYSTEM

Available Since Version: 4.0

zend_monitor.use_fast_timestamp

Enables fast time sampling which is dependent on CPU cycles and frequency, otherwise, the directive uses operating system timing (which may be less accurate).

Default Value: 0

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.event_tracing_mode

Determines integration with tracer mechanism in case of events that require a trace data dump. 0 means off, 1 means on, 2 means standby.

Default Value: 2

Type: int

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.aggregate_by_url_query

When enabled, use the URL's query string as part of the aggregation key.

Default Value: 0

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 4.0

zend_monitor.aggregate_by_route

When enabled, use the request route details as part of the aggregation key.

Default Value: 1

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 8.1

zend_monitor.event_generate_trace_file

When enabled, an event will also trigger a code-tracing file generation.

Default Value: 0

Type: boolean

Modification Scope: ZEND_INI_ALL

Available Since Version: 5.5