Skip to content

Commit cd80fa4

Browse files
alramlechneralramlechner
committed
v1.1 - added inProcessLinking
1 parent adccb55 commit cd80fa4

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+2205
-167
lines changed

‎README.md‎

Lines changed: 34 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ If you want to integrate the OneAgent SDK into your application, just add the fo
2828
<dependency>
2929
<groupId>com.dynatrace.oneagent.sdk.java</groupId>
3030
<artifactId>oneagent-sdk</artifactId>
31-
<version>1.0.3</version>
31+
<version>1.1.0</version>
3232
<scope>compile</scope>
3333
</dependency>
3434

@@ -110,30 +110,57 @@ try {
110110
On the server side you need to wrap the handling and processing of your remote call as well. This will not only trace the server side call and everything that happens, it will also connect it to the calling side.
111111

112112
```Java
113-
IncomingRemoteCallTracer incomingRemoteCall = OneAgentSDK.traceIncomingRemoteCall("remoteMethodToCall", "RemoteServiceName", "rmi://Endpoint/service");
113+
OneAgentSDK oneAgentSdk = OneAgentSDKFactory.createInstance();
114+
IncomingRemoteCallTracer incomingRemoteCall = oneAgentSdk.traceIncomingRemoteCall("remoteMethodToCall", "RemoteServiceName", "rmi://Endpoint/service");
114115
incomingRemoteCall.setDynatraceStringTag(tag);
115116
incomingRemoteCall.start();
116117
try {
117118
incomingRemoteCall.setProtocolName("RMI/custom");
118119
doSomeWork(); // process the remoteCall
119120
} catch (Exception e) {
120121
incomingRemoteCall.error(e);
121-
}finally{
122+
// rethrow or add your exception handling
123+
} finally{
122124
incomingRemoteCall.end();
123125
}
124126
```
125127

128+
## Using the Dynatrace OneAgent SDK for in-process-linking
129+
130+
You can use the SDK to link inside a single process. To link for eg. an asynchronous execution, you need the following code:
131+
```Java
132+
OneAgentSDK oneAgentSdk = OneAgentSDKFactory.createInstance();
133+
InProcessLink inProcessLink = sdk.createInProcessLink();
134+
```
135+
136+
Provide the returned inProcessLink to the code, that does the asynchronous execution:
137+
138+
```Java
139+
OneAgentSDK sdk = OneAgentSDKFactory.createInstance();
140+
InProcessLinkTracer inProcessLinkTracer = sdk.traceInProcessLink(inProcessLink);
141+
inProcessLinkTracer.start();
142+
try {
143+
// do the work ...
144+
} catch (Exception e) {
145+
inProcessLinkTracer.error(e);
146+
// rethrow or add your exception handling
147+
} finally {
148+
inProcessLinkTracer.end();
149+
}
150+
```
151+
126152
### Compatibility OneAgent SDK for Java releases with OneAgent for Java releases
127153
|OneAgent SDK for Java|Dynatrace OneAgent Java|
128154
|:------|:--------|
155+
|1.1.0 |>=1.143 |
129156
|1.0.3 |>=1.135 |
130157

131158
## Feedback
132159

133-
In case of questions, issues or feature requests feel free to contact [Michael Kopp](https://github.com/mikopp), [Alram Lechner](https://github.com/AlramLechnerDynatrace) or file an issue. Your feedback is welcome!
134-
160+
In case of questions, issues or feature requests feel free to contact the maintainer by dynatrace.oneagent.sdk(at)dynatrace(dot)com or file an issue. Your feedback is welcome!
135161

136162
## OneAgent SDK for Java release notes
137163
|Version|Date|Description|
138-
|:------|:----------|:------------------|
139-
|1.0.3 |01.2018 |Initial release |
164+
|:------|:----------|:--------------------------------------|:----------------------------------------|
165+
|1.1.0 |04.2018 |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.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.1.0-javadoc.jar)|
166+
|1.0.3 |01.2018 |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/allclasses-frame.html‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
<!--NewPage-->
33
<HTML>
44
<HEAD>
5-
<!-- Generated by javadoc (build 1.6.0_105) on Thu Jan 25 15:26:44 UTC 2018 -->
5+
<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:21 CEST 2018 -->
66
<TITLE>
7-
All Classes (sdk 1.0.3 API)
7+
All Classes (sdk 1.1.0 API)
88
</TITLE>
99

10-
<META NAME="date" CONTENT="2018-01-25">
10+
<META NAME="date" CONTENT="2018-04-24">
1111

1212
<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
1313

@@ -27,6 +27,10 @@
2727
<BR>
2828
<A HREF="com/dynatrace/oneagent/sdk/api/IncomingTaggable.html" title="interface in com.dynatrace.oneagent.sdk.api" target="classFrame"><I>IncomingTaggable</I></A>
2929
<BR>
30+
<A HREF="com/dynatrace/oneagent/sdk/api/InProcessLink.html" title="interface in com.dynatrace.oneagent.sdk.api" target="classFrame"><I>InProcessLink</I></A>
31+
<BR>
32+
<A HREF="com/dynatrace/oneagent/sdk/api/InProcessLinkTracer.html" title="interface in com.dynatrace.oneagent.sdk.api" target="classFrame"><I>InProcessLinkTracer</I></A>
33+
<BR>
3034
<A HREF="com/dynatrace/oneagent/sdk/api/LoggingCallback.html" title="interface in com.dynatrace.oneagent.sdk.api" target="classFrame"><I>LoggingCallback</I></A>
3135
<BR>
3236
<A HREF="com/dynatrace/oneagent/sdk/api/OneAgentSDK.html" title="interface in com.dynatrace.oneagent.sdk.api" target="classFrame"><I>OneAgentSDK</I></A>

‎docs/allclasses-noframe.html‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
<!--NewPage-->
33
<HTML>
44
<HEAD>
5-
<!-- Generated by javadoc (build 1.6.0_105) on Thu Jan 25 15:26:44 UTC 2018 -->
5+
<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:21 CEST 2018 -->
66
<TITLE>
7-
All Classes (sdk 1.0.3 API)
7+
All Classes (sdk 1.1.0 API)
88
</TITLE>
99

10-
<META NAME="date" CONTENT="2018-01-25">
10+
<META NAME="date" CONTENT="2018-04-24">
1111

1212
<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
1313

@@ -27,6 +27,10 @@
2727
<BR>
2828
<A HREF="com/dynatrace/oneagent/sdk/api/IncomingTaggable.html" title="interface in com.dynatrace.oneagent.sdk.api"><I>IncomingTaggable</I></A>
2929
<BR>
30+
<A HREF="com/dynatrace/oneagent/sdk/api/InProcessLink.html" title="interface in com.dynatrace.oneagent.sdk.api"><I>InProcessLink</I></A>
31+
<BR>
32+
<A HREF="com/dynatrace/oneagent/sdk/api/InProcessLinkTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><I>InProcessLinkTracer</I></A>
33+
<BR>
3034
<A HREF="com/dynatrace/oneagent/sdk/api/LoggingCallback.html" title="interface in com.dynatrace.oneagent.sdk.api"><I>LoggingCallback</I></A>
3135
<BR>
3236
<A HREF="com/dynatrace/oneagent/sdk/api/OneAgentSDK.html" title="interface in com.dynatrace.oneagent.sdk.api"><I>OneAgentSDK</I></A>

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,20 @@
22
<!--NewPage-->
33
<HTML>
44
<HEAD>
5-
<!-- Generated by javadoc (build 1.6.0_105) on Thu Jan 25 15:26:44 UTC 2018 -->
5+
<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:21 CEST 2018 -->
66
<TITLE>
7-
OneAgentSDKFactory (sdk 1.0.3 API)
7+
OneAgentSDKFactory (sdk 1.1.0 API)
88
</TITLE>
99

10-
<META NAME="date" CONTENT="2018-01-25">
10+
<META NAME="date" CONTENT="2018-04-24">
1111

1212
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
1313

1414
<SCRIPT type="text/javascript">
1515
function windowTitle()
1616
{
1717
if (location.href.indexOf('is-external=true') == -1) {
18-
parent.document.title="OneAgentSDKFactory (sdk 1.0.3 API)";
18+
parent.document.title="OneAgentSDKFactory (sdk 1.1.0 API)";
1919
}
2020
}
2121
</SCRIPT>

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

Lines changed: 176 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,176 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2+
<!--NewPage-->
3+
<HTML>
4+
<HEAD>
5+
<!-- Generated by javadoc (build 1.6.0_45) on Tue Apr 24 08:16:20 CEST 2018 -->
6+
<TITLE>
7+
InProcessLink (sdk 1.1.0 API)
8+
</TITLE>
9+
10+
<META NAME="date" CONTENT="2018-04-24">
11+
12+
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
13+
14+
<SCRIPT type="text/javascript">
15+
function windowTitle()
16+
{
17+
if (location.href.indexOf('is-external=true') == -1) {
18+
parent.document.title="InProcessLink (sdk 1.1.0 API)";
19+
}
20+
}
21+
</SCRIPT>
22+
<NOSCRIPT>
23+
</NOSCRIPT>
24+
25+
</HEAD>
26+
27+
<BODY BGCOLOR="white" onload="windowTitle();">
28+
<HR>
29+
30+
31+
<!-- ========= START OF TOP NAVBAR ======= -->
32+
<A NAME="navbar_top"><!-- --></A>
33+
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
34+
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
35+
<TR>
36+
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
37+
<A NAME="navbar_top_firstrow"><!-- --></A>
38+
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
39+
<TR ALIGN="center" VALIGN="top">
40+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
41+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
42+
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
43+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
44+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
45+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
46+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
47+
</TR>
48+
</TABLE>
49+
</TD>
50+
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
51+
</EM>
52+
</TD>
53+
</TR>
54+
55+
<TR>
56+
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
57+
&nbsp;<A HREF="../../../../../com/dynatrace/oneagent/sdk/api/IncomingTaggable.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>PREV CLASS</B></A>&nbsp;
58+
&nbsp;<A HREF="../../../../../com/dynatrace/oneagent/sdk/api/InProcessLinkTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>NEXT CLASS</B></A></FONT></TD>
59+
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
60+
<A HREF="../../../../../index.html?com/dynatrace/oneagent/sdk/api/InProcessLink.html" target="_top"><B>FRAMES</B></A> &nbsp;
61+
&nbsp;<A HREF="InProcessLink.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
62+
&nbsp;<SCRIPT type="text/javascript">
63+
<!--
64+
if(window==top) {
65+
document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
66+
}
67+
//-->
68+
</SCRIPT>
69+
<NOSCRIPT>
70+
<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
71+
</NOSCRIPT>
72+
73+
74+
</FONT></TD>
75+
</TR>
76+
<TR>
77+
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
78+
SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;METHOD</FONT></TD>
79+
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
80+
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;METHOD</FONT></TD>
81+
</TR>
82+
</TABLE>
83+
<A NAME="skip-navbar_top"></A>
84+
<!-- ========= END OF TOP NAVBAR ========= -->
85+
86+
<HR>
87+
<!-- ======== START OF CLASS DATA ======== -->
88+
<H2>
89+
<FONT SIZE="-1">
90+
com.dynatrace.oneagent.sdk.api</FONT>
91+
<BR>
92+
Interface InProcessLink</H2>
93+
<HR>
94+
<DL>
95+
<DT><PRE>public interface <B>InProcessLink</B></DL>
96+
</PRE>
97+
98+
<P>
99+
Represents link used for in-process-tagging. See
100+
<A HREF="../../../../../com/dynatrace/oneagent/sdk/api/OneAgentSDK.html#createInProcessLink()"><CODE>OneAgentSDK.createInProcessLink()</CODE></A> and
101+
<A HREF="../../../../../com/dynatrace/oneagent/sdk/api/OneAgentSDK.html#traceInProcessLink(com.dynatrace.oneagent.sdk.api.InProcessLink)"><CODE>OneAgentSDK.traceInProcessLink(InProcessLink)</CODE></A> for more details.
102+
<P>
103+
104+
<P>
105+
<DL>
106+
<DT><B>Since:</B></DT>
107+
<DD>1.1</DD>
108+
</DL>
109+
<HR>
110+
111+
<P>
112+
113+
<P>
114+
<!-- ========= END OF CLASS DATA ========= -->
115+
<HR>
116+
117+
118+
<!-- ======= START OF BOTTOM NAVBAR ====== -->
119+
<A NAME="navbar_bottom"><!-- --></A>
120+
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
121+
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
122+
<TR>
123+
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
124+
<A NAME="navbar_bottom_firstrow"><!-- --></A>
125+
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
126+
<TR ALIGN="center" VALIGN="top">
127+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
128+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
129+
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
130+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
131+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
132+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
133+
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
134+
</TR>
135+
</TABLE>
136+
</TD>
137+
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
138+
</EM>
139+
</TD>
140+
</TR>
141+
142+
<TR>
143+
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
144+
&nbsp;<A HREF="../../../../../com/dynatrace/oneagent/sdk/api/IncomingTaggable.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>PREV CLASS</B></A>&nbsp;
145+
&nbsp;<A HREF="../../../../../com/dynatrace/oneagent/sdk/api/InProcessLinkTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>NEXT CLASS</B></A></FONT></TD>
146+
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
147+
<A HREF="../../../../../index.html?com/dynatrace/oneagent/sdk/api/InProcessLink.html" target="_top"><B>FRAMES</B></A> &nbsp;
148+
&nbsp;<A HREF="InProcessLink.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
149+
&nbsp;<SCRIPT type="text/javascript">
150+
<!--
151+
if(window==top) {
152+
document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
153+
}
154+
//-->
155+
</SCRIPT>
156+
<NOSCRIPT>
157+
<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
158+
</NOSCRIPT>
159+
160+
161+
</FONT></TD>
162+
</TR>
163+
<TR>
164+
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
165+
SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;METHOD</FONT></TD>
166+
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
167+
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;METHOD</FONT></TD>
168+
</TR>
169+
</TABLE>
170+
<A NAME="skip-navbar_bottom"></A>
171+
<!-- ======== END OF BOTTOM NAVBAR ======= -->
172+
173+
<HR>
174+
175+
</BODY>
176+
</HTML>

0 commit comments

Comments
 (0)