Unable to render {include} The included page could not be found.

Unable to render {include} The included page could not be found.

Configuration Examples


This page provides examples and step-by-step instructions for setting up dynaTrace monitoring within typical application environments. These examples can also serve as reference in approaching more complex setups.

It's assumed that you've already completed the dynaTrace installation, that your dynaTrace server is up and running with an activated license, and that you're able to connect with your dynaTrace client. If you haven't yet completed these steps, please review the installation instructions.

User Experience with Web,- and Application Server


 

In this section we will describe how to set up dynaTrace monitoring for a typical multi-tier webapplication based on an webserver, application and databaase tier. For that purpose we will describe two scenarios, one based on Apache HTTP and Apache Tomcat and one based on Microsoft Internet Information Services.

We assume that your dynaTrace server is already up and running, that you have activated your license and that you are ready to configure your application environment.

To complete this setup you will need:

  • administrative access to your webserver and permissions to modify the webserver configuration

  • administrative access to your application server (Apache Tomcat or other) and permission to modify it's configuration
  • permission to install dynaTrace Agent components (e.g. read/write permissions in /opt) on web and application servers

Launch the Application Environment Configuration Wizard

After completing dynaTrace server setup and license installation, the Application Environment Configuration Wizard guides you through the process of connecting your application to dynaTrace. From the dynaTrace start screen, select Add the dynaTrace agent to launch the Application Environment Configuration Wizard.

On the next screen select User Experience with Web,- and Application Server and then start by configuring the application server tier via the Add button. Note that you can add as many different tiers as required. Once you have configured one tier you will be returned to the configuration overview to add more.

On adding a tier you will be presented a list of application servers. Select an according one (e.g. in this case Apache Tomcat) and give it a name (e.g. 'ApplicationServer' or 'MyBackend'). On the next screen select the platform and architecture that your application server runs on and make sure you also specify the right Jave Version and architecture.

Continue with downloading the Java agent installation files and copy them to your application server machine.

Install the dynaTrace Java Agent

Windows Operating Systems

To install the Java Agent on Windows platforms execute the agent installation MSI file and optionally specify the install location. Most user will want to go with the default options but you can use the customized installation and only select to install the Java agent and skip the other agent types. (If you also intend to use other technologies choose them as well).

Linux

To install the dynaTrace Java agent on Linux you will need a Java runtime available to execute the installer. Run the installer within the destination directory (e.g. /opt) with the following command:

# java -jar dynatrace-agent-5.6.0.5705-unix.jar 
Running installer /opt/dynatrace-agent-5.6.0.5705-unix.jar
-----------------------------------------------------------------------------
dynaTrace 5.6.0 Installer
-----------------------------------------------------------------------------
platform: Linux 2.6.35.11-83.9.amzn1.x86_64, amd64
-----------------------------------------------------------------------------
Installer is running with JVM version 1.6.0_24
-----------------------------------------------------------------------------
Detected OS/Arch: linux
-----------------------------------------------------------------------------
The product will be installed to /opt/dynatrace-5.6.0. Do you want to install to this directory? (Y/N)

Also make sure that the user your application server will run with has read/write permission for this directory structure.

Adding the dynaTrace Java agent to the Application Server

To load the dynaTrace agent with the Java Virtual Machine it's required to change the JVM's startup parameters. For Apache Tomcat this can be done in tomcats environment configuration file catalina.sh (Linux) or catalina.bat (Windows).

Edit the file and add or modify the JAVA_OPTS variable to contain the JVM option parameter for the dynaTrace agent. The format for this parameter is as follows:

-agentpath:<full path to agent library>\
  =name<name for the application agent>,\
  server=<ip or hostname for the dynaTrace server>

Make sure that you use the correct path to the dynaTrace agent library the right name parameter as set in the configuration wizard as well as the correct address or hostname of the dynaTrace server. e.g.:

JAVA_OPTS=-agentpath:/opt/dynatrace-5.6.0/agent/lib64/libdtagent.so=name=ApplicationServer_Monitoring,server=ip-10-53-43-83:9998

Verifying that the agent gets loaded

To verify that the dynaTrace agent gets loaded upon startup of Tomcat and is able to connect to the dynaTrace server check the tomcat log file catalina.out. The very first output before even the JVM gets loaded should come from the dynaTrace agent and you should see some output like this:

[native] dynaTrace Bootstrap Agent 5.6.0.5705
[native] Using /opt/dynatrace-5.6.0/agent as Agent storage
[native] Log file at /opt/dynatrace-5.6.0/agent/log/dt_My-ApplicationServer_Production_bootstrap_23169.log
[native] Trying to connect to ip-10-53-43-83:9998 for up to 60 seconds
[native] Connected successfully
...
[native] Using CLOCK_MONOTONIC POSIX timer
[native] High-resolution POSIX timer detected.
[native] -----------------------------------------------------------------------------------------
[native] dynaTrace Agent for Java Copyright (c) 2004-2013 Compuware Corporation, www.compuware.com
[native] -----------------------------------------------------------------------------------------
native] Version ..................... 5.6.0.5705, build date Nov 22 2013 09:28:06
...
[native] Agent library ............... /opt/dynatrace-5.6.0/agent/lib64/libdtagentcore.so
[native] Options string .............. name=My-ApplicationServer_Production,server=ip-10-53-43-83:9998
[native] Agent name .................. My-ApplicationServer_Production
[native] Server/Collector ............ ip-10-53-43-83:9998
...
[native] Eventsender channel connected successfully

Once this step is completed and the tomcat server successfully loads the agent and connects to the dynaTrace server you should see the agent appear in the configuration dialog and you can move on with configuring your webserver tier.

Click Add to define your webserver tier and choose Apache. Then supply a name for that tier and continue with downloading the webserver agent installation file and copy them to your webserver.

Install the dynaTrace Web Server Agent

The Web server agent for Apache is a shared module that can be loaded like any other Apache module. A native process, the Web server master agent, must also be installed. This process is responsible for relaying communication between Apache and the dynaTrace server.

Make sure you've downloaded and installed the right architecture for your environment. If you're unsure, verify the architecture of your Apache installation by running the below command:

# httpd -V
Server version: Apache/2.2.23 (Unix)
Server built:   Oct 21 2012 20:35:32
Server's Module Magic Number: 20051115:31
Server loaded:  APR 1.4.6, APR-Util 1.4.1
Compiled using: APR 1.4.6, APR-Util 1.4.1
Architecture:   64-bit

Once you've copied the Web server agent installation file to the Web server machine, unpack the file and run the installation script:

# tar xvf dynatrace-wsagent-5.6.0.5713-linux-x64.tar
# /bin/sh dynatrace-wsagent-5.6.0.5713-linux-x64.sh
Extracting...
Unpacking...
Cleaning up...

This installs the agent binaries and configuration files to the current directory (for example,  .../opt/dynatrace-5.6.0).

Configure Apache to Load the dynaTrace Agent Module

To load the dynaTrace agent module you'll need to add a LoadModule statement to your Apache configuration files. Ensure that you specify the correct directory and architecture for your installation:

LoadModule dtagent_module /opt/dynatrace-6.1.0/agent/lib64/libdtagent.so

Now configure the dynaTrace Web server agent for connection to the dynaTrace server and give it a unique identifier. To do this, edit the dtwsagent.ini file in the dynaTrace installation directory. Modify the following lines as shown:

# vi /opt/dynatrace-6.1.0/agent/conf/dtwsagent.ini
Name MyWebserver_Monitoring
Server <IP or DNS Name of dynaTrace server>

To verify that the Web server agent has loaded and is running correctly, restart Apache and execute the following statement:

# ps -e | grep dtwsagent
14405 ?        00:00:26 dtwsagent

Finish the webserver wizard and verify that all agents (tomcat application server and webserver) show up in the configuration wizard.

Enable User Experience Management by injecting JavaScript

This step is optional, but it is recommended for optimal visibility into your application. It will provide you with visibility into client side click paths, third party content, client side execution, and JavaScript errors. In the Configuration Wizard, enable the Inject JavaScript option to have the browser-side JavaScript Agent added automatically to your site.

Configuration is Complete! Now Create Some Traffic!

The Application Environment Configuration wizard should now show all of your configured agents in the lower table. Close the wizard by clicking Finish and return to the dynaTrace start screen.

Now it's time to access your application and create some traffic for dynaTrace to monitor. Click through a few common use cases in your application. dynaTrace will automatically detect your application and monitor your actions.

Congratulations! You've completed setup and can now explore dynaTrace!

Watch the video

Step by Step Instructions

 

User Experience for PHP Applications


 

This section describes the necessary installation steps for monitoring a typical LAMP (Linux-Apache-MySQL-PHP) stack using dynaTrace. It focuses on adding and configuring the dynaTrace Agents that are required for Apache and PHP. It assumes that your dynaTrace Server is already up and running and that you're ready to configure your application environment.

To complete this setup you will need:

  • Administrative access to your Web server and permissions for modifying the Web server and PHP configuration

  • Permission to install dynaTrace Agent components (for example, read/write permissions for the /opt directory).

Launch the Application Environment Configuration Wizard

After completing dynaTrace server setup and license installation, the Application Environment Configuration Wizard guides you through the process of connecting your application to dynaTrace. From the dynaTrace start screen, select Add the dynaTrace agent to launch the Application Environment Configuration Wizard.

On the next screen, select User Experience with PHP Applications and click the Add button to configure the Web server (Apache in this case). Since the PHP engine runs on Apache, there are two additional steps required: installing/configuring the Web server agent and configuring the PHP agent.

Choose PHP Engine on Apache and optionally set a Name for this application tier (for example, "MyBlog" for a Wordpress blog). Click Next.

On the next screen, select the architecture and environment that your LAMP stack runs on. If you are uncertain about this, see the next section for assistance in identifying the architecture that your Apache Web server is built for. Click Next.

Download the dynaTrace Web server agent installation files and copy them to the machine that your application runs on. Click Next.

Install the dynaTrace Web Server Agent

The Web server agent for Apache is a shared module that can be loaded like any other Apache module. A native process, the Web server master agent, must also be installed. This process is responsible for relaying communication between Apache and the dynaTrace server.

Make sure you've downloaded and installed the right architecture for your environment. If you're unsure, verify the architecture of your Apache installation by running the below command:

# httpd -V
Server version: Apache/2.2.23 (Unix)
Server built:   Oct 21 2012 20:35:32
Server's Module Magic Number: 20051115:31
Server loaded:  APR 1.4.6, APR-Util 1.4.1
Compiled using: APR 1.4.6, APR-Util 1.4.1
Architecture:   64-bit

Once you've copied the Web server agent installation file to the Web server machine, unpack the file and run the installation script:

# tar xvf dynatrace-wsagent-5.6.0.5713-linux-x64.tar
# /bin/sh dynatrace-wsagent-5.6.0.5713-linux-x64.sh
Extracting...
Unpacking...
Cleaning up...

This installs the agent binaries and configuration files to the current directory (for example,  .../opt/dynatrace-5.6.0).

Configure Apache to Load the dynaTrace Agent Module

To load the dynaTrace agent module you'll need to add a LoadModule statement to your Apache configuration files. Ensure that you specify the correct directory and architecture for your installation:

LoadModule dtagent_module /opt/dynatrace-6.1.0/agent/lib64/libdtagent.so

Now configure the dynaTrace Web server agent for connection to the dynaTrace server and give it a unique identifier. To do this, edit the dtwsagent.ini file in the dynaTrace installation directory. Modify the following lines as shown:

# vi /opt/dynatrace-6.1.0/agent/conf/dtwsagent.ini
Name MyWebserver_Monitoring
Server <IP or DNS Name of dynaTrace server>

To verify that the Web server agent has loaded and is running correctly, restart Apache and execute the following statement:

# ps -e | grep dtwsagent
14405 ?        00:00:26 dtwsagent

Configure the PHP dynaTrace extension

To load the dynaTrace PHP agent, edit the php.ini file and add the following lines to the other loaded extensions:

# vi /etc/php5/apache2/php.ini

extension=/opt/dynatrace- 5.6 . 0 /agent/lib64/libdtagent.so

Verify that the dynaTrace PHP extension has loaded after restarting Apache. This can be done by either checking the output of phpinfo() and looking for the dtphpagent section or by checking the Agent Connection Status in the dynaTrace client.

Enable User Experience Management by injecting JavaScript

This step is optional, but it is recommended for optimal visibility into your application. It will provide you with visibility into client side click paths, third party content, client side execution, and JavaScript errors. In the Configuration Wizard, enable the Inject JavaScript option to have the browser-side JavaScript Agent added automatically to your site.

Configuration is Complete! Now Create Some Traffic!

The Application Environment Configuration wizard should now show all of your configured agents in the lower table. Close the wizard by clicking Finish and return to the dynaTrace start screen.

Now it's time to access your application and create some traffic for dynaTrace to monitor. Click through a few common use cases in your application. dynaTrace will automatically detect your application and monitor your actions.

Congratulations! You've completed setup and can now explore dynaTrace!

Step by Step Instructions

 

  • No labels