Working with Code Tracing

Code Tracing in Zend Server can be run manually for a URL, or automatically for triggered events.

Code Tracing Settings page allows to configure Code Tracing data collection and limitation.

Important:

To work with Code Tracing you first have to have the Code Tracing component installed and activated. To verify, go to Administration | Components.

Video

To better understand the procedures described in this topic, watch this video:

Setting Code Tracing for Events

This procedure describes how to set Code Tracing for events.

To enable/disable event-triggered code tracing:

In the UI, go to Monitoring | Settings and select the Events tab.
In the Code Tracing for Events area, set the code tracing activation options:
- Never - Code Traces are never generated for triggered events.
- Rule-based - Code traces are generated according to the event rules specified in Monitoring | Event Rules:
  - Activate for specified time - Code traces for a specified number of seconds after a triggered event. Ideal for production environments.
  - Always activate for triggered events - Code traces are generated for triggered events. Ideal for development and staging environments.
- Always - Code traces are generated for every triggered event.

Click .

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.

Important!

If enabled, you will also need to activate Code Tracing for the specific event rule from the New/Edit Event Rules page. For more information, see Activating Code Tracing for an Event Rule below, and Working with Event Rules.

Manually Triggering a URL Trace

This procedure describes how to manually run a code tracing on a specific URL. Running a code trace on a specific URL will capture the current activity at the time the trace was triggered.

To manually trigger code tracing on a specific URL:

In the UI, go to Code Tracing | Traces.
Enter the URL in the "Add new URL to trace" field.

Note:

The URL has to be running on the server running Zend Server.
Click the Request Type drop-down menu, and select the request type you wish Zend Server to use for the trace.
Click .

The trace information will be collected and added to the list in the Code Tracing page.

Running Code Tracing on Another Machine

You can run Code Tracing on another machine as long as the Zend Code Trace component is installed and running on it. However, when running a trace on a remote machine the trace information is collected on that machine therefore, instead of running the trace from a remote machine always run a trace on the specific machine you need. If you do want to run a trace on a remote server after all, make sure that the server's IP is an allowed host in Debugging | Debugger.