{"id":20317655,"url":"https://github.com/dynatrace/dynatrace-appmon-chef","last_synced_at":"2025-05-08T00:30:31.705Z","repository":{"id":33150514,"uuid":"36790429","full_name":"Dynatrace/Dynatrace-AppMon-Chef","owner":"Dynatrace","description":"Installs the Dynatrace Application Monitoring solution using Chef.","archived":false,"fork":false,"pushed_at":"2019-04-05T17:50:00.000Z","size":428,"stargazers_count":12,"open_issues_count":8,"forks_count":16,"subscribers_count":50,"default_branch":"master","last_synced_at":"2023-03-18T04:21:44.223Z","etag":null,"topics":["appmon","deployment"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dynatrace.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-03T08:30:25.000Z","updated_at":"2023-03-18T04:21:44.224Z","dependencies_parsed_at":"2022-08-17T20:55:28.760Z","dependency_job_id":null,"html_url":"https://github.com/Dynatrace/Dynatrace-AppMon-Chef","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dynatrace%2FDynatrace-AppMon-Chef","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dynatrace%2FDynatrace-AppMon-Chef/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dynatrace%2FDynatrace-AppMon-Chef/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dynatrace%2FDynatrace-AppMon-Chef/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dynatrace","download_url":"https://codeload.github.com/Dynatrace/Dynatrace-AppMon-Chef/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224673996,"owners_count":17351020,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appmon","deployment"],"created_at":"2024-11-14T18:34:41.673Z","updated_at":"2025-05-08T00:30:31.688Z","avatar_url":"https://github.com/Dynatrace.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dynatrace Cookbook\n\nThis Chef cookbook installs and configures the Dynatrace Application Monitoring 7.2 solution.\n\n[![Build Status](https://jenkins-01.eastus.cloudapp.azure.com/job/dynatrace-cookbook/badge/icon)](https://jenkins-01.eastus.cloudapp.azure.com/job/dynatrace-cookbook/)\n\n## Requirements\n\nRequires Chef 12 or higher.\n\n## Recipes\n\n### default\n\nInstalls the Dynatrace Server. Please refer to the `server` Chef Recipe below.\n\n### agents_package\n\n*Installs the Dynatrace Agents package.*\n\nThis recipe downloads and installs the most recent version of the Dynatrace Agents package from [http://downloads.dynatracesaas.com](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.\n\n**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.\n\n### agents_package_uninstall\n\nThis recipe uninstalls the Dynatrace Agents package installed by the `agents_package` recipe.\n\n**Note:** this recipe does not delete the user created by the `dynatrace_user` recipe which is included by the `agents_package` recipe.\n**Note:** as part of the uninstallation process the `opt/dynatrace` directory is deleted which is by default shared by other Dynatrace components (e.g. `wsagent_package`).\n\n### apache_wsagent\n\n*Installs the Dynatrace WebServer Agent for the Apache HTTP Server.*\n\nThis recipe downloads and installs the most recent version of the Dynatrace WebServer Agent package from [http://downloads.dynatracesaas.com](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.\n\n**Note:** you will have to restart the web server after placing the agent.\n\n### apache_wsagent_uninstall\n\nThis recipe remove the agent from the Apache HTTP Server configuration file and uninstalls the Dynatrace WebServer Agent package installed by the `apache_wsagent` recipe.\n\n**Note:** this recipe does not delete the user created by the `dynatrace_user` recipe which is included by the `apache_wsagent` recipe.\n**Note:** as part of the uninstallation process the `opt/dynatrace` directory is deleted which is by default shared by other Dynatrace components (e.g. `agents_package`).\n\n### collector\n\n*Installs the Dynatrace Collector.*\n\nThis recipe downloads and installs the most recent version of the Dynatrace Collector from [http://downloads.dynatracesaas.com](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.\n\n**Note:** make sure that attributes related to the Collector's memory configuration are set in accordance to the [Memory Configuration](https://community.dynatrace.com/community/display/DOCDT65/Set+up+Collectors#SetupCollectors-ConfigureMemory) section of the [Collector Configuration](https://community.dynatrace.com/community/display/DOCDT65/Set+up+Collectors) documentation.\n\n### collector_uninstall\n\nThis recipe uninstalls the Dynatrace Collector package installed by the `collector` recipe.\n\n**Note:** this recipe does not delete the user created by the `dynatrace_user` recipe which is included by `collector` recipe.\n\n### dotnet_agent\n\n*Installs the Dynatrace .NET Agent.*\n\nThis recipe downloads and installs the most recent version of the Dynatrace Agents package from [http://downloads.dynatracesaas.com](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.\n\n### host_agent\n\n*Installs the Host Agent package.*\n\nThis recipe downloads and installs the most recent version of the Host Agent package from [http://downloads.dynatracesaas.com](http://downloads.dynatracesaas.com). The default download link can #be overridden via the `['dynatrace']['host_agent']['linux']['installer']['file_url']` attribute. Alternatively, you can place the installer artifact as `dynatrace-hostagent.tar` in the cookbook's `files` directory from where it will be picked up during the installation. Please refer to `attributes/host_agent.rb` for a list of supported attributes. In order to have the Chef Recipe executed, include `recipe[dynatrace::host_agent]` in a runlist and override attributes as required.\n\n### host_agent_uninstall\n\nThis recipe uninstalls the Dynatrace Host Agent package installed by the `host_package` recipe.\n\n**Note:** this recipe does not delete the user created by the `dynatrace_user` recipe which is included by the `host_package` recipe.\n**Note:** as part of the uninstallation process the `opt/dynatrace` directory is deleted which is by default shared by other Dynatrace components (e.g. `agents_package`).\n\n### iis_wsagent\n\n*Installs the Dynatrace WebServer Agent for the Microsoft IIS Server.*\n\nThis recipe downloads and installs the most recent version of the Dynatrace WebServer Agent package from [http://downloads.dynatracesaas.com](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.\n\n### java_agent\n\n*Installs the Dynatrace Agent Java Agent.*\n\nThis recipe downloads and installs the most recent version of the Dynatrace Agents package from [http://downloads.dynatracesaas.com](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.\n\n**Note:** this recipe makes the Java Agent available to a Java Virtual Machine by injecting an appropriate [-agentpath](https://community.compuwareapm.com/community/display/DOCDT65/Java+Agent+Configuration) 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.\n\n**Note:** it is only possible to inject one agent on one machine using this recipe. To inject more agents it is possible to use the `resources/java_agent.rb` resource which sets the `node['dynatrace']['java_agent']['javaopts'][$agent_name]` with options to be passed to the JVM (e.g. `-agentpath:/opt/dynatrace/agent/lib64/libdtagent.so=name=BusinessBackend_easyTravel,server=dynasprint-collector.dynatracesaas.com:9998`).\n\n### memory_analysis_server\n\nThis recipe downloads and installs the most recent version of the Dynatrace Memory Analysis Server from [http://downloads.dynatracesaas.com](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.\n\n**Note:** make sure that attributes related to the Analysis Server's memory configuration are set in accordance to the [Memory Configuration](https://community.dynatrace.com/community/display/DOCDT65/Set+up+a+Memory+Analysis+Server#SetupaMemoryAnalysisServer-ConfigureMemory) section of the [Memory Analysis Server Configuration](https://community.dynatrace.com/community/display/DOCDT65/Set+up+a+Memory+Analysis+Server) documentation.\n\n### server\n\n*Installs the Dynatrace Server.*\n\nThis recipe downloads and installs the most recent version of the Dynatrace Server from [http://downloads.dynatracesaas.com](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-server.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.\n\n### server_uninstall\n\nThis recipe uninstalls the Dynatrace Server package installed by the `server` recipe.\n\n**Note:** this recipe does not delete the user created by the `dynatrace_user` recipe which is included by `server` recipe.\n\n### server_license\n\n*Installs the Dynatrace Server License.*\n\nPlace the Dynatrace Server License as `dynatrace-license.lic` 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.\n\n### server_pwh_connection\n\n*Sets connection to the Performance Warehouse.*\n\nThis recipe sets the connection to the Performance Warehouse on the Dynatrace Server. This recipe assumes the Dynatrace Server is up and running. Please refer to the `.kitchen.yml` file for example of usage.\n\n**Note:** This recipe will work after installing the Server License (see `server_license` recipe).\n\n### server_ldap_config\n\n*Configures LDAP connection.*\n\nThis recipe configures connection to LDAP through RESTful API. This recipe assumes the Dynatrace Server is up and running. Please refer to the `.kitchen.yml` file for example of usage.\n\n### server_users\n\n*Configures server user accounts.*\n\nThis recipe creates/updates Dynatrace Server user accounts through RESTful API. This recipe assumes the Dynatrace Server is up and running. The user account configuration is passed as node attributes. Please refer to the `.kitchen.yml` file for example of usage.\n\n### server_user_groups\n\n*Configures server groups.*\n\nThis recipe creates/updates Dynatrace Server groupsthrough RESTful API. This recipe assumes the Dynatrace Server is up and running. The group configuration is passed as node attributes. Please refer to the `.kitchen.yml` file for example of usage.\n\n### wsagent_package\n\n*Installs the Dynatrace WebServer Agent package.*\n\nThis recipe downloads and installs the most recent version of the Dynatrace WebServer Agent package from [http://downloads.dynatracesaas.com](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.\n\n**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_agent`recipes for examples.\n\n### wsagent_package_uninstall\n\nThis recipe uninstalls the Dynatrace WebServer Agent package installed by the `wsagent_package` recipe.\n\n**Note:** this recipe does not delete the user created by the `dynatrace_user` recipe which is included by the `wsagent_package` recipe.\n**Note:** as part of the uninstallation process the `opt/dynatrace` directory is deleted which is by default shared by other Dynatrace components (e.g. `agents_package`).\n\n## Testing\n\nWe use [Test Kitchen](http://kitchen.ci) to automatically test our automated deployments with [Serverspec](http://serverspec.org) and [RSpec](http://rspec.info/):\n\n1) Install Test Kitchen and its dependencies from within the project's directory:\n\n```\ngem install bundler\nbundle install\n```\n\n2) Run all tests\n\n```\nkitchen test\n```\n\nBy default, we run our tests inside [Docker](https://www.docker.com/) 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](https://www.virtualbox.org/) and [Vagrant](https://www.vagrantup.com/) (see `.kitchen.vagrant.yml`).\n\n## Platforms\n\n### Linux\n\n- CentOS\n- Debian\n- Red Hat Enterprise Linux\n- Ubuntu\n\n### Windows\n\n- Windows 2012\n\n## Problems? Questions? Suggestions?\n\nThis offering is [Dynatrace Community Supported](https://community.dynatrace.com/community/display/DL/Support+Levels#SupportLevels-Communitysupported/NotSupportedbyDynatrace(providedbyacommunitymember)). Feel free to share any problems, questions and suggestions with your peers on the Dynatrace Community's [Application Monitoring \u0026 UEM Forum](https://answers.dynatrace.com/spaces/146/index.html).\n\n## License\n\nLicensed under the MIT License. See the LICENSE file for details.\n[![analytics](https://www.google-analytics.com/collect?v=1\u0026t=pageview\u0026_s=1\u0026dl=https%3A%2F%2Fgithub.com%2FdynaTrace\u0026dp=%2FDynatrace-Chef\u0026dt=Dynatrace-Chef\u0026_u=Dynatrace~\u0026cid=github.com%2FdynaTrace\u0026tid=UA-54510554-5\u0026aip=1)]()\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdynatrace%2Fdynatrace-appmon-chef","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdynatrace%2Fdynatrace-appmon-chef","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdynatrace%2Fdynatrace-appmon-chef/lists"}