add support for custom request attributes (#7)

* add support for custom request attributes

Author: alramlechner

README.md

@@ -19,6 +19,7 @@ This is the official Java implementation of the [Dynatrace OneAgent SDK](https:/
 * [Features](#features)
  	* [Trace incoming and outgoing remote calls](#remoting)
  	* [In process linking](#inprocess)
+ 	* [Add custom request attributes](#scav)
 * [Further reading](#furtherreading)
 * [Help & Support](#help)
 * [Release notes](#releasenotes)
@@ -39,9 +40,10 @@ This is the official Java implementation of the [Dynatrace OneAgent SDK](https:/
 - Dynatrace OneAgent (required versions see below)
 
 |OneAgent SDK for Java|Required OneAgent version|
-|:------|:--------|
-|1.1.0  |>=1.143  |
-|1.0.3  |>=1.135  |
+|:--------------------|:------------------------|
+|1.2.0                |>=1.147                  |
+|1.1.0                |>=1.143                  |
+|1.0.3                |>=1.135                  |
 
 <a name="integration" />
 
@@ -55,7 +57,7 @@ If you want to integrate the OneAgent SDK into your application, just add the fo
 	<dependency>
 	  <groupId>com.dynatrace.oneagent.sdk.java</groupId>
 	  <artifactId>oneagent-sdk</artifactId>
-	  <version>1.1.0</version>
+	  <version>1.2.0</version>
 	  <scope>compile</scope>
 	</dependency>
 
@@ -124,10 +126,11 @@ The feature sets differ slightly with each language implementation. More functio
 
 A more detailed specification of the features can be found in [Dynatrace OneAgent SDK](https://github.com/Dynatrace/OneAgent-SDK#features).
 
-|Feature|Required OneAgent SDK for Java version|
-|:------|:--------|
-|In process linking  |>=1.1.0  |
-|Trace incoming and outgoing remote calls  |>=1.0.3  |
+|Feature                                   |Required OneAgent SDK for Java version|
+|:-----------------------------------------|:-------------------------------------|
+|Custom request attributes                 |>=1.2.0                               |
+|In process linking                        |>=1.1.0                               |
+|Trace incoming and outgoing remote calls  |>=1.0.3                               |
 
 <a name="remoting" />
 
@@ -195,6 +198,21 @@ try {
 }
 ```
 
+<a name="scav" />
+
+### Add custom request attributes
+
+You can use the SDK to add custom request attributes to the current traced service. Custom request attributes allow you to do advanced filtering of your requests in Dynatrace.
+
+Adding custom request attributes to the currently traced service call is simple. Just call one of the addCustomRequestAttribute methods with your key and value:
+
+```Java
+oneAgentSDK.addCustomRequestAttribute("region", "EMEA");
+oneAgentSDK.addCustomRequestAttribute("salesAmount", 2500);
+```
+
+When no service call is being traced, the custom request attributes are dropped.
+
 <a name="furtherreading" />
 
 ## Further readings
@@ -232,7 +250,8 @@ SLAs apply according to the customer's support level.
 
 see also https://github.com/Dynatrace/OneAgent-SDK-for-Java/releases
 
-|Version|Description|Links|
+|Version|Description                            |Links                                    |
 |:------|:--------------------------------------|:----------------------------------------|
+|1.2.0  |Added support for in-process-linking   |[binary](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.2.0/oneagent-sdk-1.2.0.jar) [source](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.2.0/oneagent-sdk-1.2.0-sources.jar) [javadoc](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.2.0/oneagent-sdk-1.2.0-javadoc.jar)|
 |1.1.0  |Added support for in-process-linking   |[binary](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.1.0/oneagent-sdk-1.1.0.jar) [source](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.1.0/oneagent-sdk-1.1.0-sources.jar) [javadoc](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.1.0/oneagent-sdk-1.1.0-javadoc.jar)|
 |1.0.3  |Initial release                        |[binary](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.0.3/oneagent-sdk-1.0.3.jar) [source](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.0.3/oneagent-sdk-1.0.3-sources.jar) [javadoc](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.0.3/oneagent-sdk-1.0.3-javadoc.jar)|

docs/META-INF/MANIFEST.MF

@@ -2,12 +2,12 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:21 CEST 2018 -->
+<!-- Generated by javadoc (build 1.6.0_45) on Thu May 24 14:52:46 CEST 2018 -->
 <TITLE>
-All Classes (sdk 1.1.0 API)
+All Classes (sdk 1.2.0 API)
 </TITLE>
 
-<META NAME="date" CONTENT="2018-04-24">
+<META NAME="date" CONTENT="2018-05-24">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
 

docs/allclasses-frame.html

@@ -2,12 +2,12 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:21 CEST 2018 -->
+<!-- Generated by javadoc (build 1.6.0_45) on Thu May 24 14:52:46 CEST 2018 -->
 <TITLE>
-All Classes (sdk 1.1.0 API)
+All Classes (sdk 1.2.0 API)
 </TITLE>
 
-<META NAME="date" CONTENT="2018-04-24">
+<META NAME="date" CONTENT="2018-05-24">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
 

docs/allclasses-noframe.html

@@ -2,20 +2,20 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:21 CEST 2018 -->
+<!-- Generated by javadoc (build 1.6.0_45) on Thu May 24 14:52:46 CEST 2018 -->
 <TITLE>
-OneAgentSDKFactory (sdk 1.1.0 API)
+OneAgentSDKFactory (sdk 1.2.0 API)
 </TITLE>
 
-<META NAME="date" CONTENT="2018-04-24">
+<META NAME="date" CONTENT="2018-05-24">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
 
 <SCRIPT type="text/javascript">
 function windowTitle()
 {
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="OneAgentSDKFactory (sdk 1.1.0 API)";
+        parent.document.title="OneAgentSDKFactory (sdk 1.2.0 API)";
     }
 }
 </SCRIPT>

docs/com/dynatrace/oneagent/sdk/OneAgentSDKFactory.html

@@ -2,20 +2,20 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:20 CEST 2018 -->
+<!-- Generated by javadoc (build 1.6.0_45) on Thu May 24 14:52:46 CEST 2018 -->
 <TITLE>
-InProcessLink (sdk 1.1.0 API)
+InProcessLink (sdk 1.2.0 API)
 </TITLE>
 
-<META NAME="date" CONTENT="2018-04-24">
+<META NAME="date" CONTENT="2018-05-24">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
 
 <SCRIPT type="text/javascript">
 function windowTitle()
 {
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="InProcessLink (sdk 1.1.0 API)";
+        parent.document.title="InProcessLink (sdk 1.2.0 API)";
     }
 }
 </SCRIPT>

docs/com/dynatrace/oneagent/sdk/api/InProcessLink.html

@@ -2,20 +2,20 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:20 CEST 2018 -->
+<!-- Generated by javadoc (build 1.6.0_45) on Thu May 24 14:52:46 CEST 2018 -->
 <TITLE>
-InProcessLinkTracer (sdk 1.1.0 API)
+InProcessLinkTracer (sdk 1.2.0 API)
 </TITLE>
 
-<META NAME="date" CONTENT="2018-04-24">
+<META NAME="date" CONTENT="2018-05-24">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
 
 <SCRIPT type="text/javascript">
 function windowTitle()
 {
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="InProcessLinkTracer (sdk 1.1.0 API)";
+        parent.document.title="InProcessLinkTracer (sdk 1.2.0 API)";
     }
 }
 </SCRIPT>

docs/com/dynatrace/oneagent/sdk/api/InProcessLinkTracer.html

@@ -2,20 +2,20 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:20 CEST 2018 -->
+<!-- Generated by javadoc (build 1.6.0_45) on Thu May 24 14:52:46 CEST 2018 -->
 <TITLE>
-IncomingRemoteCallTracer (sdk 1.1.0 API)
+IncomingRemoteCallTracer (sdk 1.2.0 API)
 </TITLE>
 
-<META NAME="date" CONTENT="2018-04-24">
+<META NAME="date" CONTENT="2018-05-24">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
 
 <SCRIPT type="text/javascript">
 function windowTitle()
 {
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="IncomingRemoteCallTracer (sdk 1.1.0 API)";
+        parent.document.title="IncomingRemoteCallTracer (sdk 1.2.0 API)";
     }
 }
 </SCRIPT>

docs/com/dynatrace/oneagent/sdk/api/IncomingRemoteCallTracer.html

@@ -2,20 +2,20 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:20 CEST 2018 -->
+<!-- Generated by javadoc (build 1.6.0_45) on Thu May 24 14:52:46 CEST 2018 -->
 <TITLE>
-IncomingTaggable (sdk 1.1.0 API)
+IncomingTaggable (sdk 1.2.0 API)
 </TITLE>
 
-<META NAME="date" CONTENT="2018-04-24">
+<META NAME="date" CONTENT="2018-05-24">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
 
 <SCRIPT type="text/javascript">
 function windowTitle()
 {
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="IncomingTaggable (sdk 1.1.0 API)";
+        parent.document.title="IncomingTaggable (sdk 1.2.0 API)";
     }
 }
 </SCRIPT>

docs/com/dynatrace/oneagent/sdk/api/IncomingTaggable.html

@@ -2,20 +2,20 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:20 CEST 2018 -->
+<!-- Generated by javadoc (build 1.6.0_45) on Thu May 24 14:52:46 CEST 2018 -->
 <TITLE>
-LoggingCallback (sdk 1.1.0 API)
+LoggingCallback (sdk 1.2.0 API)
 </TITLE>
 
-<META NAME="date" CONTENT="2018-04-24">
+<META NAME="date" CONTENT="2018-05-24">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
 
 <SCRIPT type="text/javascript">
 function windowTitle()
 {
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="LoggingCallback (sdk 1.1.0 API)";
+        parent.document.title="LoggingCallback (sdk 1.2.0 API)";
     }
 }
 </SCRIPT>