Preparing endpoints and keys

You can use different Instana agents to monitor your technology stacks as you need, including host agents, cloud service agents, serverless agents, and web and mobile agents.

To create a relationship between the monitoring agent and the environment that it belongs to, you need the Agent key. To download additional artifacts when you deploy a dynamic agent, you need the Download key.

In addition, because Instana is available as a self-hosted (on-premises) solution, or as a SaaS solution, which can be hosted in multiple public clouds like AWS and Google Cloud, multiple addresses are needed for data ingress to the Instana agents like the host agent or the serverless agents.

After you purchase the Instana license, you receive an email with the license, sales key, and agent key. To find your agent key and download key, you can also click More > Agents in the navigation bar of the Instana UI and then click Install Agents > Windows.

Agent key

The agent key is used to create a relationship between the monitoring agent and the environment that it belongs to. Several installation methods of the host-agent, such as the one-liner for Linux® machines, use the agent key as an authentication method, which grants the executing machine access to the downloadable artifact. The agent key also grants permission to ingest data for a specific environment.

Download key

In addition to the agent key, Instana On-Premises deployments provide a download key. This key serves for downloading additional artifacts when you deploy a dynamic agent. If you are using an Instana distributed on-premises deployment, the download key is provided for you by Instana. Depending on your agent installation, the download key can be provided during installation or startup. Refer to the linux or container documentation for details.

Monitoring Ingress endpoints

The ingress endpoint for monitoring technologies depends on the type of data that is ingested, and where the installation is located.

When you have doubts, go to your Instana installation, click ... More > Agents > Installing Instana Agents, and choose the type of installation you want to use.

The dialog guides you through the process, and also provides the correct value for your Instana installation and environment.

Endpoints for the host and cloud service agents

Use these values when you configure the Instana host agent or the Instana AWS agent, or whenever you need to provide environment variables that are named INSTANA_AGENT_ENDPOINT and INSTANA_AGENT_ENDPOINT_PORT. In fact, with the exceptions that are mentioned in Serverless Monitoring and Website and Mobile App Agents, the following are always the values you are looking for.

Region URL
AWS APAC https://ingress-mizu-saas.instana.io
AWS APAC https://ingress-teal-saas.instana.io
AWS Europe https://ingress-blue-saas.instana.io
AWS US https://ingress-red-saas.instana.io
GCP Europe https://ingress-green-saas.instana.io
GCP US https://ingress-orange-saas.instana.io
GCP US https://ingress-coral-saas.instana.io

Endpoints for serverless monitoring

Use these values for configuring serverless monitoring, which includes the following:

  • Native AWS Lambda tracing
  • AWS Fargate monitoring
  • Google Cloud Run monitoring
  • Azure Functions monitoring

You can also obtain the correct values for these environment variables by going to your Instana installation, click ... More > Agents > Installing Instana Agents > Platform: "AWS", and then choose the technology that you are interested in (AWS Lambda or AWS Fargate).

Region INSTANA_ENDPOINT_URL
AWS APAC https://mizu.instana.io/serverless
AWS APAC https://teal.instana.io/serverless
AWS Europe https://serverless-blue-saas.instana.io
AWS US https://serverless-red-saas.instana.io
GCP Europe https://serverless-green-saas.instana.io
GCP US https://serverless-coral-saas.instana.io
GCP US https://serverless-orange-saas.instana.io

Endpoints for website and mobile app agents

These values are used in website monitoring and mobile app monitoring.

Region Type URL
Global Website JavaScript Agent Download https://eum.instana.io
AWS APAC Website & Mobile App Agents https://mizu.instana.io/eum
AWS APAC Website & Mobile App Agents https://teal.instana.io/eum
AWS Europe Website & Mobile App Agents https://eum-blue-saas.instana.io
AWS US Website & Mobile App Agents https://eum-red-saas.instana.io
GCP Europe Website & Mobile App Agents https://eum-green-saas.instana.io
GCP US Website & Mobile App Agents https://eum-coral-saas.instana.io
GCP US Website & Mobile App Agents https://eum-orange-saas.instana.io