Composer 1000x326.png
 
Composer step by step instructions

 

How to start Composer

  • Linux / Mac: Open run.sh in the terminal, open the browser and type the following localhost:9191, enter, the composer start page appears

  • Windows: Open run.bat by double click, open the browser and type the following localhost:9191, enter, the composer start page appears

Composer helps you with the configuration management of your Dynatrace environments. 

 

How to use Composer

1. Navigate to the Dynatrace tab and create an environment JSON file where you will store details about your Dynatrace Tenant URL and API V1 Token.

Screen Shot 2021-04-23 at 1.54.02 PM.png

2. Enter Dynatrace environment details in the following format:

Dynatrace SaaS:  https://{your-environment-id}.live.dynatrace.com

Dynatrace Managed:  https://{your-domain}/e/{your-environment-id}


Dynatrace Environment Token:  YOUR_ENVIRONMENT_TOKEN

The Dynatrace API Token must have the API V1 read configuration permission

Screen Shot 2021-04-23 at 1.56.25 PM.png

3. Click the Git menu item and create a Gitlab JSON file where you will store details about your Gitlab repository where you would like to store your Dynatrace configuration files.

Screen Shot 2021-04-23 at 1.58.30 PM.png

4. Navigate to the Backup tab to store Dynatrace configuration data.

Screen Shot 2021-04-23 at 2.00.17 PM.png

5. Navigate to the Checkin tab and provide your repository credentials

Screen Shot 2021-04-23 at 1.49.11 PM.png

Solution for SSL errors

Problem: SSL Error during "Save Dynatrace Environment Information"

Solution: Add your custom SSL certificate to the java trust store

Use the keytool

Import your custom certificate to the trust store

Syntax:

` keytool -import -alias dynacert -keystore \lib\security\cacerts -file <path to your .crt file>

`

To check which certificates are in your java trust store

keytool -list -keystore \lib\security\cacerts >keys.txt

Composer system requirements 

  • Linux or Windows

  • Java >= 1.8

  • Web browser

  • 200 MB disk space

Composer support 

  • Contact us with any other issues related to Composer: CONTACT US

 
Compare Commits using Gitlab

Use the following steps to compare different Dynatrace configurations and find out what has changed recently.

How to compare commits in Gitlab:

  1. Go to Repository / Compare in your Gitlab environment

  2. Paste the Commit SHA of your source or initial commit

  3. Paste the Commit SHA of your target commit

  4. Click the compare button

Gitlab Compare:

Screen Shot 2021-04-20 at 8.17.18 AM.png

Find the Commit SHA in your Gitlab / Commit page

Screen Shot 2021-04-20 at 8.22.43 AM.png
 
Dynatrace API Token Permissions

To ensure that Composer is able to read the entire environment configuration please assign the following Dynatrace API Token permissions

**1. API V2 - Read credential vault entries

  1. API V1 - Read configuration**

Screen Shot 2021-04-20 at 8.30.13 AM.png
 
Composer End User License Agreement

End User Licence Agreement Licence

  1. Under this End User Licence Agreement (the "Agreement"), Performetriks (the "Vendor") grants to the user (the "Licensee") a non-exclusive and non-transferable licence (the "Licence") to use Composer (the "Software").

  2. "Software" includes the executable computer programs and any related printed, electronic and online documentation and any other files that may accompany the product.

  3. Title, copyright, intellectual property rights and distribution rights of the Software remain exclusively with the Vendor. Intellectual property rights include the look and feel of the Software. This Agreement constitutes a licence for use only and is not in any way a transfer of ownership rights to the Software.

  4. This Agreement grants a site licence to the Licensee. The Software may be loaded onto a maximum of one computer.

  5. The rights and obligations of this Agreement are personal rights granted to the Licensee only. The Licensee may not transfer or assign any of the rights or obligations granted under this Agreement to any other person or legal entity. The Licensee may not make available the Software for use by one or more third parties.

  6. The Software may not be modified, reverse-engineered, or de-compiled in any manner through current or future available technologies.

  7. Failure to comply with any of the terms under the Licence section will be considered a material breach of this Agreement. Licence Fee

  8. The original purchase price paid by the Licensee will constitute the entire licence fee and is the full consideration for this Agreement. Page 1 of 4

Limitation of Liability

  1. The Software is provided by the Vendor and accepted by the Licensee "as is". Liability of the Vendor will be limited to a maximum of the original purchase price of the Software. The Vendor will not be liable for any general, special, incidental or consequential damages including, but not limited to, loss of production, loss of profits, loss of revenue, loss of data, or any other business or economic disadvantage suffered by the Licensee arising out of the use or failure to use the Software.

  2. The Vendor makes no warranty expressed or implied regarding the fitness of the Software for a particular purpose or that the Software will be suitable or appropriate for the specific requirements of the Licensee.

  3. The Vendor does not warrant that use of the Software will be uninterrupted or error-free. The Licensee accepts that software in general is prone to bugs and flaws within an acceptable level as determined in the industry. Warrants and Representations

  4. The Vendor warrants and represents that it is the copyright holder of the Software. The Vendor warrants and represents that granting the licence to use this Software is not in violation of any other agreement, copyright or applicable statute. Acceptance

  5. All terms, conditions and obligations of this Agreement will be deemed to be accepted by the Licensee ("Acceptance") on installation of the Software on the first computer. User Support

  6. The Licensee will be entitled to 1 year of email support available 9:00 AM to 5:00 PM CST, Weekdays only, at no additional cost.

  7. The Licensee will be entitled to maintenance upgrades and bug fixes, at no additional cost, for a period of one year from the date of Acceptance.

Term

  1. The term of this Agreement will begin on Acceptance and will continue for a period of one year. At the end of the term of this Agreement the Licensee must destroy all copies of the Software in their possession.

Termination

  1. This Agreement will be terminated and the Licence forfeited where the Licensee has failed to comply with any of the terms of this Agreement or is in breach of this Agreement. On termination of this Agreement for any reason, the Licensee will promptly destroy the Software or return the Software to the Vendor. Force Majeure

  2. The Vendor will be free of liability to the Licensee where the Vendor is prevented from executing its obligations under this Agreement in whole or in part due to Force Majeure, such as earthquake, typhoon, flood, fire, and war or any other unforeseen and uncontrollable event where the Vendor has taken any and all appropriate action to mitigate such an event. Governing Law

  3. The Parties to this Agreement submit to the jurisdiction of the courts of the Province of British Columbia for the enforcement of this Agreement or any arbitration award or decision arising from this Agreement. This Agreement will be enforced or construed according to the laws of the Province of British Columbia.

Miscellaneous

  1. This Agreement can only be modified in writing signed by both the Vendor and the Licensee.

  2. This Agreement does not create or imply any relationship in agency or partnership between the

Vendor and the Licensee.

  1. Headings are inserted for the convenience of the parties only and are not to be considered when interpreting this Agreement. Words in the singular mean and include the plural and vice versa. Words in the masculine gender include the feminine gender and vice versa. Words in the neuter gender include the masculine gender and the feminine gender and vice versa.

  2. If any term, covenant, condition or provision of this Agreement is held by a court of competent jurisdiction to be invalid, void or unenforceable, it is the parties' intent that such provision be reduced in scope by the court only to the extent deemed necessary by that court to render the provision reasonable and enforceable and the remainder of the provisions of this Agreement will in no way be affected, impaired or invalidated as a result.

  3. This Agreement contains the entire agreement between the parties. All understandings have been included in this Agreement. Representations which may have been made by any party to this Agreement may in some way be inconsistent with this final written Agreement. All such statements are declared to be of no value in this Agreement. Only the written terms of this Agreement will bind the parties.

  4. This Agreement and the terms and conditions contained in this Agreement apply to and are binding upon the Vendor's successors and assigns.

Notices

  1. All notices to the Vendor under this Agreement are to be provided at the following address: Performetriks: 2700 - 700 W. Georgia St. PO BOX 10057 Vancouver BC V7Y 1B8