Homeโ€บ๐Ÿ—๏ธ Track 1: Foundationโ€บModule 22 min read ยท 3/21

Getting Started

Tutorial

Getting Started

Once OneAgent is installed and data is flowing, here's how to navigate the platform.

The Universal Search: Ctrl+K

Press Ctrl+K (or Cmd+K on Mac) anywhere in Dynatrace. This is the fastest way to find anything:

Type This           What Opens
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
hosts               Host list with health status
services            Service list with response times
dashboards          Dashboard list (create or open)
notebooks           Notebook list (interactive analysis)
problems            Active problems with root cause
settings            All configuration settings
workflows           Automation workflows
logs                Log viewer

๐Ÿ›  Try it: Press Ctrl+K โ†’ "Infrastructure & Operations" โ†’ click any host โ†’ scroll down to see every process running on it, every service it hosts, and every network connection it makes. Dynatrace discovered all of this automatically from a single agent install.

Key Apps

App                 What It Does                              When to Use
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€    โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
Dashboards          Visual tiles with DQL queries              Daily monitoring, KPIs
Notebooks           Interactive DQL analysis (like Jupyter)    Investigation, exploration
Problems            Davis AI detected issues                   Incident response
Distributed Tracing Request-level trace analysis               Performance debugging
Logs                Log search and analysis                    Error investigation
Workflows           Automation (triggers โ†’ actions)            Alerts, reports, remediation
Settings            All platform configuration                 Setup, tuning

Account Management

Dynatrace has two levels of management:

Level               URL                             What You Manage
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
Environment         ENV-ID.apps.dynatrace.com       Monitoring, dashboards, alerts
Account             myaccount.dynatrace.com         Users, groups, policies, billing

Authentication Methods

Method              Best For                        Scope
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
API Token           Settings, extensions, classic    Environment-level
OAuth Client        Workflows, dashboards, IAM       Account-level (automation)
Platform Token      Scripts, integrations            User-scoped (long-lived)

๐Ÿ’ก For getting started, you don't need any tokens โ€” just log in to the UI. Tokens are for automation and API access, which is covered in Track 4.

The Settings Hierarchy

All configuration in Dynatrace follows the Settings 2.0 pattern:

Settings โ†’ Schema ID โ†’ Scope โ†’ Value

Example:
  Schema: builtin:davis.anomaly-detectors
  Scope:  environment
  Value:  { title: "High CPU", query: "timeseries avg(dt.host.cpu.usage)..." }

Every setting you see in the UI is a Settings 2.0 schema. You can automate any setting via the API or Terraform.

OneAgent Post-Install Configuration

After installing OneAgent, use oneagentctl to configure it:

# Location: /opt/dynatrace/oneagent/agent/tools/oneagentctl (needs root)
oneagentctl --version                          # Show version
oneagentctl --get-host-group                   # Show host group
oneagentctl --set-host-group=production        # Change host group
oneagentctl --set-host-tag=environment=prod    # Add tag
oneagentctl --get-auto-update-enabled          # Check auto-update
oneagentctl --set-auto-update-enabled=false    # Pin version
oneagentctl --create-support-archive           # Diagnostic bundle

Install parameters: --set-host-group, --set-app-log-content-access=true, --set-monitoring-mode=fullstack|infra-only, --set-host-tag=key=value.