Uso del agente ARMS Golang en un entorno de Function Compute - Application Real-Time Monitoring Service

Function Compute (FC) incluye un runtime de Go integrado compatible con Application Real-Time Monitoring Service (ARMS). En este tema se describe cómo integrar el runtime de Go con ARMS.

Contexto

La integración de Function Compute con la plataforma ARMS le permite monitorear y rastrear sus funciones. Esta integración proporciona observability a nivel de instancia, datos de Tracing Analysis, métricas del runtime de Go y datos de perfilado de CPU.

Requisitos previos

Se requiere la versión 1.18 o posterior de Go.

Obtención de una clave de licencia

Obtenga la clave de licencia mediante OpenAPI. Para obtener más información, consulte DescribeTraceLicenseKey - List license keys.

Método 1: Creación de una función en FC con un archivo binario de Go compilado

Compile su aplicación de Go con el agente de Go de ARMS. Para obtener más información, consulte Compile a Go binary file.
Cargue y ejecute el archivo binario de Go compilado en Function Compute. Para obtener más información, consulte Create an event-triggered function.

Cuando cree la función activada por eventos, establezca Runtime en Go 1 y Code Upload Method en Upload Code with ZIP Package. Empaquete el archivo binario de Go compilado localmente en un paquete ZIP, cargue el paquete y luego haga clic en Create.

Configure las variables de entorno.

ARMS_ENABLE=true
ARMS_APP_NAME=xxx   # The name of your application.
ARMS_REGION_ID=xxx   # The region ID of your Alibaba Cloud account.
ARMS_LICENSE_KEY=xxx   # The license key you obtained.

Una vez completada la configuración, ejecute la función. La aplicación configurada aparecerá en la página Application Monitoring > Application List de la consola de ARMS.

Haga clic en el nombre de la aplicación. En la página Application Overview, puede consultar métricas de la función, como el número de solicitudes, el número de errores y el tiempo medio de respuesta. También puede consultar otros datos de llamadas internas.

Método 2: Construcción de una aplicación de Go con el FC Application Center

Modifique las acciones en el archivo s.yaml.

El código de ejemplo utiliza la URL de descarga correspondiente a la región China (Hangzhou). Sustituya la URL de descarga de la herramienta de compilación según su sistema operativo y su región. Para consultar la lista de URL de descarga, consulte Obtain a download URL.
Sustituya LicenseKey por la clave de licencia que obtuvo.

edition: 3.0.0
name: hello-world-app
access: "{{ access }}"

vars: # Global variables
  region: "{{ region }}"

resources:
  hello_world:
    component: fc3 
    actions:       
      pre-${regex('deploy|local')}: 
        - run: GO111MODULE=on go mod tidy
          path: ./code
        - run: wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-amd64" -O instgo
          path: ./code
        - run: chmod +x instgo
          path: ./code
        - run: GOOS=linux GOARCH=amd64 CGO_ENABLED=0 ./instgo build --licenseKey="{licenseKey}" --cacheDir=./ -- -o target/main main.go
          path: ./code
    props:
      region: ${vars.region}              
      functionName: "{{ functionName }}"
      description: 'hello world by serverless devs'
      runtime: "{{ runtime }}"
      code: ./code/target
      handler: main
      memorySize: 128
      timeout: 10
      # triggers:
      #   - triggerName: httpTrigger # Trigger name
      #     triggerType: http # Trigger type
      #     description: 'xxxx'
      #     qualifier: LATEST # The service version to trigger
      #     triggerConfig:
      #       authType: anonymous # Authentication type. Valid values: anonymous, function
      #       disableURLInternet: false # Specifies whether to disable the public endpoint
      #       methods: # The supported HTTP methods. Valid values: GET, POST, PUT, DELETE, HEAD
      #         - GET
      #         - POST

En el FC Application Center, importe la aplicación desde un repositorio. Para obtener más información, consulte Import an application.

En la página Create Application, seleccione Import an application from a repository. En la sección Basic Settings, seleccione un tipo de repositorio, como GitHub; después, seleccione el usuario u organización del repositorio, el nombre del repositorio y la rama del repositorio, e introduzca el Application Name y la Description. Si aún no ha autorizado a Serverless Devs, haga clic primero en Authorize para otorgarle acceso de lectura al repositorio de código.
Una vez creada la aplicación, vaya a la página de detalles de la aplicación. En la sección Resource Information > Function Resources, haga clic en el nombre de la función y agregue a continuación las variables de entorno. Para obtener más información, consulte Configure environment variables.
```
ARMS_ENABLE=true
ARMS_APP_NAME=xxx   # The name of your application.
ARMS_REGION_ID=xxx   # The region ID of your Alibaba Cloud account.
ARMS_LICENSE_KEY=xxx   # The license key you obtained.
```
Inicie la aplicación. La aplicación configurada aparecerá en la página Application Monitoring > Application List de la consola de ARMS.

Haga clic en el nombre de la aplicación. En la página Application Overview, puede consultar métricas como el número de solicitudes, el número de errores y el tiempo medio de respuesta.