The Zend Server Z-Ray is a Web page component displayed at the bottom of any HTML-based Web page located on the Web server and open in a browser, that allows developers to inspect, debug and optimize PHP code by monitoring all URL requests made to the Web server, and displaying recorded data.
The Page Requests panel in Z-Ray displays a list of all the requests sent by the page to the Web server.
When minimized, Z-Ray displays the request URL and its HTTP response code. If more than one request was made to the Web server, Z-Ray will display the amount of these requests next to the URL. This number will be highlighted if there were any warnings or errors with one of these requests.
When opened, the Page Requests panel displays the following information:
The Show filter allows you to decide which requests you want to view in the Requests List on the right.
The filter displays a list of the URL requests sent by the page, the number of times the request was sent to the server, and execution time. The ALL filter is selected by default, showing all the requests.
The Action bar contains navigation, search and export options.
Name |
Icon |
Description |
Navigation |
|
Allows easy navigation between multiple list pages. |
Search box |
|
Filters the information displayed in the list by entered search string |
Show Report |
|
Exports the data displayed in the panel to a separate page. |
The Requests List displays all requests made from the page to the Web server, and relevant information on these requests:
Name |
Description |
Severity |
The severity level for request issues: - The request has no critical warnings. - The request has warnings or errors in the Monitor Events or Log Entries panels. - The request has critical errors in the Monitor Events, Log Entries or Database Queries panels. |
Response |
The HTTP response code for the request. |
Method |
The type of HTTP method used by the request. |
URL |
The exact URL path of the request call. |
Time (ms) |
The total execution time (ms) for the request. |
Queries |
The amount of database queries executed for the request |
Started (ms) |
The elapsed time (ms/sec) since the initial page request. |
Pauses or resumes recording information. The Clean button clears Z-Ray from all request information.
The Execution Time and Memory Peak panel displays:
When minimized, Z-Ray displays the total amount of processing time (ms) and the peak amount of server memory (Mb) consumed for the URL request.
The Monitor Events panel displays monitoring events that were triggered during the URL request currently selected and displayed in the Page Requests panel.
When minimized, Z-Ray displays the amount of triggered events.
When opened, the Monitor Events panel displays the following information:
The Show filter allows you to decide which type of monitor events are shown in the Events List. By default, the ALL filter is selected, showing all triggered events.
The Action bar contains navigation, search and export options.
Name |
Icon |
Description |
Navigation |
|
Allows easy navigation between multiple list pages. |
Search box |
|
Filters the information displayed in the list by entered search string |
Create Report |
|
Exports the data displayed in the panel to a separate page. |
Name |
Description |
Severity |
The event severity level: - The request triggered an event with a Notice severity level. - The request triggered an event with a Warning severity level. - The request triggered an event with a Critical severity level. |
Name |
The name of the monitoring rule triggering the event. |
Summary |
A description of what occurred. |
Occurrence |
The date and time the event occurred. |
Actions |
Available action items for events (Open in Zend Server | Show code trace). |
The Error & Warnings panel displays errors triggered by the URL request currently selected and displayed in the Page Requests panel.
When minimized, Z-Ray displays the amount of triggered errors.
Note:
Only errors triggered by PHP itself or by similar code functions (e.g., error_log) are displayed.
When opened, the Error & Warnings panel displays the following information:
The Show filter allows you to decide which type of errors are displayed in the Log List. By default, the filters that are selected correspond to the settings in the 'php.ini' file.
The Action bar contains features allowing you to navigate, search, export and filter the information displayed in the Errors List:
Name |
Icon |
Description |
Navigation |
|
Allows easy navigation between multiple list pages. |
Show silenced |
- |
Shows silenced log entries. |
Search box |
|
Filters the information displayed in the list by entered search string |
Create Report |
|
Exports the data displayed in the panel to a separate page. |
Name |
Description |
Created |
The level severity of the error (Notice, Warning, Error). |
Type |
The error type: - The request triggered a Notice error . - The request triggered a Warning error. - The request triggered a Critical error (parse, error or fatal). |
Message |
The error message. |
File Name |
The name of the error file and the line number. |
Actions |
Action items (Backtrace) |
The Database Queries panel displays database queries executed by the URL request currently selected and displayed in the Page Requests panel.
Note:
Supported database extensions: All PDO extensions, OCI, MySQL, MySQLi, DB2.
When minimized, the Z-ray displays the amount of database queries executed.
When opened, the Database Queries panel displays the following information:
The Show filter allows you to decide which type of database queries are shown in the Queries List (e.g., Set, Select, Insert). The filter displays the query type, the number of times it was sent, and total transaction time. By default, the ALL filter is selected, showing all queries made to the database.
The Action bar contains navigation, search and export options.
Name |
Icon |
Description |
Navigation |
|
Allows easy navigation between multiple list pages. |
Expand all |
- |
Expands all queries |
Search box |
|
Filters the information displayed in the list by entered search string |
Create Report |
|
Exports the data displayed in the panel to a separate page. |
The Queries List displays detailed information on database queries executed by the request:
Name |
Description |
# |
Serial number of the query. |
Query |
The query statement, together with bound values. |
Time (ms) |
Execution time for the query (ms). |
Rows |
The amount of rows in the code affected by the query. |
Success |
The result of the query: - OK - Error. |
Message |
Query messages. |
Actions |
Action items (Backtrace) |
The Functions panel displays the PHP functions called during the URL request currently selected and displayed in the Page Requests panel.
When minimized, Z-Ray displays the number of PHP functions called.
When opened, the Functions panel displays the following information:
The Show filter allows you to filter the information displayed in the Functions List according to a PHP function group or framework namespace. By default, The 'Custom' filter is selected, for functions that do not have a specified namespace.
The Manage namespaces link opens Z-Ray settings page in the Zend Server UI for adding additional function group and namespace filters.
The Action bar contains navigation, search and export options.
Name |
Icon |
Description |
Navigation |
|
Allows easy navigation between multiple list pages. |
Search box |
|
Filters the information displayed in the list by entered search string |
Create Report |
|
Exports the data displayed in the panel to a separate page. |
Name |
Description |
Function |
The name of the PHP function called. |
Count |
The number of times the function was called. |
Time Inclusive (ms) |
Time (ms) spent in the scope of this function, including any calls to other functions or children. |
Time Exclusive (ms) |
Time (ms) spent in the scope of this function. This value will not include time spent in children functions. |
Average (ms) |
The average of inclusive execution across the number of requests (inclusive exec / request count). |
Defined at |
The path or file location of the PHP function called, and the line number. |
The PHP Variables panel displays variables used in the URL request currently selected and displayed in the Page Requests panel.
When opened, the PHP Variables displays the following information:
The Show filter allows you to decide which superglobals you want to view in the Variables List on the right.
The filter displays a list of the superglobals used on the page. The ALL filter is selected by default, showing all the superglobals.
Name |
Description |
Key |
The key of the PHP variable |
Value |
The value of the PHP variable |
Previous Value |
The previous value of a changed PHP variable |
Clicking the Debug/Profile icon allows you to trigger a debugging or profiling session in Zend Studio for the URL request currently selected and displayed in the Requests module of Z-Ray.
Important:
This action is only available if an IDE is installed on your machine, and Zend Server is configured to communicate with it. For more information, see Integrating with IDEs.
Clicking the Zend Server logo opens the Zend Server UI.
Clicking Z-Ray menu icon opens a context-menu containing information about the Zend Server and PHP versions, and additional menu items:
Menu Item |
Description |
Settings |
Opens Z-Ray settings section in the Zend Server UI |
Help |
Opens the Zend Server Online Help |
Tell us what you think |
Opens a survey for submitting feedback |
Disable |
Opens Z-Ray settings page in the Zend Server UI |
Close for session |
Closes Z-Ray for the entire browser session |
Close |
Closes Z-Ray |
Collapses or expands Z-Ray.