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?
Create your Dynatrace account
Deploy Dynatrace
Monitor your host and its processes
Set up a problem notification
Create your first dashboard
Check further resources
Create your Dynatrace account
To create a free trial Dynatrace account
- Go to dynatrace.com and select Free trial.
- Enter your business email address and select Start free trial.
- Provide some contact information, select your region, and agree to the terms and conditions.
- Welcome to Dynatrace!
Deploy Dynatrace
To download and install Dynatrace OneAgent on a host
-
In Dynatrace Hub, select OneAgent.
-
Select Set up.
-
Select the type of machine you're going to monitor.
-
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.
-
-
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.
-
After you install OneAgent, restart the processes you want to monitor (or restart the machine).
-
Go to Deployment Status to verify the deployment.
You installed a single OneAgent, so you should see one host listed on the OneAgents tab. -
Select the host name (we called it
MyHostName
in the example above) to see what Dynatrace already knows about that host.
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:
Example code-level vulnerabilities:
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.
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.
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.
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.
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.
Disk monitoring
Limitations
- Supported disk metrics
Infrastructure
Disk
Metric key | Name and description | Unit | Aggregations | Monitoring consumption |
---|---|---|---|---|
builtin:host | Disk throughput read File system read throughput in bits per second | bit | autoavgmaxmin | Host units |
builtin:host | Disk throughput write File system write throughput in bits per second | bit | autoavgmaxmin | Host units |
builtin:host | 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 read bytes per second Speed of read from file system in bytes per second | Byte | autoavgmaxmin | Host units |
builtin:host | Disk write bytes per second Speed of write to file system in bytes per second | Byte | autoavgmaxmin | Host units |
builtin:host | 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 | Inodes available % Percentage of free inodes available for unprivileged user in file system. Metric not available on Windows. | Percent (%) | autoavgmaxmin | Host units |
builtin:host | 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 average queue length Average number of read and write operations in disk queue | Count | autoavgmaxmin | Host units |
builtin:host | Disk read operations per second Number of read operations from file system per second | Per second | autoavgmaxmin | Host units |
builtin:host | 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 Amount of used space in file system | Byte | autoavgmaxmin | Host units |
builtin:host | Disk used % Percentage of used space in file system | Percent (%) | autoavgmaxmin | Host units |
builtin:host | Disk utilization time Percent of time spent on disk I/O operations | Percent (%) | autoavgmaxmin | Host units |
builtin:host | Disk write operations per second Number of write operations to file system per second | Per second | autoavgmaxmin | Host units |
builtin:host | 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
andDisk write bytes per second
.
-
-
Windows only On the disk page, only disks with a letter and/or a mount point are shown.
Disable monitoring for specific disks
Set an exclusion filter to avoid problems with special mount points:
- Go to Settings > Preferences > Disk options.
- Select Add item to exclude the disk from the monitoring list.
- Provide your OS, disk path and file system type.
- 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.
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.
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.
-
Go to Settings and select Integration > Problem notifications.
-
Select Add notification.
-
Select Email from the available notification types.
-
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.
-
Select Send test notification to make sure your email integration is working.
-
Save changes.
Create your first dashboard
To create a dashboard
-
Go to Dashboards or Dashboards Classic (latest Dynatrace).
-
Select Create Dashboard.
-
Enter a name for your dashboard and select Create. The new dashboard opens in edit mode.
-
To add a tile, drag it from the Tiles pane to the dashboard. For example, drag a Host health tile to your new dashboard.
-
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.
-
Go to Hosts or Hosts Classic (latest Dynatrace).
-
Find and select your host in the table.
-
On the host overview page, in the Host performance section, find the CPU usage chart.
-
Select > Pin to dashboard.
-
Select Pin. This pins a copy of the CPU usage chart to your dashboard.
-
Select Open dashboard to return to your dashboard. The dashboard is opened in edit mode with the new tile selected.
-
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.
Check further resources
To learn more about Dynatrace, see:
- Free trial resources
- Getting Started with Dynatrace at Dynatrace University