Diagnostic archives for Dynatrace Managed installations

When you run Dynatrace Managed cluster diagnostics, you have two analysis options:

• Analyze automatically: Dynatrace Managed gathers cluster diagnostics data and submits it automatically to Dynatrace so that Dynatrace product experts can use the data to analyze your support ticket quickly and efficiently.
• Collect and review locally: Dynatrace Managed gathers cluster diagnostics data, at which point you can analyze the data yourself and optionally attach it to a support ticket for review by Dynatrace product experts.

Analyze automatically

By default, Dynatrace collects diagnostics data for a cluster and immediately analyzes it.

1. On the Dynatrace Managed Home page, select More (…) > Run Cluster diagnostics.

   Example menu selection

   

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

   Example cluster diagnostics page

   

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

4. 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 cluster nodes and ActiveGates
• Stores the collected diagnostic data
• Uploads the diagnostic data to Mission Control regional storage for further analysis

The State column describes the current phase of the process.

Review the Dynatrace analysis

When the analysis is complete, Dynatrace sends the results back to your cluster. 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 a host or process locally. Use this option if you prefer to collect and review the data before manually submitting it to Dynatrace for analysis.

1. On the Dynatrace Managed Home page, select More (…) > Run Cluster diagnostics.

   Example menu selection

   

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

   Example cluster diagnostics page

   

3. Select the Advanced options link.

4. Select and store locally.

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

5. Select Apply.

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

What happens next

Dynatrace now:

• Collects diagnostic data for the last 7 days (if you didn't change the default) of the affected cluster nodes and ActiveGates
• Stores the collected diagnostic data

The State column describes the current phase of the process.

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.

Cluster diagnostics overview

For an overview of all cluster troubleshooting runs in your environment

1. On the Dynatrace Managed Home page, select More (…) > Run Cluster diagnostics.
2. The Run Cluster diagnostics page lists all diagnostics activity in your cluster.
   • Expand any entry to see details.
   • If the data has not been deleted (all diagnostic data is deleted automatically after 30 days), you can download it or delete it.

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:

• COLLECTOR (ActiveGates)
  Contains a list of all ActiveGates for the cluster. Diagnostics data is located in a separate folder for each ActiveGate. The ActiveGate folders are named after the ActiveGate UUID. Each ActiveGate folder contains the following subfolders:

  Folder	Description
  autoupdater	Contains logs from the auto-update process.
  config	Contains a snapshot of the ActiveGate configuration directory.
  debugui	Contains a snapshot of the internal environment configuration related to the ActiveGate.
  install	Contains ActiveGate installation logs.
  log	Contains a snapshot of the ActiveGate log directory).

• SERVER (nodes)
  Contains a list of all nodes in the cluster. Diagnostics data is located in a separate folder for node. The node folders are named after the unique node number. Each node folder contains the following subfolders:

  Folder	Description
  autoupdater	Contains logs from the auto-update process.
  config	Contains configuration files of cluster nodes components.
  log	Contains log files including audit logs of a server process.
  managed-logs	Contains log files of other cluster node components grouped in a separate folders.
  nginx-error-logs	Contains error logs from the NGINX server.

• download details.txt (TXT)
  Contains information and statistics about the diagnostic archive including file count and size for each folder.

Data privacy

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

• Masks some personal data (for example, 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:

• Personal data captured by Dynatrace
• Data retention periods

Troubleshooting