Serverless App Engine:Install an agent for a Go application

Prerequisites

• Activate Serverless App Engine (SAE).

• Activate Application Real-Time Monitoring Service (ARMS).

• Activate Container Registry (ACR) and create an Enterprise Edition instance or a Personal Edition instance.

• Ensure your image build environment can connect to the public internet or the Alibaba Cloud internal network, and the security group for your build environment allows outbound TCP traffic on ports 8080, 9990, 80, and 443.

• Check your network environment. For more information, see Network configuration for Go application monitoring.

• Check the operating system, architecture, Go version, and framework version of your image build environment. For more information, see Supported Go components and frameworks for ARMS Application Monitoring.

Limitations

This feature applies only to Go applications deployed using an image.

Overview

1. Prepare a project: This topic uses a demo project as an example.

2. Build an image and push it to an ACR image repository: Build an image from the project and push it to an Alibaba Cloud ACR repository to create a microservice application in SAE.

3. Create an application: Deploy the image from the image repository to SAE and access the application.

4. View application monitoring data: View various types of monitoring data generated by the application.

1. Prepare the project

Upload the Go project to your environment.

2. Build image and push to repository

2.1 Build the image

Download the compile tool and build the application.

1. Download the compile tool.

   # Download the wget command.
   RUN yum -y install wget
   # This example shows how to download the compile tool from the public endpoint in the China (Hangzhou) region.
   RUN wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-amd64" -O instgo

   In a production environment, select a download address based on the region where your build machine is located. For a list of download addresses, see Download commands for each region.

   Note

   The compile tool binary is the same for all regions. If your environment can access OSS over the public internet, use the China (Hangzhou) public endpoint to download the compile tool for your OS and architecture.

2. Add the execute permission to the binary file.

   RUN chmod +x instgo

3. Call OpenAPI to obtain the LicenseKey. For more information, see ListLicenseKey.

4. Replace the go build command with the ./instgo build command to build the application.

   # Use the ./instgo build command to compile the Go project.
   # Replace {licenseKey} with the LicenseKey that you obtained in the preceding step.
   RUN ./instgo build --licenseKey="{licenseKey}" --cacheDir=./

   If you want to test the build or cannot obtain a LicenseKey yet, you can add the --dev flag to enable development mode. In this mode, you do not need to pass a LicenseKey.

   Note

   If your original build command includes additional build arguments, add them after a -- separator. For example:

   RUN ./instgo build --licenseKey="{licenseKey}" --cacheDir=./ -- {arg1} {arg2} ...

   • instgo command reference

     Command	Flag	Type	Description	Required
     build (compile)	--licenseKey, -l	string	The ARMS LicenseKey.	Yes (optional in development mode)
     	--dev	-	Enables development mode, allowing you to compile without a LicenseKey for build testing.	No
     	--agentVersion	string	The agent version.	No
     	--agentPath	string	The local agent path.	No
     	--cacheDir	string	The agent cache directory.	No
     	--regionId, -r	string	Region ID of the OSS bucket that stores agent dependencies. Default: cn-hangzhou.	No
     	--timeout, -t	int	Timeout for pulling the agent, in seconds. Default: 180.	No
     	--verbose, -v	-	Prints detailed compile logs.	No
     	--vpc	-	Pulls agent package dependencies over the internal network.	No
     clean (Clears artifacts)	-	-	-	-
     update (Updates the agent)	--licenseKey, -l	string	The ARMS LicenseKey.	Yes
     	--cacheDir	string	The agent cache directory.	No
     	--regionId, -r	string	Region ID of the OSS bucket that stores agent package dependencies. Default: cn-hangzhou.	No
     	--timeout, -t	int	Timeout for pulling the agent, in seconds. Default: 180.	No
     	--vpc	-	Pulls agent package dependencies over the internal network.	No
     version (Prints the version number)	-	-	-	-

   • During the first build, the agent is downloaded to the /opt directory by default. You can use the --cacheDir flag to specify a custom cache directory.

2.2 Push image to repository

Push the built Go image to an Alibaba Cloud image repository. For more information, see Push and pull images (Enterprise Edition) or Push and pull images (Personal Edition).

3. Create a Go application

Only key steps are covered here. For the full procedure, see Deploy an application using an image.

3.1 Create the application

1. On the Specify Image panel, set Technology Stack Programming Language to Go, and then select an image version.

   Select the My Alibaba Cloud Images tab and Container Registry Personal Edition. From the Select Image Version drop-down list, select go-demo-2.

2. On the Advanced Settings page, in the Application Monitoring section, enable Application Monitoring.

   Before you enable this feature, modify the custom image and manually install the agent during the build process. ARMS provides a free monthly quota of 200 GB for SAE users. Once enabled, SAE monitors metrics such as request count, error count, average response time, instance GC, and heap memory, and supports call trace analysis.

3. Click Create Application.

3.2 Test access

1. Add a public endpoint to the application. For more information, see Bind an SLB instance to an application and generate a public or private IP address for the application.

   After the configuration is complete, the Public Endpoint section of the Application Access Settings page shows the SLB record, including the IP address, port (for example, 2222), and protocol (for example, HTTP).

2. Copy the public endpoint and open it in a browser to test access.

4. View application monitoring