Why do I need an environment ID?

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

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

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

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

In case you are operating your own DESK 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 DESK 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 DESK 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.