Endpoints and Keys

Instana is available as a SaaS solution hosted in multiple public clouds like AWS and Google Cloud, or self-hosted. This means that there are multiple addresses for data ingress to which agent technology like the host agent or the serverless agents report.

Agent Key

The agent key is being used to create a relation between the monitoring agent and the environment it belongs to. Several installation methods of the host-agent like 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.

The agent key can be found by clicking on Deploy Agent within the Instana user interfaces' landing page.

Monitoring Ingress Endpoints

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

When in doubt, go to your Instana installation, click on "... More" -> "Agents" -> "Installing Instana Agents" and choose the type of installation you want to perform. The dialog will guide you through the process and also provide the correct value for your Instana installation and environment.

Endpoints for the Host & Cloud Service Agents

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

Region URL
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

Endpoints for Serverless Monitoring

Use these values for configuring serverless monitoring, that is:

  • Native Lambda tracing and
  • Fargate monitoring

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

Region INSTANA_ENDPOINT_URL
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-orange-saas.instana.io

Endpoints for Website & Mobile App Agents

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

Region Type URL
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-orange-saas.instana.io
Global Website JavaScript Agent Download https://eum.instana.io