ActiveGate diagnostics

You can run fully automated ActiveGate troubleshooting for Dynatrace SaaS and Managed environments starting with Dynatrace version 1.224 and ActiveGate version 1.223.

The workflow enables you to:

  • Automatically pinpoint an ActiveGate-related issue in highly dynamic environments, at a specific point in time
  • Easily collect the diagnostic data for a specific entity, and automatically get potential solutions for detected anomalies
  • Quickly resolve common issues on your own, reducing the amount of time spent on diagnosing
  • Directly provide Dynatrace Support all the details they need to diagnose the issue

Requirements

  • Dynatrace version 1.224+
  • Dynatrace ActiveGate version 1.223+
  • View sensitive request data environment permission
  • For an ActiveGate configured for multi-environment support, you can run ActiveGate diagnostics only on the main environment, as defined in the ActiveGate configuration.

Analyze automatically

This procedure describes the default procedure: Dynatrace collects diagnostics data for an ActiveGate and immediately analyzes it.

If you prefer to collect and review the data before manually submitting it to Dynatrace for analysis, see Collect and review locally.

In the Dynatrace menu, go to Deployment status > ActiveGates

Expand the ActiveGate entry you want to troubleshoot and select Run ActiveGate diagnostics.

On the Run Dynatrace ActiveGate diagnostics page, briefly describe what isn’t working as expected from your point of view.

optional By default, 7 days of data is collected for analysis. If you need more data, select the Advanced options link, change the number of days, and select Apply.

Select Start analysis.

What happens next

Dynatrace does the following:

  • Collects diagnostic data for the last 7 days (if you didn't change the default) of the affected ActiveGate
  • Stores the collected diagnostic data
  • Uploads the diagnostic data to an S3 bucket in the AWS region of your environment for further analysis

The State column describes the current phase of the process.

State does not automatically refresh. Select Refresh to check for a state change.

Review the Dynatrace analysis

When the analysis is complete, Dynatrace sends the results back to your environment. If a potential solution is identified, Dynatrace lists it in the Alerts section.

Collect and review locally

This procedure describes how to collect diagnostics data for the ActiveGate. Use this option if you prefer to collect and review the data before manually submitting it to Dynatrace for analysis.

If you instead want to collect data and submit it to Dynatrace automatically for analysis, see Analyze automatically.

In the Dynatrace menu, go to Deployment status > ActiveGates

Expand the ActiveGate entry you want to troubleshoot and select Run ActiveGate diagnostics.

On the Run Dynatrace ActiveGate diagnostics page, briefly describe what isn’t working as expected from your point of view.

Select the Advanced options link.

Select and store locally.

  • While you are here, you can also change the number of days of data to collect (default = 7 days).

Select Apply.

Select Start collection to collect diagnostic data and store it locally.

What happens next

Dynatrace now:

  • Collects diagnostic data for the last 24 hours (if you didn't change the default) of the affected ActiveGate
  • Stores the collected diagnostic data

The State column describes the current phase of the process.

State does not automatically refresh. Select Refresh to check for a state change.

What to do with the collected data

Now that the data is collected, you can:

  • Download the collected data.
    • You can review the data. See Contents of diagnostic data for an overview of what's in the download.
    • You can add the data to your support ticket.
  • Analyze the data.
  • Delete the issue, including the collected diagnostic data.

ActiveGate diagnostics in Dynatrace Managed air-gapped environments

In a Dynatrace Managed air-gapped environment:

  1. Use the Store locally option under Advanced options as described above.
  2. After diagnostic data is collected, you can add the data to your support ticket.
  3. Dynatrace can then fetch the diagnostic data from your support ticket, analyze it, and provide automated feedback to Dynatrace Support about detected anomalies.

Stringent data privacy protections are enforced and logged throughout this process.

Contents of diagnostic data

All the collected diagnostic data is compressed into a SupportArchive<ID number> ZIP file that includes the following folders and files:

Folder or file Description

details.txt (folder)

Contains general information on when and where the diagnostic data was collected and archive statistics.

config (folder)

Contains a snapshot of the ActiveGate configuration directory.

debugui (folder)

Contains a snapshot of the internal environment configuration related to the ActiveGate.

log (folder)

Contains a snapshot of the ActiveGate log directory).

Data privacy

To comply with regional data protection and privacy regulations, Dynatrace does the following:

  • Masks some personal data (such as IBANs and URI credentials) automatically before storing it.
  • Automatically deletes all diagnostic data 30 days after its collection. This applies to the data in your Dynatrace environment and on the Dynatrace Cluster.

You can choose to delete collected diagnostic data earlier. To ensure transparency, Dynatrace keeps only a small set of information about who, when, where, and why the diagnostic data was collected.

For related details on Dynatrace data privacy, see:

Troubleshooting

FAQ