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: docs/framework-dynatrace_one_agent.md
+25-3Lines changed: 25 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
# Dynatrace SaaS/Managed OneAgent Framework
2
2
[Dynatrace SaaS/Managed](http://www.dynatrace.com/cloud-foundry/) is your full stack monitoring solution - powered by artificial intelligence. Dynatrace SaaS/Managed allows you insights into all application requests from the users click in the browser down to the database statement and code-level.
3
3
4
-
The Dynatrace SaaS/Managed OneAgent Framework causes an application to be automatically configured to work with a bound [Dynatrace SaaS/Managed Service][] instance (Free trials available).
4
+
The Java buildpack uses the [libbuildpack-dynatrace](https://github.com/Dynatrace/libbuildpack-dynatrace) library to automatically configure applications to work with a bound [Dynatrace SaaS/Managed Service][] instance (Free trials available).
5
5
6
6
<table>
7
7
<tr>
@@ -18,6 +18,16 @@ The Dynatrace SaaS/Managed OneAgent Framework causes an application to be automa
18
18
</table>
19
19
Tags are printed to standard output by the buildpack detect script
20
20
21
+
## Implementation
22
+
This buildpack integrates with Dynatrace using the [libbuildpack-dynatrace](https://github.com/Dynatrace/libbuildpack-dynatrace) hook library (v1.8.0). This is the same integration library used by all modern Cloud Foundry buildpacks (Go, Node.js, Python, PHP, etc.), ensuring consistent behavior across the platform.
23
+
24
+
The integration:
25
+
- Downloads and installs the Dynatrace OneAgent using the official PaaS installer
26
+
- Configures `LD_PRELOAD` to inject the agent into the Java process
27
+
- Fetches and merges the latest agent configuration from the Dynatrace API
28
+
- Supports FIPS mode, network zones, and additional technologies
29
+
- Provides retry logic and error handling for robust deployments
30
+
21
31
## User-Provided Service
22
32
Users must provide their own Dynatrace SaaS/Managed service. A user-provided Dynatrace SaaS/Managed service must have a name or tag with `dynatrace` in it so that the Dynatrace Saas/Managed OneAgent Framework will automatically configure the application to work with the service.
23
33
@@ -31,13 +41,25 @@ The credential payload of the service may contain the following entries:
31
41
| `networkzone` | (Optional) Network zones are Dynatrace entities that represent your network structure. They help you to route the traffic efficiently, avoiding unnecessary traffic across data centers and network regions. Enter the network zone you wish to pass to the server during the OneAgent Download.
32
42
| `skiperrors` | (Optional) The errors during agent download are skipped and the injection is disabled. Use this option at your own risk. Possible values are 'true' and 'false'. This option is disabled by default!
33
43
| `enablefips`| (Optional) Enables the use of [FIPS 140 cryptographic algorithms](https://docs.dynatrace.com/docs/shortlink/oneagentctl#fips-140). Possible values are 'true' and 'false'. This option is disabled by default!
34
-
| addtechnologies | (Optional) Adds additional OneAgent code-modules via a comma-separated list. See [supported values](https://docs.dynatrace.com/docs/dynatrace-api/environment-api/deployment/oneagent/download-oneagent-version#parameters) in the "included" row|
44
+
|`addtechnologies`| (Optional) Adds additional OneAgent code-modules via a comma-separated list. See [supported values](https://docs.dynatrace.com/docs/dynatrace-api/environment-api/deployment/oneagent/download-oneagent-version#parameters) in the "included" row|
45
+
|`customoneagenturl`| (Optional) Custom download URL for OneAgent. If set, `apiurl`, `environmentid`, and `apitoken` are not required.|
For general information on configuring the buildpack, including how to specify configuration values through environment variables, refer to [Configuration and Extension][].
38
56
39
57
## Support
40
-
This buildpack extension is currently Beta. If you have any questions or problems regarding the build pack itself please don't hesitate to contact Dynatrace on https://answers.ruxit.com/, be sure to use "cloudfoundry" as a topic.
58
+
For questions about the buildpack integration, please open an issue on the [java-buildpack GitHub repository](https://github.com/cloudfoundry/java-buildpack).
59
+
60
+
For questions about Dynatrace itself, visit [Dynatrace support](https://support.dynatrace.com/).
61
+
62
+
For technical details about the integration library, see [libbuildpack-dynatrace](https://github.com/Dynatrace/libbuildpack-dynatrace).
41
63
42
64
[Configuration and Extension]: ../README.md#configuration-and-extension
0 commit comments