ActiveGate diagnostics

You can run fully automated ActiveGate troubleshooting for Dynatrace SaaS and Managed environments.

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

If ActiveGate can't connect to the Dynatrace environment or doesn't start, you might need to collect diagnostic data locally from the command line. For details, see Collect diagnostic data with agctl.

Requirements

  • 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.

  1. Go to Deployment Status > ActiveGates.

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

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

  4. 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.

  5. 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.

Data collection is in progress. While collecting data, you can:

  • Refresh the page to update the progress.
  • Cancel diagnostic data collection.

Dynatrace has finished collecting diagnostic data. After collecting data, you can:

  • Analyze to submit the collected data to Dynatrace for analysis.
  • Download the collected data locally for your inspection.
  • Delete the issue, including the collected diagnostic data.

Diagnostic data is being transferred to Dynatrace for analysis. While sending data, you can:

  • Refresh the page to update the progress.
  • Download the collected diagnostic data.
  • Delete the issue, including the collected diagnostic data.

Diagnostic data has been transferred to Dynatrace for analysis.

Dynatrace is now analyzing the diagnostic data.
While analyzing data, you can:

  • Refresh the page to update the progress.
  • Download the collected diagnostic data.
  • Delete the issue, including the collected diagnostic data.

The analysis is done. The number of associated alerts is shown in parentheses.
After an analysis, you can:

  • Download the collected diagnostic data.
  • Delete the issue, including the collected diagnostic data.

The diagnostic data is being deleted. While deleting data, you can:

  • Refresh the page to update the progress.

The diagnostic data has been deleted. Dynatrace keeps only a small set of information about who, when, where, and why the diagnostic data was collected.

The diagnostics process was canceled manually before it was finished.

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.

  1. Go to Deployment Status > ActiveGates.

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

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

  4. Select the Advanced options link.

  5. Select and store locally.

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

  6. Select Apply.

  7. 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.

Data collection is in progress. While collecting data, you can:

  • Refresh the page to update the progress.
  • Cancel diagnostic data collection.

Dynatrace has finished collecting diagnostic data. After collecting data, you can:

  • Analyze to submit the collected data to Dynatrace for analysis.
  • Download the collected data locally for your inspection.
  • Delete the issue, including the collected diagnostic data.

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.

Collect diagnostic data with agctl

ActiveGate version 1.275+

In cases where ActiveGate cannot connect to the Dynatrace environment or doesn't start, you might need to collect diagnostic data locally from the command line on the ActiveGate host. To do so, use the agctl command line tool to collect all the necessary data and create a package that can be analyzed later.

Use agctl on Linux or Windows

Use agctl from containerized ActiveGate

You can use agctl to gather diagnostic data from a containerized ActiveGate. To do so, run the following script and provide the --directory=<path> parameter with the path to your tmp folder.

  • 30 days of data is collected by default. To change this, use --days=<days> parameter.
  • Diagnostic data is collected from all modules by default. To change this, use the --modules=<modules-list> parameter with a comma-separated list of modules (for example, --modules=zremote,synthetic).

  1. Decode the encoded file using the appropriate Windows or Linux command.

What to do with the collected data

Now that the data is collected:

  • 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.

We recommend that you delete the file after use.

Contents of diagnostic data

All the collected diagnostic data is compressed into a SupportArchive<ID number> (for agctl - support_archive_<timestamp>) ZIP file that includes the following folders and files:

Folder or file

Description

details.txt (file)

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.

autoupdater (folder)

Contains AutoUpdater service logs and RPM, Synthetic, zRemote installer modules.

install (folder)

Contains ActiveGate installer logs.

zremote (folder)

Contains zRemote, watchdog logs and agent configuration files.

synthetic (folder)

Contains ActiveGate Synthetic monitors configuration files and logs.

remotepluginmodule (folder)

Contains logs for Extensions and agent executing them.

Data privacy

To comply with regional data protection and privacy regulations, Dynatrace 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 Data retention periods.

Troubleshooting

Frequently asked questions

No, you cannot access the S3 directly or use your own.

The diagnostic data is uploaded to the Dynatrace S3 bucket that is configured for the environment/cluster by Dynatrace. The S3 bucket used depends on the location of the environment/cluster.