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
Copy file name to clipboardExpand all lines: README.md
+14-14Lines changed: 14 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,16 +17,11 @@ This is the official Java implementation of the [Dynatrace OneAgent SDK](https:/
17
17
- JRE 1.6 or higher
18
18
- Dynatrace OneAgent (required versions see below)
19
19
20
-
|OneAgent SDK for Java|Dynatrace OneAgent Java|
20
+
|OneAgent SDK for Java|Required OneAgent version|
21
21
|:------|:--------|
22
22
|1.1.0 |>=1.143 |
23
23
|1.0.3 |>=1.135 |
24
24
25
-
26
-
## Features
27
-
Dynatrace OneAgent SDK for Java currently implements support for the following features (corresponding to features specified in [Dynatrace OneAgent SDK](https://github.com/Dynatrace/OneAgent-SDK)):
28
-
- outgoing and incoming remote calls
29
-
30
25
## Integrating into your application
31
26
32
27
### Dependencies
@@ -51,12 +46,11 @@ If the SDK can't connect to the OneAgent (see usage of SDKState in samples) or y
51
46
Additionally you should/have to ensure, that you have set a `LoggingCallback`. For usage see class `StdErrLoggingCallback` in `remotecall-server` module (in samples/remotecall folder).
52
47
53
48
54
-
55
-
# API Concepts
49
+
## API Concepts
56
50
57
51
Common concepts of the Dynatrace OneAgent SDK are explained the [Dynatrace OneAgent SDK repository](https://github.com/Dynatrace/OneAgent-SDK).
58
52
59
-
## Get an Api object
53
+
###Get an Api object
60
54
61
55
Use OneAgentSDKFactory.createInstance() to obtain an OneAgentSDK instance. You should reuse this object over the whole application
62
56
and if possible JVM lifetime:
@@ -77,7 +71,7 @@ default:
77
71
78
72
It is good practice to check the SDK state regularly as it may change at every point of time (except PERMANENTLY_INACTIVE never changes over JVM lifetime).
79
73
80
-
## Common concepts: Tracers
74
+
###Common concepts: Tracers
81
75
82
76
To trace any kind of call you first need to create a Tracer. The Tracer object represents the logical and physical endpoint that you want to call. A Tracer serves two purposes. First to time the call (duraction, cpu and more) and report errors. That is why each Tracer has these three methods. The error method must be called only once, and it must be in between start and end.
83
77
@@ -91,7 +85,12 @@ void end();
91
85
The second purpose of a Tracer is to allow tracing across process boundaries. To achieve that these kind of traces supply so called tags. Tags are strings or byte arrays that enable Dynatrace to trace a transaction end to end. As such the tag is the one information that you need to transport across these calls yourselfs.
92
86
93
87
94
-
## Trace incoming and outgoing remote calls
88
+
## Features
89
+
Dynatrace OneAgent SDK for Java currently implements support for the following features (corresponding to features specified in [Dynatrace OneAgent SDK](https://github.com/Dynatrace/OneAgent-SDK)):
90
+
- outgoing and incoming remote calls
91
+
92
+
93
+
### Trace incoming and outgoing remote calls
95
94
96
95
You can use the SDK to trace proprietary IPC communication from one process to the other. This will enable you to see full Service Flow, PurePath and Smartscape topology for remoting technologies that Dynatrace is not aware of.
97
96
@@ -129,7 +128,7 @@ try {
129
128
}
130
129
```
131
130
132
-
##Link in process
131
+
### In process linking
133
132
134
133
You can use the SDK to link inside a single process. To link for eg. an asynchronous execution, you need the following code:
135
134
```Java
@@ -153,13 +152,14 @@ try {
153
152
}
154
153
```
155
154
155
+
## Further readings
156
156
157
157
158
-
## Feedback
158
+
## Help & Support
159
159
160
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!
|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.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)|
0 commit comments