Installing the host agent on Google Compute Engine (GCE)

To install and configure the Instana host agent on Google Compute Engine (GCE), you copy and run a command as Startup Script for the GCE instance.

Linux

To install and run the host agent, complete the following steps:

  1. Sign in to the Instana UI, and then select an option to display the agent catalog; for example, on the home page, click Deploy Agent.

    If you are starting a new trial instance of Instana, the agent catalog is displayed with a prompt to select a host agent to install.

  2. Click the tile Google Cloud Google Compute Engine (GCE) - Linux

  3. Select the packaging option to install a dynamic or static agent, and the runtime option that you want to use. If you change options, then the script parameters are updated.

    The script is pre-filled with your agent key and host agent endpoint.

    #!/bin/bash

curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo apt-get install apt-transport-https ca-certificates && sudo ./setup_agent.sh -a <your-agent-key> -d <your-agent-key> -t dynamic -e <host-agent-endpoint> -s -y

    The script above is based on the agent one-liner script for Linux, and it can be easily modified to accommodate a number of additional parameters as described in the Additional One-Liner parameters documentation.

  4. Copy and run the script as Startup Script for the GCE instance.

For more information about how to use startup scripts in GCE, see the Google docs.

Checking the status of the host agent

After you install the host agent, you can check the status of the host agent in the Instana UI or on the host. For more information, see Checking the status of the host agent.

Troubleshooting agent deployment

If installing the agent is not successful at first, you can check log messages and troubleshooting tips. If this troubleshooting section does not answer the questions you have, contact the IBM Instana support team with information about your experience, so that we can help you and update our documentation accordingly.

For troubleshooting information that is general to all host agents, see Managing host agents / Troubleshooting.