Dynatrace Observability for UAC - Implementation Guide
- 1 Disclaimer
- 2 Version Information
- 3 Overview
- 3.1 Components
- 4 Requirements
- 5 Changelog
Disclaimer
Your use of this download is governed by Stonebranch’s Terms of Use. Currently not released in the Dynatrace Hub. For more information, please contact us.
Version Information
Solution Name | Dynatrace - Application Name | Version | Status |
|---|---|---|---|
Observability for UAC with Dynatrace | Dynatrace Extension | 1 (Current 1.0.0) | Initial Version |
Refer to Changelog for version history information.
Overview
The Dynatrace Extension for the Universal Controller enables Dynatrace users to scrape the metrics located on the Universal Controller using Dynatrace’s ActiveGate. Additionally, traces and logs will be ingested by the Dynatrace OneAgent, using the new http/protobuf protocol available in UAC 7.9.
This guide provides step-by-step instructions for Dynatrace users on how to configure and manage the Observability data from the UAC.
Components
Component | Description |
|---|---|
Dynatrace ActiveGate acts as a secure proxy between Dynatrace OneAgents and Dynatrace Clusters or between Dynatrace OneAgents and other ActiveGates. | |
OneAgent is responsible for collecting all monitoring data within your monitored environment. | |
Dynatrace Extension | Dynatrace Extension developed for connecting to the Universal Controller. |
Requirements
This solution requires following components:
Universal Agent 7.9.0.0 or higher
Universal Controller 7.9.0.0 or higher
Dynatrace ActiveGate
Dynatrace OneAgent
Dynatrace Environment
Universal Controller metrics - Enabling scraping of the Universal Controller
Downloading the Universal Controller Extension
In the Dynatrace Environment, go to the Dynatrace Hub.
Type “Stonebranch” in the search.
Add the Extension to your environment.
Configuring the Extension
After adding the Extension to your environment, click “Stonebranch”.
Click “Add monitoring configuration”.
Now choose the host in which the Universal Controller is located, or if using Dynatrace ActiveGate, choose the ActiveGate Group in the “Monitor remotely” tab.
Under the Prometheus tab, add your Universal Controller Metric Endpoint. The endpoint is only accessible by a User with the ops.admin role.
(default: http://localhost:8080/uc/resources/metrics)
In the final tab, configure which metrics should be scraped by the Dynatrace Extension.
After waiting for a few minutes, the monitoring configuration will reach the “Ok” status, and metrics will be ingested into the Dynatrace environment.
Ingest Universal Agent traces
To ingest Universal Agent traces, the Dynatrace OneAgent needs to be present on all machines together with the components that are meant to be ingested.
In a host's terminal, use the following command to get the OneAgent endpoint for metric ingestion:
oneagentctl --get-extensions-ingest-port. (default: 14499)Edit the Universal Agent’s
uags.confandomss.conf.
Inside both config files, add the following options:
Option | Description |
|---|---|
| The service name applied to traces. |
| OTLP Protocol to be used when sending traces. Dynatrace OneAgent only allows for |
| Enables the Universal Agent to send traces to the specified trace endpoint. |
| Specifies the trace ingestion endpoint; this is the Dynatrace OneAgent endpoint. |
After changing the config files, restart the Universal Agent. Traces will now be ingested through the Dynatrace OneAgent.
Ingestion Universal Controller and Universal Agent Logs
If the Dynatrace OneAgent is available on the same system as a UAC Component, logs will be ingested automatically. This is done by the automatic Log ingestion from the Dynatrace OneAgent.
Sample Dashboard based on metrics from the Universal Controller
The Dynatrace Extension provides a dashboard with essential information once configured in your Dynatrace environment. Below is a screenshot of the included dashboard.
Trace information inside of the Dynatrace Environment
Using the trace id available inside of the trace’s information, it is possible to correlate traces and logs.
Changelog
Dynatrace Extension - Universal Automation Center 1.0.0 (2025-10-2)
Initial Version