https://github.com/dynatrace/dynatrace-appmon-eclipse-integration-plugin

Tool Integration and Automation dynaTrace Eclipse Integration Plugin
https://github.com/dynatrace/dynatrace-appmon-eclipse-integration-plugin

appmon plugin

Last synced: about 1 year ago
JSON representation

Tool Integration and Automation dynaTrace Eclipse Integration Plugin

• Host: GitHub
• URL: https://github.com/dynatrace/dynatrace-appmon-eclipse-integration-plugin
• Owner: Dynatrace
• License: bsd-3-clause
• Created: 2014-10-02T03:00:28.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2019-02-13T12:40:59.000Z (over 7 years ago)
• Last Synced: 2023-08-22T01:01:52.228Z (almost 3 years ago)
• Topics: appmon, plugin
• Language: Java
• Homepage: https://community.dynatrace.com/community/display/DL/dynaTrace+Eclipse+Integration+Plugin
• Size: 15.4 MB
• Stars: 3
• Watchers: 49
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


# Dynatrace Eclipse Integration Plugin [![Build Status](https://travis-ci.org/Dynatrace/Dynatrace-Eclipse-Integration-Plugin.svg?branch=master)](https://travis-ci.org/Dynatrace/Dynatrace-Eclipse-Integration-Plugin) 

The Dynatrace Eclipse Integration Plugin enables you to:

* launch applications with an injected Dynatrace AppMon Agent directly from Eclipse IDE

* retrieve & display the key architectural metrics (such as number of SQL queries, external API calls, exceptions and log messages) from your tests

* perform lookups of source code files and methods from applications under diagnosis in Dynatrace AppMon

#### Table of Contents

* [Installation](#installation)  

  * [Prerequisites](#prerequisites)  

* [Configuration](#configuration)

  * [Global Settings](#global-settings)

  * [Run Configurations](#run-configurations)

* [Using the Eclipse Integration Plugin](#using-the-eclipse-integration-plugin)

  * [Launcher](#launcher)

  * [Test Results](#test-results)

  * [Source Code Lookup](#source-code-lookup)

*  [Problems? Questions? Suggestions?](#problems-questions-suggestions)

* [Additional Resources](#additional-resources)

  * [Dynatrace AppMon Documentation](#dynatrace-appmon-documentation)

  * [Recorded Webinars](#recorded-webinars)

  * [Blogs](#blogs)

## Installation

### Prerequisites

* Dynatrace Application Monitoring Version: 6.3+

* Java agent must be installed locally on the development machine

* Eclipse Version: Juno, Kepler, Luna, Mars, Neon

### Use Eclipse marketplace

![marketplace entry](/img/conf/eclipse_marketplace-dynatrace_eclipse-integration-plugin.png)

### Download from github

* Download the [latest plugin .zip archive](https://github.com/Dynatrace/Dynatrace-Eclipse-Integration-Plugin/releases/)

* in Eclipse, click on "Help" / "Install New Software..."

* Add.., Archive...

* select the downloaded archive

![add site](/img/conf/add_site.png)

## Configuration

### Global Settings

The global settings for the plugin are located under Window / Preferences

![global settings](/img/conf/global_settings.png)

### Run Configurations 

![run configurations](/img/conf/run_with_appmon_configuration.png) 

![edit run configurations](/img/conf/run_with_appmon_configuration_2.png) 

## Using the Eclipse Integration Plugin

### Launcher

The launcher will run applications with an injected Dynatrace Agent using the agent name and additional parameters defined in the run configuration:

![edit run configurations](/img/use/launcher.png) 

The launcher supports the following launch mode:

* Java application

* JUnit test

* Equinox OSGi application

* Eclipse workbench application

The agent will output debug information into the console:

![edit run configurations](/img/use/launcher_console.png) 

### Test Results

When launching JUnit tests with the Dynatrace launcher, the plug-in will automatically register a test run to the Dynatrace Server. The results and key architectural metrics are automatically retrieved and displayed in the *Test Result* tab.

![edit run configurations](/img/use/test_result.png) 

The test results are also visible in the Dynatrace Client for further drill-down to the PurePath level.

![edit run configurations](/img/use/dynatrace_client_test_automation.png) 

### Source Code Lookup

The Dynatrace Client enables you to analyze PurePaths down to the individual methods that have been instrumented in the context of the captured transaction. When you identify a problematic method either in the PurePath view or in the Methods view of the Dynatrace Client, you can use the Source Code Lookup to jump to the source code line if you have the Eclipse project open.

![edit run configurations](/img/use/source_lookup.png) 

## Problems? Questions? Suggestions?

* [Eclipse Integration Plugin FAQ / Troubleshooting Guide](FAQ.md)

* Post any problems, questions or suggestions to the Dynatrace Community's [Application Monitoring & UEM Forum](https://answers.dynatrace.com/spaces/146/index.html).

## Additional Resources

### Dynatrace AppMon Documentation

- [Continuous Delivery & Test Automation](https://community.dynatrace.com/community/pages/viewpage.action?pageId=215161284)

- [Capture Performance Data from Tests](https://community.dynatrace.com/community/display/DOCDT63/Capture+Performance+Data+from+Tests)

- [Integrate Dynatrace in Continous Integration Builds](https://community.dynatrace.com/community/display/DOCDT63/Integrate+Dynatrace+in+Continuous+Integration+Builds)

### Recorded Webinars

- [Online Perf Clinic - Eclipse and Jenkins Integration](https://youtu.be/p4Vh6BWlPjg)

- [Online Perf Clinic - Metrics-Driven Continuous Delivery with Dynatrace Test Automation](https://youtu.be/TXPSDpy7unw)

### Blogs

- [Continuous Performance Validation in Continuous Integration Environments](http://apmblog.dynatrace.com/2013/11/27/continuous-performance-validation-in-continuous-integration-environments/)

- [Software Quality Metrics for your Continuous Delivery Pipeline – Part I](http://apmblog.dynatrace.com/2014/03/13/software-quality-metrics-for-your-continuous-delivery-pipeline-part-i/)

- [Software Quality Metrics for your Continuous Delivery Pipeline – Part II: Database](http://apmblog.dynatrace.com/2014/04/23/database-access-quality-metrics-for-your-continuous-delivery-pipeline/)

- [Software Quality Metrics for your Continuous Delivery Pipeline – Part III – Logging](http://apmblog.dynatrace.com/2014/06/17/software-quality-metrics-for-your-continuous-delivery-pipeline-part-iii-logging/)