Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ At the end of the installation, ActiveGate will be:
* Installed and running as a system service
* Listening on port **9999** for Dynatrace communication
* Connected to your Dynatrace SaaS environment
* Verified on **Arm64 (Aarch64)** architecture
* Verified on **Arm64 (`aarch64`)** architecture

## Verify OneAgent installation

Expand Down Expand Up @@ -51,11 +51,12 @@ This is your Dynatrace SaaS environment URL.

## Navigate to the ActiveGate deployment page

From the Dynatrace dashboard:
From the Dynatrace main dashboard:

- Select Deployment status
- Choose ActiveGate
- Install ActiveGate
* Select **Search** on the upper left and search for **Deployment**.
* Select **Deployment status**.
* Choose **ActiveGate**.
* Select **Install ActiveGate**.

![Dynatrace deployment status page showing no ActiveGate detected alt-txt#center](images/activegate1.png "Dynatrace ActiveGate not yet installed")

Expand All @@ -65,8 +66,9 @@ Dynatrace will generate an installation command specifically for your environmen

On the installer configuration page:

- Platform → Linux
- Architecture → ARM64
* Platform -> Linux
* Architecture -> ARM64
* Select **Generate token** to create an authentication token

![Dynatrace Install ActiveGate page showing deployment type Linux and architecture ARM selection alt-txt#center](images/activegate-install.png "Dynatrace ActiveGate installation configuration")

Expand Down Expand Up @@ -95,24 +97,29 @@ wget -O Dynatrace-ActiveGate-Linux-arm.sh \
**Verify signature:**

```console
wget https://ca.dynatrace.com/dt-root.cert.pem ; ( echo 'Content-Type: multipart/signed; protocol="application/x-pkcs7-signature"; micalg="sha-256"; boundary="--SIGNED-INSTALLER"'; echo ; echo ; echo '----SIGNED-INSTALLER' ; cat Dynatrace-ActiveGate-Linux-arm64-1.331.24.20260210-044521.sh ) | openssl cms -verify -CAfile dt-root.cert.pem > /dev/null
wget https://ca.dynatrace.com/dt-root.cert.pem
( echo 'Content-Type: multipart/signed; protocol="application/x-pkcs7-signature"; micalg="sha-256"; boundary="--SIGNED-INSTALLER"'; echo; echo; echo '----SIGNED-INSTALLER'; cat Dynatrace-ActiveGate-Linux-arm.sh ) | openssl cms -verify -CAfile dt-root.cert.pem > /dev/null
```

![Dynatrace ActiveGate installer command for Linux ARM64 environment alt-txt#center](images/activegate-installation-commands.png "Dynatrace ActiveGate installer command")

**Install ActiveGate as the privileged user:**

Copy the command under "Install ActiveGate as the privileged user" from your dashboard and prepend "sudo " to it to launch the install:

```console
sudo /bin/bash Dynatrace-ActiveGate-Linux-arm64-1.331.24.20260210-044521.sh
sudo /bin/bash Dynatrace-ActiveGate-Linux-arm.sh
```

The installer automatically performs the following tasks:

- Downloads ActiveGate components
- Installs the ActiveGate service
- Configures communication with Dynatrace SaaS
- Starts the ActiveGate service
* Downloads ActiveGate components
* Installs the ActiveGate service
* Configures communication with Dynatrace SaaS
* Starts the ActiveGate service

The output is similar to:

The output is similar to:
```output
2026-03-12 05:59:21 UTC Starting Dynatrace ActiveGate AutoUpdater...
2026-03-12 05:59:21 UTC Checking if Dynatrace ActiveGate AutoUpdater is running ...
Expand All @@ -133,12 +140,14 @@ sudo systemctl status dynatracegateway
```

The output is similar to:

```output
● dynatracegateway.service - Dynatrace ActiveGate service
Loaded: loaded (/etc/systemd/system/dynatracegateway.service; enabled; preset: enabled)
Active: active (running) since Thu 2026-03-12 05:59:07 UTC; 1min 7s ago
Process: 20280 ExecStart=/opt/dynatrace/gateway/dynatracegateway start (code=exited, status=0/SUCCESS)
```

This confirms that ActiveGate started successfully.

## Verify the ActiveGate communication port
Expand All @@ -152,6 +161,7 @@ sudo ss -tulnp | grep 9999
```

The output is similar to:

```console
tcp LISTEN 0 50 *:9999 *:* users:(("java",pid=20319,fd=403))
```
Expand All @@ -168,17 +178,17 @@ Deployment Status → ActiveGates

You should see your ActiveGate instance listed with:

- Host name
- Version
- Status: Connected
* Host name
* Version
* Status: Connected

![Dynatrace Deployment Status page showing ActiveGate instance connected and running alt-txt#center](images/activegate-ui.png "Dynatrace ActiveGate deployment status")

![Dynatrace ActiveGate details page displaying modules architecture and configuration alt-txt#center](images/activegate-details.png "Dynatrace ActiveGate details view")

## Test application monitoring with Nginx

To validate that Dynatrace is collecting monitoring data correctly, deploy a simple web server on the virtual machine. Dynatrace OneAgent will automatically detect and monitor the process.
To validate that Dynatrace is collecting monitoring data correctly, deploy a simple web server on the virtual machine. Dynatrace OneAgent automatically detects and monitors the process.

### Install Nginx

Expand All @@ -188,7 +198,8 @@ Update the package index and install the Nginx web server.
sudo apt update
sudo apt install -y nginx
```
## Check the Nginx service status.

## Check the Nginx service status

```console
sudo systemctl status nginx
Expand Down Expand Up @@ -218,20 +229,22 @@ Processes

You should see a process similar to:

- nginx
- Dynatrace automatically begins collecting metrics such as:
- CPU usage
- memory consumption
- network activity
- request throughput
* `nginx`

Dynatrace automatically begins collecting metrics such as:

* CPU usage
* memory consumption
* network activity
* request throughput

![Dynatrace Infrastructure Explorer showing NGINX process monitoring on an ARM64 host alt-txt#center](images/nginx-monitoring.png "Dynatrace NGINX process monitoring dashboard")

## What you've accomplished
## What you've accomplished

You've successfully installed Dynatrace ActiveGate on your Azure Ubuntu Arm64 virtual machine. Your environment now includes:

- Dynatrace OneAgent performing host monitoring
- ActiveGate routing monitors traffic securely
- Communication with Dynatrace SaaS through port 9999
- Full compatibility with Arm64-based Cobalt 100 processors
* Dynatrace OneAgent performing host monitoring
* ActiveGate routing monitoring traffic securely
* Communication with Dynatrace SaaS through port 9999
* Full compatibility with Arm64-based Cobalt 100 processors
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Dynatrace automatically maps dependencies between services, hosts, containers, a

There are three main components of Dynatrace:

- **Dynatrace OneAgent:** a lightweight monitoring agent installed on hosts that automatically collects metrics, logs, and traces from applications and infrastructure. Learn more in the [Dynatrace OneAgent documentation](https://docs.dynatrace.com/docs/ingest-from/dynatrace-oneagent).
- **Dynatrace OneAgent:** a lightweight monitoring agent installed on hosts that automatically collects metrics, logs, and traces from applications and infrastructure. Learn more in the [Dynatrace OneAgent documentation](https://docs.dynatrace.com/docs/ingest-from/dynatrace-oneagent).

- **Dynatrace ActiveGate:** a secure gateway component that routes monitoring traffic, enables cloud integrations, and provides additional monitoring capabilities such as Kubernetes monitoring and synthetic monitoring. Learn more in the [Dynatrace ActiveGate documentation](https://docs.dynatrace.com/docs/ingest-from/dynatrace-activegate).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ layout: learningpathall

To allow external traffic on port **9999** for Dynatrace ActiveGate running on an Azure virtual machine, open the port in the Network Security Group (NSG) attached to the virtual machine's network interface or subnet.

{{% notice Note %}} For more information about Azure setup, see [Getting started with Microsoft Azure Platform](/learning-paths/servers-and-cloud-computing/csp/azure/).{{% /notice %}}
{{% notice Note %}}For more information about Azure setup, see [Getting started with Microsoft Azure Platform](/learning-paths/servers-and-cloud-computing/csp/azure/).{{% /notice %}}

## Create a firewall rule in Azure

Expand All @@ -36,8 +36,7 @@ Configure it using the following details:
- **Destination port ranges:** **9999**
- **Protocol:** TCP
- **Action:** Allow
- **Priority:** 1000
- **Name:** dynatrace-activegate
- **Name:** allow-tcp-9999

After filling in the details, select **Add** to save the rule.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ While the steps to create this instance are included here for convenience, you c

## Create an Arm-based Azure virtual machine

Creating a virtual machine based on Azure Cobalt 100 is no different to creating any other virtual machine in Azure. To create an Azure virtual machine:
Creating a virtual machine based on Azure Cobalt 100 is no different from creating any other virtual machine in Azure. To create an Azure virtual machine:

- Launch the Azure portal and navigate to **Virtual Machines**.
- Select **Create**, and select **Virtual Machine** from the drop-down list.
Expand Down Expand Up @@ -63,7 +63,7 @@ Your virtual machine should be ready and running in a few minutes. You can SSH i

![Azure Portal showing successful VM deployment with green checkmark, VM name, resource group, and public IP address displayed in the confirmation notification alt-txt#center](images/final-vm.png "Successful VM deployment confirmation")

{{% notice Note %}}To learn more about Arm-based virtual machine in Azure, see Getting Started with Microsoft Azure in [Get started with Arm-based cloud instances](/learning-paths/servers-and-cloud-computing/csp/azure).{{% /notice %}}
{{% notice Note %}}To learn more about Arm-based virtual machines in Azure, see "Getting Started with Microsoft Azure" in [Get started with Arm-based cloud instances](/learning-paths/servers-and-cloud-computing/csp/azure/).{{% /notice %}}

## What you've accomplished and what's next

Expand Down
Loading
Loading