Endpoints and Keys
TABLE OF CONTENTS
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 AWS Lambda tracing and
- AWS Fargate monitoring
- Google Cloud Run 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 |