You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -430,6 +433,29 @@ public void onMessage(Message message) {
430
433
}
431
434
}
432
435
```
436
+
<aname="databaseRequest" />
437
+
438
+
### Trace SQL database requests
439
+
440
+
A SQL database request is traced by calling `traceSqlDatabaseRequest`. For details about usage see the [OneAgentSDK specification](https://github.com/Dynatrace/OneAgent-SDK#database)
441
+
442
+
```java
443
+
String sql ="SELECT * FROM transformationdata WHERE transformation_id = "+ id;
|1.7.0 |Added support for database requests |[binary](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.7.0/oneagent-sdk-1.7.0.jar)[source](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.7.0/oneagent-sdk-1.7.0-sources.jar)[javadoc](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.7.0/oneagent-sdk-1.7.0-javadoc.jar)|
473
500
|1.6.0 |Added support for messaging |[binary](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.6.0/oneagent-sdk-1.6.0.jar)[source](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.6.0/oneagent-sdk-1.6.0-sources.jar)[javadoc](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.6.0/oneagent-sdk-1.6.0-javadoc.jar)|
474
501
|1.4.0 |Added support for outgoing webrequests |[binary](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.4.0/oneagent-sdk-1.4.0.jar)[source](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.4.0/oneagent-sdk-1.4.0-sources.jar)[javadoc](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.4.0/oneagent-sdk-1.4.0-javadoc.jar)|
475
502
|1.3.0 |Added support for incoming webrequests |[binary](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.3.0/oneagent-sdk-1.3.0.jar)[source](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.3.0/oneagent-sdk-1.3.0-sources.jar)[javadoc](https://search.maven.org/remotecontent?filepath=com/dynatrace/oneagent/sdk/java/oneagent-sdk/1.3.0/oneagent-sdk-1.3.0-javadoc.jar)|
<TDNOWRAP><FONTCLASS="FrameItemFont"><AHREF="com/dynatrace/oneagent/sdk/api/enums/ChannelType.html" title="enum in com.dynatrace.oneagent.sdk.api.enums" target="classFrame">ChannelType</A>
25
25
<BR>
26
+
<AHREF="com/dynatrace/oneagent/sdk/api/infos/DatabaseInfo.html" title="interface in com.dynatrace.oneagent.sdk.api.infos" target="classFrame"><I>DatabaseInfo</I></A>
27
+
<BR>
28
+
<AHREF="com/dynatrace/oneagent/sdk/api/DatabaseRequestTracer.html" title="interface in com.dynatrace.oneagent.sdk.api" target="classFrame"><I>DatabaseRequestTracer</I></A>
29
+
<BR>
30
+
<AHREF="com/dynatrace/oneagent/sdk/api/enums/DatabaseVendor.html" title="enum in com.dynatrace.oneagent.sdk.api.enums" target="classFrame">DatabaseVendor</A>
31
+
<BR>
26
32
<AHREF="com/dynatrace/oneagent/sdk/api/IncomingMessageProcessTracer.html" title="interface in com.dynatrace.oneagent.sdk.api" target="classFrame"><I>IncomingMessageProcessTracer</I></A>
27
33
<BR>
28
34
<AHREF="com/dynatrace/oneagent/sdk/api/IncomingMessageReceiveTracer.html" title="interface in com.dynatrace.oneagent.sdk.api" target="classFrame"><I>IncomingMessageReceiveTracer</I></A>
<TDNOWRAP><FONTCLASS="FrameItemFont"><AHREF="com/dynatrace/oneagent/sdk/api/enums/ChannelType.html" title="enum in com.dynatrace.oneagent.sdk.api.enums">ChannelType</A>
25
25
<BR>
26
+
<AHREF="com/dynatrace/oneagent/sdk/api/infos/DatabaseInfo.html" title="interface in com.dynatrace.oneagent.sdk.api.infos"><I>DatabaseInfo</I></A>
27
+
<BR>
28
+
<AHREF="com/dynatrace/oneagent/sdk/api/DatabaseRequestTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><I>DatabaseRequestTracer</I></A>
29
+
<BR>
30
+
<AHREF="com/dynatrace/oneagent/sdk/api/enums/DatabaseVendor.html" title="enum in com.dynatrace.oneagent.sdk.api.enums">DatabaseVendor</A>
31
+
<BR>
26
32
<AHREF="com/dynatrace/oneagent/sdk/api/IncomingMessageProcessTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><I>IncomingMessageProcessTracer</I></A>
27
33
<BR>
28
34
<AHREF="com/dynatrace/oneagent/sdk/api/IncomingMessageReceiveTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><I>IncomingMessageReceiveTracer</I></A>
<AHREF="../../../../../com/dynatrace/oneagent/sdk/api/InProcessLinkTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>PREV CLASS</B></A>
58
-
<AHREF="../../../../../com/dynatrace/oneagent/sdk/api/LoggingCallback.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>NEXT CLASS</B></A></FONT></TD>
57
+
PREV CLASS
58
+
<AHREF="../../../../../com/dynatrace/oneagent/sdk/api/IncomingMessageProcessTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>NEXT CLASS</B></A></FONT></TD>
<DT><B>All Known Subinterfaces:</B><DD><AHREF="../../../../../com/dynatrace/oneagent/sdk/api/IncomingMessageReceiveTracer.html" title="interface in com.dynatrace.oneagent.sdk.api">IncomingMessageReceiveTracer</A></DD>
94
+
<DT><B>All Superinterfaces:</B><DD><AHREF="../../../../../com/dynatrace/oneagent/sdk/api/Tracer.html" title="interface in com.dynatrace.oneagent.sdk.api">Tracer</A></DD>
95
95
</DL>
96
96
<HR>
97
97
<DL>
98
-
<DT><PRE>public interface <B>Joinable</B></DL>
98
+
<DT><PRE>public interface <B>DatabaseRequestTracer</B><DT>extends <AHREF="../../../../../com/dynatrace/oneagent/sdk/api/Tracer.html" title="interface in com.dynatrace.oneagent.sdk.api">Tracer</A></DL>
99
99
</PRE>
100
100
101
101
<P>
102
-
Common interface for Tracers able to allow incoming tags after they have been started. Not to be
Same as <AHREF="../../../../../com/dynatrace/oneagent/sdk/api/Joinable.html#addJoiningDynatraceStringTag(java.lang.String)"><CODE>addJoiningDynatraceStringTag(String)</CODE></A>, but tag is provided in binary
130
-
format.</TD>
129
+
Adds optional information about retrieved rows of the traced database request.</TD>
<THALIGN="left"><B>Methods inherited from interface com.dynatrace.oneagent.sdk.api.<AHREF="../../../../../com/dynatrace/oneagent/sdk/api/Tracer.html" title="interface in com.dynatrace.oneagent.sdk.api">Tracer</A></B></TH>
<DD>Adds a joining tag from another trace using the string format.
160
-
161
-
An application can call this function to add a joining tag when this tracer
162
-
has already been started.
163
-
164
-
<p>
165
-
This function can only be used after the tracer was started.
167
+
<DD>Adds optional information about retrieved rows of the traced database request.
166
168
<P>
167
169
<DD><DL>
168
-
<DT><B>Parameters:</B><DD><CODE>tag</CODE> - if null or an empty string, call will be ignored.</DL>
170
+
</DL>
171
+
</DD>
172
+
<DD><DL>
173
+
<DT><B>Parameters:</B><DD><CODE>returnedRowCount</CODE> - number of rows returned by this traced database request. Only positive values are allowed.<DT><B>Since:</B></DT>
<DD>Same as <AHREF="../../../../../com/dynatrace/oneagent/sdk/api/Joinable.html#addJoiningDynatraceStringTag(java.lang.String)"><CODE>addJoiningDynatraceStringTag(String)</CODE></A>, but tag is provided in binary
179
-
format.
185
+
<DD>Adds optional information about round-trip count to database server.
180
186
<P>
181
187
<DD><DL>
182
-
<DT><B>Parameters:</B><DD><CODE>tag</CODE> - if null or an empty array, call will be ignored.</DL>
188
+
</DL>
189
+
</DD>
190
+
<DD><DL>
191
+
<DT><B>Parameters:</B><DD><CODE>roundTripCount</CODE> - count of round-trips that took place. Only positive values are allowed.<DT><B>Since:</B></DT>
<AHREF="../../../../../com/dynatrace/oneagent/sdk/api/InProcessLinkTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>PREV CLASS</B></A>
216
-
<AHREF="../../../../../com/dynatrace/oneagent/sdk/api/LoggingCallback.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>NEXT CLASS</B></A></FONT></TD>
226
+
PREV CLASS
227
+
<AHREF="../../../../../com/dynatrace/oneagent/sdk/api/IncomingMessageProcessTracer.html" title="interface in com.dynatrace.oneagent.sdk.api"><B>NEXT CLASS</B></A></FONT></TD>
0 commit comments