This Puppet module installs and configures the Dynatrace Application Monitoring solution.
Please see Puppetfile and metadata.json for a list of module dependencies.
Installs the Dynatrace Agents package.
This class downloads and installs the most recent version of the Dynatrace Agents package for the Linux platform from http://downloads.dynatracesaas.com. The default behavior can be overridden via the class' $installer_file_url parameter. Alternatively, you can place the installer artifact as dynatrace-agent.jar in the module's files directory from where it will be picked up during the installation. Please refer to manifests/role/agents_package.pp for a list of supported parameters, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::agents_package':
installer_file_url => 'https://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-agent-7.0.0.2469-unix.jar'
}
Note: this class merely makes the Dynatrace Agents available, but it does not configure your application to actually load any. See the dynatrace::role::java_agent class for an example that does.
Installs the Dynatrace WebServer Agent for the Apache HTTP Server.
Please refer to manifests/role/apache_wsagent.pp and manifests/role/wsagent_package.pp for a list of supported parameters, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::wsagent_package':
installer_file_url => 'https://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-wsagent-7.0.0.2469-linux-x86-64.tar'
}
class { 'dynatrace::role::apache_wsagent':
apache_config_file_path => '/etc/apache2/apache2.conf',
require => Class['dynatrace::role::wsagent_package']
}
Note: you will have to restart the web server after placing the agent.
Installs the Dynatrace Collector.
This class downloads and installs the most recent version of the Dynatrace Collector for the Linux platform from http://downloads.dynatracesaas.com. The default behavior can be overridden via the class' $installer_file_url parameter. Alternatively, you can place the installer artifact as dynatrace-collector.jar in the module's files directory from where it will be picked up during the installation. Please refer to manifests/role/collector.pp for a list of supported parameters, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::collector':
installer_file_url => 'https://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-collector-7.0.0.2469-linux-x86.jar'
}
Note: make sure that attributes related to the Collector's memory configuration are set in accordance to the Memory Configuration documentation.
Installs the Dynatrace Java Agent.
Please refer to manifests/role/java_agent.pp and manifests/role/agents_package.pp for a list of supported parameters, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::agents_package':
installer_file_url => 'https://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-agent-7.0.0.2469-unix.jar'
}
class { 'dynatrace::role::java_agent':
env_var_name => 'CATALINA_OPTS',
env_var_file_name => '/opt/apache-tomcat/bin/catalina.sh',
agent_name => 'apache-tomcat-agent',
require => Class['dynatrace::role::agents_package']
}
Note: this recipe makes the Java Agent available to a Java Virtual Machine by injecting an appropriate -agentpath option into an environment variable, e.g. JAVA_OPTS, inside a file (typically an executable script). It is assumed that this script either executes the Java process directly or is sourced by another script before the Java process gets executed. You will have to restart the application after placing the agent.
Installs the Dynatrace Memory Analysis Server.
This class downloads and installs the most recent version of the Dynatrace Memory Analysis Server for the Linux platform from http://downloads.dynatracesaas.com. The default behavior can be overridden via the class' $installer_file_url parameter. Alternatively, you can place the installer artifact as dynatrace-analysisserver.jar in the module's files directory from where it will be picked up during the installation. Please refer to manifests/role/memory_analysis_server.pp for a list of supported parameters, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::memory_analysis_server':
installer_file_url => 'https://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-analysisserver-7.0.0.2469-linux-x86.jar'
}
Note: make sure that attributes related to the Analysis Server's memory configuration are set in accordance to the documentation Set up a Memory Analysis Server.
Installs the PHP OneAgent.
This class downloads and installs the most recent version of the PHP OneAgent for the Linux platform from http://downloads.dynatracesaas.com. The default behavior can be overridden via the class' $installer_file_url parameter. Alternatively, you can place the installer artifact as dynatrace-one-agent-php.tar in the module's files directory from where it will be picked up during the installation. Please refer to manifests/role/php_one_agent.pp for a list of supported parameters, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::php_one_agent':
installer_file_url => 'https://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-one-agent-php-7.0.0.2469-linux-x86.tgz'
}
Note: make sure that attributes related to the One Agent configuration are set in accordance to the documentation PHP Agent configuration and OneAgent configuration.
Installs the Dynatrace Server.
This class downloads and installs the most recent version of the Dynatrace Memory Analysis Server for the Linux platform from http://downloads.dynatracesaas.com. The default behavior can be overridden via the class' $installer_file_url parameter. Alternatively, you can place the installer artifact as dynatrace.jar in the module's files directory from where it will be picked up during the installation. Please refer to manifests/role/server.pp for a list of supported parameters, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::server':
installer_file_url => 'http://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-server-7.0.0.2469-linux-x86.jar'
}
Installs the Dynatrace Server License.
Place the Dynatrace Server License as dynatrace-license.key in the module's files directory. Alternatively, you can make the license available as an HTTP, HTTPS or FTP resource and point the class to the right location via the $license_file_url parameter. Please refer to manifests/role/server_license.pp for a list of supported attributes, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::server':
license_file_url => 'http://my-license-server/dynatrace/dynatrace-license.key'
}
Installs the Dynatrace WebServer Agent package.
This class downloads and installs the most recent version of the Dynatrace WebServer Agent installer for the Linux platform from http://downloads.dynatracesaas.com. The default behavior can be overridden via the class' $installer_file_url parameter. Alternatively, you can place the installer artifact as dynatrace-wsagent.tar in the module's files directory from where it will be picked up during the installation. Please refer to manifests/role/wsagent_package.pp for a list of supported parameters, whose default values can be overridden in manifests/params.pp. In order to install, you may execute the class as follows:
class { 'dynatrace::role::wsagent_package':
installer_file_url => 'https://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-wsagent-7.0.0.2469-linux-x86-64.tar'
}
Note: this recipe merely makes the Dynatrace WebServer Agent available, but it does not configure your web server to actually load it. See the dynatrace::role::apache_wsagent class for an example that does.
We use Test Kitchen to automatically test our automated deployments with Serverspec and RSpec:
- Install Test Kitchen and its dependencies from within the project's directory:
gem install bundler
bundle install
- Run all tests
kitchen test
By default, we run our tests inside Docker containers as this considerably speeds up testing time (see .kitchen.yml, requires Ruby 2.2+). Alternatively, you may as well run these tests in virtual machines based on VirtualBox and Vagrant (see .kitchen.vagrant.yml).
Feel free to post your questions on the Dynatrace Community's Continuous Delivery Forum.
Licensed under the MIT License. See the LICENSE file for details.