Configuring Z-Ray- Zend Server 8.5

Configuring Z-Ray Access Modes

This procedure describes how to configure Z-Ray availability.

To configure the availability of Z-Ray:

In the UI, go to the Z-Ray | Settings page.
In the Mode tab, configure Z-Ray access mode:
- Enabled Mode - select this option (selected by default for a Zend Server launched with a Development launch profile), to enable Z-Ray on all pages on your web server.
- Selective Mode - select this option to allow selective access to Z-Ray. For more information on enabling this mode, see Allowing Selective Access.
- Disabled Mode - select this option (selected by default for a Zend Server launched with a Production launch profile), to disable Z-Ray on all pages on your Web server.
At the bottom of the section, click Save to apply the change.

For more information on enabling and disabling Z-Ray, see Enabling/Disabling Z-Ray.

Configuring Z-Ray Data Collection Settings

This procedure describes how to configure how Z-Ray handles data collection.

To configure data collection settings for Z-Ray:

In the UI, go to the Z-Ray | Settings page.
Select the Data Collection tab.
Configure the following settings:
- Enable Backtracing - Enable or disable backtracing in Z-Ray.
- Enable Backtracing for Error and Warnings - Enable or disable collection of backtraces for Errors and Warnings (only available if backtracing is enabled above).
- Collect Backtraces for Database Queries - Enable or disable collection of backtraces for database queries (only available if backtracing is enabled above).
- Collect Extension Data - Enable or disable collection of data for Z-Ray extensions. Disabling data collection will remove extension panels from Z-Ray.
- Max Log Entries - Enter the max number of log entries displayed in the Errors & Warnings panel.
At the bottom of the section, click Save to apply your changes.

Clearing Z-Ray Information

This procedure describes how to manually clear the database from information gathered by Z-Ray.

Note:

The database is automatically cleared from data collected by Z-Ray. The frequency and behavior of this automatic process can be configured by configuring Z-ray directives. For more information, see Configuring Z-Ray Directives above.

To clear Z-Ray information:

In the UI, go to the Configurations | Components page.
Under the Actions column in the Components list, select the clear icon for the Z-Ray component.
When prompted, click OK.
Z-Ray information is cleared from the database.

Tip:

You can configure the number of recent URLs for which data is kept after a manual cleanup. To do this, configure the 'zray.cleanup_keep_urls' directive. For more information, see Configuring Z-Ray Directives above.

Disabling Z-Ray Tracking

This procedure describes how to disable Z-Ray tracking for a specific panel.

Note:

This action can only be performed for the following Z-Ray panels: Monitor Events, Log Entries, and PHP Variables.

To disable Z-Ray tracking:

In the UI, go to the Configurations | Components page.
From the Components list, select the Z-Ray component.
The expanded view displays all available configuration directives.

Turn off the following directives:
- 'zray.collect_events' - Turn off to disable tracking for the Monitor Events panel.
- 'zray.collect_log_entries' - Turn off to disable tracking for the Log Entries panel.
- 'zray.collect_superglobals' - Turn off to disable tracking for the PHP Variables panel.
- 'zray.collect_functions' - Turn off to disable tracking for the Functions panel.
- 'zray.collect_sql' - Turn off to disable tracking for the Database Queries panel.
In the Action bar, click Save.
In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart server and apply changes.
For information on restarting in Zend Server, see Server Restart.

Configuring Z-Ray Directives

This procedure describes how to configure Z-Ray configuration directives. These directives define the way Z-Ray collects, handles and stores the request data.

For example, the 'zray_history_time' directive determines how long Z-Ray request data is kept before being automatically cleared from the database.

For a list of the available directives, see Zend Server Z-Ray - Configuration Directives.

To configure Z-Ray:

In the UI, go to the Configurations | Components page.
From the Components list, select the Z-Ray component.
The expanded view displays all available configuration directives.

Configure the directives as you see fit, and in the Action bar, click Save.
In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart server and apply changes.
For information on restarting in Zend Server, see Server Restart.

Configuring Z-Ray Privacy Settings

This procedure describes how to configure privacy settings for Z-Ray.

To privacy settings for Z-Ray:

In the UI, go to the Z-Ray | Settings page.
Select the Privacy tab.
Configure the following settings:
At the bottom of the section, click Save to apply your changes.

Configuring Z-Ray Advanced Settings

This procedure describes how to configure advanced settings for Z-Ray, including iFrame behavior, function filtering and more.

To configure advanced settings for Z-Ray:

In the UI, go to the Z-Ray | Settings page.
Select the Advanced tab.
Configure the following settings:
- Show in iFrame - Decide whether to show Z-Ray in every iFrame. If this option is not selected, only one Z-Ray is displayed at the bottom of the page, aggregating all the request information for the entire page.
- Show Silenced Log Entries - Decide whether to display log entries for expressions silenced by the '@' silence operator.
- Function Groups Filtering - Enter a comma separated list of your own function groups or namespaces to be able to filter the Functions list accordingly. Existing groups can be removed.
- Z-Ray URL - Allows you to specify a custom URL for displaying Z-Ray.
At the bottom of the section, click Save to apply your changes.