This Chef cookbook installs and configures the Dynatrace Application Monitoring solution.
Requires Chef 11 or higher.
Installs the Dynatrace Server. Please refer to the server Chef Recipe below.
Installs the Dynatrace Agents package.
This recipe downloads and installs the most recent version of the Dynatrace Agents package from http://downloads.dynatracesaas.com. The default download link can be overridden via the node['dynatrace']['agents_package'][$platform]['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace-agent.jar (Linux) or as dynatrace-agent.msi (Windows) in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/agents_package.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::agents_package] in a runlist and override attributes as required.
Note: this recipe merely makes the Dynatrace Agents available, but it does not configure your application to actually load any. See the java_agent recipe for an example that does.
Installs the Dynatrace WebServer Agent for the Apache HTTP Server.
This recipe downloads and installs the most recent version of the Dynatrace WebServer Agent package from http://downloads.dynatracesaas.com and integrates the agent with the Apache HTTP Server. The default download link can be overridden via the node['dynatrace']['wsagent_package']['linux']['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace-wsagent.tar in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/apache_wsagent.rb and attributes/wsagent_package.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::apache_wsagent] in a runlist and override attributes as required.
Note: you will have to restart the web server after placing the agent.
Installs the Dynatrace Collector.
This recipe downloads and installs the most recent version of the Dynatrace Collector from http://downloads.dynatracesaas.com. The default download link can be overridden via the node['dynatrace']['collector']['linux']['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace-collector.jar in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/collector.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::collector] in a runlist and override attributes as required.
Note: make sure that attributes related to the Collector's memory configuration are set in accordance to the Memory Configuration section of the Collector Configuration documentation.
Installs the Dynatrace .NET Agent.
This recipe downloads and installs the most recent version of the Dynatrace Agents package from http://downloads.dynatracesaas.com. The default download link can be overridden via the node['dynatrace']['agents_package']['windows']['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace-agent.msi in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/dotnet_agent.rb and attributes/agents_package.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::dotnet_agent] in a runlist and override attributes as required.
Installs the Dynatrace WebServer Agent for the Microsoft IIS Server.
This recipe downloads and installs the most recent version of the Dynatrace WebServer Agent package from http://downloads.dynatracesaas.com and integrates the agent with the Microsoft IIS Server. The default download link can be overridden via the node['dynatrace']['wsagent_package']['windows']['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace-agent.msi in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/iis_wsagent.rb and attributes/wsagent_package.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::iis_wsagent] in a runlist and override attributes as required.
Installs the Dynatrace Agent Java Agent.
This recipe downloads and installs the most recent version of the Dynatrace Agents package from http://downloads.dynatracesaas.com and integrates the agent with a Java process. The default download link can be overridden via the node['dynatrace']['agents_package']['linux']['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace-agents.jar in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/java_agent.rb and attributes/agents_package.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::java_agent] in a runlist and override attributes as required.
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.
This recipe downloads and installs the most recent version of the Dynatrace Memory Analysis Server from http://downloads.dynatracesaas.com. The default download link can be overridden via the node['dynatrace']['memory_analysis_server']['linux']['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace-analysisserver.jar in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/memory_analysis_server.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::memory_analysis_server] in a runlist and override attributes as required.
Note: make sure that attributes related to the Analysis Server's memory configuration are set in accordance to the Memory Configuration section of the Memory Analysis Server Configuration documentation.
Installs the Dynatrace Server.
This recipe downloads and installs the most recent version of the Dynatrace Server from http://downloads.dynatracesaas.com. The default download link can be overridden via the node['dynatrace']['server']['linux']['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace.jar in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/server.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::server] in a runlist and override attributes as required.
Installs the Dynatrace Server License.
Place the Dynatrace Server License as dynatrace-license.key in the cookbook's files directory. Alternatively, you can make the license available as an HTTP or FTP resource and point the Chef Recipe to the right location via the node['dynatrace']['server']['license']['file_url'] attribute. Please refer to attributes/server.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::server_license] in a runlist.
Installs the Dynatrace WebServer Agent package.
This recipe downloads and installs the most recent version of the Dynatrace WebServer Agent package from http://downloads.dynatracesaas.com. The default download link can be overridden via the node['dynatrace']['wsagent_package'][$platform]['installer']['file_url'] attribute. Alternatively, you can place the installer artifact as dynatrace-wsagent.tar (Linux) or dynatrace-agent.msi (Windows) in the cookbook's files directory from where it will be picked up during the installation. Please refer to attributes/wsagent_package.rb for a list of supported attributes. In order to have the Chef Recipe executed, include recipe[dynatrace::wsagent_package] in a runlist and override attributes as required.
Note: this recipe merely makes the Dynatrace WebServer Agent available, but it does not configure your web server to actually load it. See the apache_wsagent and iis_agentrecipes for examples.
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).
- CentOS 6.5
- Debian 7.4
- Ubuntu 12.04
- Windows 2012 R2
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.