Azure Container Apps tracing for Go

Prerequisites

Ensure that you use the latest version of the Go in-process collector module. To make sure that you are using the latest version of the Go in-process collector module, check the go.mod file in your project or run the following command:

go get github.com/instana/go-sensor@latest

If you do not have the latest Go in-process collector, download the latest version and update the required version in the go.mod file. For more information, see Go installation.

Configuring Azure Container Apps

Instana Go in-process collector 1.63.0 supports Azure Container Apps in its Azure agent. After you instrument your Go application with the Instana Go Tracer SDK, the Instana Go in-process collector switches to serverless mode. Instead of sending collected spans to the host agent, the collector submits them directly to the Instana serverless acceptor endpoint, which is configured with the help of INSTANA_ENDPOINT_URL environmental variable.

This process uses an agent key that is defined in the INSTANA_AGENT_KEY environment variable. The Azure Container Apps' resource ID is used as the entity ID for infrastructure correlation. To construct the resource ID, the environment variables AZURE_SUBSCRIPTION_ID and AZURE_RESOURCE_GROUP need to be set.

To send collected spans to the Instana backend, set the following environment variables in Azure Container Apps:

• INSTANA_ENDPOINT_URL: Sets to the URL of your Instana backend endpoint.
• INSTANA_AGENT_KEY: Sets to your agent key.
• INSTANA_TIMEOUT: Sets to an appropriate timeout value that depends on the zone that you configured.

For infrastructure correlation, set the following environment variables:

• AZURE_SUBSCRIPTION_ID: Sets to your Azure subscription ID.
• AZURE_RESOURCE_GROUP: Sets to your Azure resource group.

Enabling tracing

To enable tracing for a Go application in Azure Container Apps, complete the following steps:

1. After you download the Instana Go Tracer SDK, instrument your application with the downloaded SDK.

2. Create a container image of your application.

3. Deploy the container image to Azure Container Apps.

   Before you deploy the image, ensure that the required environment variables are set in Azure Container Apps. For more information, see Configuring Azure Container Apps.

Now you can view your Go application traces in the Instana UI.