Why do I need an environment ID?

Dynatrace relies on unique character strings to identify your monitoring environment. This is necessary to enable, for example, external integration of your Dynatrace monitoring environment with 3rd party messaging services, Dynatrace REST API, PaaS environments, VoiceOps/ChatOps, and other reporting tools.

All external access to your Dynatrace monitoring environment relies on two major pieces of information: the environment ID and a PaaS token.

Environment ID

Each environment that you monitor with Dynatrace is identified with a unique character string (i.e., your environment ID). The Dynatrace API relies heavily on environment IDs to ensure that it pulls monitoring data from and pushes relevant external events to the correct Dynatrace environments.

Within Dynatrace SaaS, your Dynatrace environment ID (otherwise known as a tenant ID), is included at the beginning of your Dynatrace environment's URL (see highlight in image below).

In case you are operating your own Dynatrace Managed installation, you can find your environment id within your custom domain path after the /e/ subpath (see highlight in image below).

You can also find your environment ID listed on your Dynatrace account page along with your licensing details. To find this page, click the User menu button in the upper-right corner of the menu bar and select Account settings.

Environment IDs for PaaS, Linux/AIX/Solaris, & containerized environments

If your environment is PaaS-based, built on Linux/AIX/Solaris, or is containerized, follow these steps to locate your environment ID.

Select Deploy Dynatrace from the navigation menu.

If you have a PaaS-based infrastructure: Click the Set up PaaS integration button. Your environment ID appears in the Environment ID text box.

If your infrastructure is based on Linux/AIX/Solaris: Click Start installation and select your operating system (Linux/AIX/Solaris). Your environment ID appears at the beginning of the URL included in the Use this command on the target host text box.

If you have a containerized infrastructure: Click Start installation and select Linux. Your environment ID appears at the beginning of the URL included in the Use this command on the target host text box.

PaaS token

To get your PaaS token:

  1. Login with your Dynatrace account.

  2. Select Deploy Dynatrace from the navigation menu.

  3. Click the Set up PaaS integration button.

  4. Your environment ID appears in the Environment ID text box. You'll need this ID to link your Dynatrace account with your PaaS environment. Click Copy to copy the ID to the clipboard. You can do this at any time by revisiting this page.

  5. To generate a PaaS token, click the Generate new token button. The PaaS token is essentially an API token that's used in combination with your environment ID to download Dynatrace OneAgent. As you'll see, there's also a default InstallerDownload token available that you can alternatively use. However, for security reasons, it's recommended that you create several discrete tokens for each environment you have.

  6. Type in a meaningful name for your PaaS token. A meaningful token name might be the name of the PaaS platform you want to monitor (for example, azure, cloud-foundry, or openshift). To view and manage your existing PaaS tokens, go to Settings -> Integration -> Platform as a Service.

  7. Click Generate to create the PaaS token. The newly created PaaS token will appear in the list below. Click Copy to copy the generated token to the clipboard. You can do this at any time by revisiting this page and clicking Show token next to the relevant PaaS token.