Dynatrace quick start guide

To start using Dynatrace, just create a free trial account, install OneAgent on a host, and see how Dynatrace immediately shows you the health and performance of that host.

To learn more about Dynatrace before trying it out, see What is Dynatrace?

Step 1

Create your Dynatrace account

Step 2

Deploy Dynatrace

Step 3

Monitor your host and its processes

Step 4

Set up a problem notification

Step 5

Create your first dashboard

Step 6

Check further resources

Step 1 Create your Dynatrace account

To create a free trial Dynatrace account

  1. Go to dynatrace.com and select Free trial.
  2. Enter your business email address and select Start free trial.
  3. Provide some contact information, select your region, and agree to the terms and conditions.
  4. Welcome to Dynatrace!

Step 2 Deploy Dynatrace

To download and install Dynatrace OneAgent on a host

  1. In Dynatrace Hub, select OneAgent.

  2. Select Set up.

  3. Select the type of machine you're going to monitor.

    Download Dynatrace OneAgent

  4. Follow the on-screen instructions for getting and installing OneAgent.

    • Windows: Just select Download OneAgent installer—no additional parameters are needed. When the download is finished, copy the installer to the target Windows machine and run it.

    • Other platforms: Select the platform type and follow the instructions on the download page. It will show you the exact commands for installing OneAgent. Copy the command and run it on the target machine to install the agent.

    So many ways to deploy Dynatrace!

    These links will take you to all the details you'll eventually need to monitor different platforms. And we haven't even touched on the many ways you can extend Dynatrace. If you're just taking the beginner's tour of Dynatrace, however, maybe now is not the time to go down these rabbit holes.

  5. The installer will tell you that Dynatrace OneAgent has successfully connected to a Dynatrace cluster node and display a congratulations message.

    If your network doesn't allow SSL communication with the Dynatrace cluster, you need to adjust your network setup to allow transmission of your monitoring data to your Dynatrace SaaS environment.

    We recommend that you install an Environment ActiveGate and then install OneAgent. Environment ActiveGate works as a proxy between Dynatrace OneAgent and the Dynatrace cluster. You'll need it if you're going to monitor a large number of hosts.

  6. After you install OneAgent, restart the processes you want to monitor (or restart the machine).

  7. Go to Deployment Status to verify the deployment.
    You installed a single OneAgent, so you should see one host listed on the OneAgents tab.

    Deployment status: OneAgents

  8. Select the host name (we called it MyHostName in the example above) to see what Dynatrace already knows about that host.

Step 3 Monitor your host and its processes

When you select the host name, Dynatrace shows you what it already knows about your host.

The following are just a few of the things you can find on the host overview page.

Properties and tags

Select Properties and tags on the notifications bar to display the Properties and tags panel, which displays metadata about the selected host:

  • Tags lists tags currently applied to the host. Select Add Tag to add a tag to the host metadata.
  • Properties lists various host properties, such as OneAgent version, OS version, monitoring mode, IP addresses, and management zones.

Problems

  • On the notifications bar, Problems indicates active and closed problems related to the selected host.
  • Select Problems on the notifications bar to display the Problems panel, which lists the problems.
    • Select a problem to display details.
    • Select Go to problems to go to the Problems page filtered by the selected host.

Vulnerabilities

  • On the notifications bar, Vulnerabilities indicates the top detected vulnerabilities affecting the selected host.

  • Select Vulnerabilities on the notifications bar to display the Vulnerabilities panel, which lists the most severe third-party vulnerabilities and code-level vulnerabilities related to this host.

    • Select a vulnerability in the list to view the details and understand the severity and impact of a vulnerability within your environment.
    • For a complete list of the detected vulnerabilities affecting this host, select Show all third-party vulnerabilities/Show all code-level vulnerabilities.

    Example third-party vulnerabilities:

    Host overview: TPV

    Example code-level vulnerabilities:

    Host overview: CLV

If you're missing the security permissions for the selected management zone, the Vulnerabilities tab on the notification bar shows Not analyzed.

Availability

  • On the notifications bar, Availability indicates the percentage of time that the host was online and responsive to requests. Dynatrace detects and shows operating system shutdowns (including reboots) and periods when a host is offline (for example, if the host is down unexpectedly).

  • Select Availability on the notifications bar to display the Host availability panel, which charts host availability over time.

    Host page detail - online availability

For details, see Host availability.

Host performance

Go to the Host performance section for quick insights with relevant metrics: CPU, memory, and network metrics, with different metric aggregations for the selected timeframe. Timeline browsing lets you pinpoint selected anomalies in all metric charts simultaneously, making it easier to understand the relationships between the various infrastructure components at a specific point in time.

It is easy to inspect maximum or minimum peaks in resource consumption, as each metric chart allows the selection of a different aggregation. Custom metrics can also be displayed instead of the default metrics, allowing inspection of specific relationships across metrics that might be critical for any specific host configuration.

Select in the upper-right corner of a chart to:

  • Show in Data Explorer—Opens Data Explorer for the associated query, so you can view the associated query, explore the data more in-depth, adjust the chart settings, and pin the chart to your own dashboard.
  • Pin to dashboard—Pins a copy of the selected chart to any classic dashboard you can edit. For example, if certain hosts are particularly important to your business, create a dashboard designated to monitoring only those hosts, and then pin charts from their host overview pages to that dashboard, all with almost no typing. For details, see Pin tiles to your dashboard.

Host overview: host performance

Process analysis

To get a better understanding of process behavior, go to the Process analysis section, which charts and lists processes running on the selected host. Select a process to drill down for details about that process on the host.

Select in the upper-right corner of a chart to:

  • Show in Data Explorer—Opens Data Explorer for the associated query, so you can view the associated query, explore the data more in-depth, adjust the chart settings, and pin the chart to your own dashboard.
  • Pin to dashboard—Pins a copy of the selected chart to any classic dashboard you can edit. For example, if certain hosts are particularly important to your business, create a dashboard designated to monitoring only those hosts, and then pin charts from their host overview pages to that dashboard, all with almost no typing. For details, see Pin tiles to your dashboard.

Host overview: process analysis

Process instance snapshots

OneAgent version 1.237+

The Process instance snapshots section offers additional insights into the most resource-consuming processes running on your host and the processes defined for Process availability monitoring.

Process instance snapshot

A single process instance snapshot is a set of monitoring data for processes. It contains data on the process CPU usage (%), Memory usage (B), Incoming network traffic (KB), and Outgoing network traffic (KB) measured at one-minute intervals. A single snapshot contains 20 minutes of monitoring data: 10 minutes preceding the trigger and 10 minutes after the trigger. Each host can report only 60 minutes of these metrics per day. A process is considered for the snapshot if its consumption of CPU, memory, or network is more than 1%.

A process instance snapshot is triggered by high CPU, memory, or network usage on your host. You can also request a process snapshot manually. Select in the upper-right corner of the section and select Request process snapshot now. Wait for a message confirming a successful snapshot trigger. Process snapshot data should appear after you reload the page within 90 seconds.

Additionally, for processes defined for Process availability monitoring, the snapshot shows how the processes behaved before they disappeared and if they reappeared within 10 minutes.

Enable process instance snapshots

You can enable process instance snapshots at a host or environment level.

  • To enable it at the environment level, go to Settings, select Processes and containers > Process instance snapshots, and turn on Enable process instance snapshots.
  • To define a host-level rule, go to a host overview page, select , go to Settings, select Process instance snapshots, and turn on Enable process instance snapshots.
  • To define a host group level rule, go to the host group page at https://your-environment/ui/settings/HOST_GROUP-NAME, select Process instance snapshots, and turn on Enable process instance snapshots.

On the same settings page, you can also lower the limit of processes reported in a single snapshot. The maximum/default setting is 100 processes.

Disk analysis

To identify disk performance bottlenecks, go to the Disk analysis section , which displays all mount points for Linux systems and all volumes for Windows. At a glance, you can see the disk space usage and throughput metrics, in addition to other selected disk metrics, to allow rapid identification of any disk performance issues.

  • On the host page, filter disks by disk name to focus on the selected disk
  • Expand a disk entry to see details about the selected disk. Each disk instance displays separate detailed performance metrics, making it easy to spot any disk resource not performing optimally.

Each mount point (Linux) or volume (Windows) has its own performance metrics in addition to the combined metrics. This allows spotting a slow or erratic disk much easier. Alerts can be set for individual disks as for the combined charts.

Select in the upper-right corner of a chart to:

  • Show in Data Explorer—Opens Data Explorer for the associated query, so you can view the associated query, explore the data more in-depth, adjust the chart settings, and pin the chart to your own dashboard.
  • Pin to dashboard—Pins a copy of the selected chart to any classic dashboard you can edit. For example, if certain hosts are particularly important to your business, create a dashboard designated to monitoring only those hosts, and then pin charts from their host overview pages to that dashboard, all with almost no typing. For details, see Pin tiles to your dashboard.

Host overview: disk analysis

Disk monitoring

Limitations

  • Supported disk metrics

Infrastructure

Disk

Metric key
Name and description
Unit
Aggregations
Monitoring consumption
builtin:host.disk.throughput.read

Disk throughput read

File system read throughput in bits per second

bit/s
autoavgmaxmin
Host units
builtin:host.disk.throughput.write

Disk throughput write

File system write throughput in bits per second

bit/s
autoavgmaxmin
Host units
builtin:host.disk.avail

Disk available

Amount of free space available for user in file system. On Linux and AIX it is free space available for unprivileged user. It doesn't contain part of free space reserved for the root.

Byte
autoavgmaxmin
Host units
builtin:host.disk.bytesRead

Disk read bytes per second

Speed of read from file system in bytes per second

Byte/second
autoavgmaxmin
Host units
builtin:host.disk.bytesWritten

Disk write bytes per second

Speed of write to file system in bytes per second

Byte/second
autoavgmaxmin
Host units
builtin:host.disk.free

Disk available %

Percentage of free space available for user in file system. On Linux and AIX it is % of free space available for unprivileged user. It doesn't contain part of free space reserved for the root.

Percent (%)
autoavgmaxmin
Host units
builtin:host.disk.inodesAvail

Inodes available %

Percentage of free inodes available for unprivileged user in file system. Metric not available on Windows.

Percent (%)
autoavgmaxmin
Host units
builtin:host.disk.inodesTotal

Inodes total

Total amount of inodes available for unprivileged user in file system. Metric not available on Windows.

Count
autoavgmaxmin
Host units
builtin:host.disk.queueLength

Disk average queue length

Average number of read and write operations in disk queue

Count
autoavgmaxmin
Host units
builtin:host.disk.readOps

Disk read operations per second

Number of read operations from file system per second

Per second
autoavgmaxmin
Host units
builtin:host.disk.readTime

Disk read time

Average time of read from file system. It shows average disk latency during read.

Millisecond
autoavgcountmaxminsum
Host units
builtin:host.disk.used

Disk used

Amount of used space in file system

Byte
autoavgmaxmin
Host units
builtin:host.disk.usedPct

Disk used %

Percentage of used space in file system

Percent (%)
autoavgmaxmin
Host units
builtin:host.disk.utilTime

Disk utilization time

Percent of time spent on disk I/O operations

Percent (%)
autoavgmaxmin
Host units
builtin:host.disk.writeOps

Disk write operations per second

Number of write operations to file system per second

Per second
autoavgmaxmin
Host units
builtin:host.disk.writeTime

Disk write time

Average time of write to file system. It shows average disk latency during write.

Millisecond
autoavgcountmaxminsum
Host units

  • OneAgent installer based deployment:

    • Network disks are supported for Linux hosts, AIX hosts, and since the release of OneAgent version 1.277, monitoring of network disks has been enabled also on Windows.
    • SMB 1.0 is supported starting with OneAgent version 1.263.

  • OneAgent application-only deployment:

    • Application-only OneAgents provide a reduced set of Disk I/O metrics, such as:

      • Disk read bytes per second
      • Disk write bytes per second
      • Disk read operations per second
      • Write operations per second

    • Linux uses the file /proc/diskstats that provides information about disk I/O activity on the system. /proc/diskstats does not provide any information about network mounts.

    • Solaris doesn't provide any Disk I/O information.

    • AIX reports only the Disk I/O information about Disk read bytes per second and Disk write bytes per second.

  • Windows only The disk page shows only local disks with a letter and/or a mount point. For remote disks, the system recognizes and displays only the shares with CIFS protocol. For details, see https://dt-url.net/jw03uor.

Disable monitoring for specific disks

Set an exclusion filter to avoid problems with special mount points:

  1. Go to Settings > Preferences > Disk options.
  2. Select Add item to exclude the disk from the monitoring list.
  3. Provide your OS, disk path and file system type.
  4. Select Save changes.

Network analysis

To spot network-related issues rapidly, go to the Network analysis section, which lists all network interfaces and combined metrics for all of them, in addition to individual metrics per network interface.

Use this section to:

  • Identify packet loss, error packets, and other network issues
  • Search for network interfaces by network name
  • Identify network bottlenecks down to the specific adapter

Select in the upper-right corner of a chart to:

  • Show in Data Explorer—Opens Data Explorer for the associated query, so you can view the associated query, explore the data more in-depth, adjust the chart settings, and pin the chart to your own dashboard.
  • Pin to dashboard—Pins a copy of the selected chart to any classic dashboard you can edit. For example, if certain hosts are particularly important to your business, create a dashboard designated to monitoring only those hosts, and then pin charts from their host overview pages to that dashboard, all with almost no typing. For details, see Pin tiles to your dashboard.

Host overview: network analysis

Memory analysis

Use the Memory analysis section to analyze:

  • Memory usage—total memory, memory used, and memory reclaimable
  • Page faults—page faults per second
  • Swap usage—swap total and swap used

Select in the upper-right corner of a chart to:

  • Show in Data Explorer—Opens Data Explorer for the associated query, so you can view the associated query, explore the data more in-depth, adjust the chart settings, and pin the chart to your own dashboard.
  • Pin to dashboard—Pins a copy of the selected chart to any classic dashboard you can edit. For example, if certain hosts are particularly important to your business, create a dashboard designated to monitoring only those hosts, and then pin charts from their host overview pages to that dashboard, all with almost no typing. For details, see Pin tiles to your dashboard.

Events

The events section displays recent host events that Davis AI has generated, with a clear timeline view to quickly identify critical events. The timeline view is interactive, filtering events around a specific moment, making it easier to isolate a particular event. In addition, different event types are color-coded for easier and faster identification and browsing.

  • Show single card—Opens an Events card for the selected host.

Logs

The log viewer timeline is interactive, allowing a global timeline selection. Use it to identify issues around a specific log event and see how it relates to hosting performance or processes.

  • The entire host page time selection will match what is selected in the log viewer. In this way, an error log can be easily compared to host performance metrics or process metrics around the time the log error took place. The same timeline selection will arrive on the event card.
  • You can filter logs based on process group, status, log level, and other parameters, allowing searching, for example, just for error logs or for logs about a certain process.

Select in the upper-right corner of the Logs section to:

  • Go to Log Viewer—Opens the Log Viewer page filtered by the selected host.
  • Create metric—Opens the Log metrics page with the Query value set to the selected host.

Step 4 Set up a problem notification

Dynatrace offers several out-of-the-box integrations that automatically push Dynatrace problem notifications to your third-party messaging or incident-management systems. If, however, your third-party system isn't supported with an out-of-the-box integration, you can easily set up email integration. Using this approach, an email message is sent out whenever Dynatrace detects a problem in your environment that affects real users.

  1. Go to Settings and select Integration > Problem notifications.

  2. Select Add notification.

    Add an email problem notification

  3. Select Email from the available notification types.

  4. Configure the notification:

    • Enter a Display name for this integration. This is the freeform name of this integration that will be displayed in the Problem notifications table when you finish this configuration.
    • In the To section, select Add recipient to add the email address that should receive notifications. To add more recipients, select Add recipient for each additional To address.
    • In the CC field, select Add recipient to add additional email addresses that should receive notifications.
    • In the BCC field, select Add recipient to add additional email addresses that should receive notifications but should not be displayed in the email header.
    • In the Subject field, type text and/or insert placeholders that will be automatically populated with relevant problem details, such as problem ID, state, or impact.
    • In the Body field, configure the problem alert message that is to appear in the body of problem-notification emails.
      Placeholders

      The Available placeholders section of the configuration page lists placeholders you can use for this integration. Placeholders are automatically replaced with actual values in the message.

    • Select an alerting profile to filter the problem feed.

  5. Select Send test notification to make sure your email integration is working.

  6. Save changes.

Step 5 Create your first dashboard

Dashboards Classic

To create a dashboard

  1. Go to Dashboards or Dashboards Classic (latest Dynatrace).

  2. Select Create Dashboard.

  3. Enter a name for your dashboard and select Create. The new dashboard opens in edit mode.

  4. To add a tile, drag it from the Tiles pane to the dashboard. For example, drag a Host health tile to your new dashboard.

    Drag host health tile to dashboard

  5. Select Done.
    The new dashboard is displayed as it will appear to you and people with whom you share it. (Though other people will not see the Edit button if you don't give them edit permission.)

Now let's go back to our host overview page and pin a chart from that page to your new dashboard.

  1. Go to Hosts or Hosts Classic (latest Dynatrace).

  2. Find and select your host in the table.

  3. On the host overview page, in the Host performance section, find the CPU usage chart.

  4. Select > Pin to dashboard.

    Pin CPU usage chart to dashboard

  5. Select Pin. This pins a copy of the CPU usage chart to your dashboard.

  6. Select Open dashboard to return to your dashboard. The dashboard is opened in edit mode with the new tile selected.

  7. Select Done to save your changes and display the updated dashboard.

Try using the same procedure to add a few more tiles to your dashboard.

Step 6 Check further resources

To learn more about Dynatrace, see: