Serverless App Engine:Configuración de la recopilación de registros en SLS

Requisitos previos

• Asegúrese de que Simple Log Service esté activado. De lo contrario, inicie sesión en la consola de Simple Log Service y siga las instrucciones en pantalla para activarlo.

• Asegúrese de que cada instancia de su aplicación cuente con al menos 0.25 núcleos de CPU y 250 MB de memoria disponible.

Habilitar la recopilación de registros

Procedimiento:

1. Crear una aplicación

   En la página Lista de aplicaciones de SAE, seleccione la región y el namespace de destino en la parte superior y luego haga clic en Create Application. En la página Application Basic Information, configure los parámetros y haga clic en Next: Advanced Settings.

   Modificar una aplicación en ejecución

   Aviso

   El redespliegue de una aplicación provoca su reinicio. Para evitar problemas inesperados, como interrupciones del servicio, realice la operación de despliegue fuera de las horas pico.

   En la página Lista de aplicaciones de SAE, seleccione la región y el namespace de destino en la parte superior y luego haga clic en el ID de aplicación correspondiente para abrir la página de detalles de la aplicación. En el panel de navegación izquierdo, haga clic en Basic Information y después en Deploy Application en la esquina superior derecha.

   Modificar una aplicación detenida

   En la página Lista de aplicaciones de SAE, seleccione la región y el namespace de destino en la parte superior y luego haga clic en el ID de aplicación correspondiente para abrir la página de detalles de la aplicación. Haga clic en Basic Information y después en Modify Application Configuration.

2. Expanda la sección Log Settings y habilite SLS Log Service.

Detalles de configuración:

• Seleccione un recurso de SLS para almacenar los registros de la aplicación SAE:

  • Create Simple Log Service Resource: El sistema crea automáticamente un Project de SLS. El nombre del Project sigue el formato sae-<random_string>.

  • Use Existing Simple Log Service Resources: Seleccione un Project de SLS existente. El Project debe encontrarse en la misma región que la aplicación.

• Log labels: Se utilizan para identificar y categorizar las entradas de registro. Tras habilitar Custom Log Labels, seleccione un Type para configurar la clave y el valor. Para configurar varios pares clave-valor, haga clic en Add.

  • Custom: Introduzca un Variable Name y un Variable Value.

  • Reference Configuration Item: Introduzca un Variable Name y seleccione un Configuration Item Name y una Key existentes.

  Nota

  Esta función se encuentra actualmente en vista previa por invitación. Si desea utilizarla, póngase en contacto con el equipo técnico a través del grupo de DingTalk (ID de grupo: 32874633) para solicitar su habilitación.

• Collection Log Type:

  • File Logs (Log Path in Container): Utilice esta opción si su aplicación escribe registros en un archivo. En el campo Log Source, especifique la ruta absoluta del archivo de registro dentro del contenedor, incluido el nombre del archivo. Por ejemplo: /tmp/cjsc.log. Se admite el uso de expresiones regulares. Por ejemplo: /path/to/your/files/*.log.

  • Container Standard Output Logs: Utilice esta opción si su aplicación imprime registros en la salida estándar. El Log Source se muestra como stdout.log.

  • Haga clic en + Add para agregar varios registros.

  • Si selecciona Use Existing Simple Log Service Resources, puede configurar un logstoreName y un logtail para cada registro.

  Importante

  • No almacene otros archivos importantes en la ruta especificada como Log Source para evitar que se sobrescriban otros archivos en ese directorio. Por ejemplo, si los archivos ejecutables y los datos de su aplicación se almacenan en /home/admin/app/ y usted establece la ruta de almacenamiento de registros en /home/admin/, se sobrescribirán todos los directorios y archivos bajo esa ruta. Para evitar este problema, establezca la ruta de almacenamiento de registros en un directorio dedicado, como /home/admin/log/.

  • Durante un despliegue por lotes o gradual, si solo modifica el Project o el Logstore, los registros se seguirán recopilando en el destino original hasta que finalice el despliegue de todos los lotes. Esto se debe a que SLS no admite la recopilación de registros desde el mismo archivo hacia diferentes Projects o Logstores.

Comprobación de resultados:

1. En la página Lista de aplicaciones de SAE, seleccione la región y el namespace de destino en la parte superior y luego haga clic en el ID de aplicación correspondiente para abrir la página de detalles de la aplicación.

2. Haga clic en para consultar los registros de SLS.

3. En la columna Actions, haga clic en File Logs para abrir el Logstore correspondiente y consultar los detalles del registro.

Eliminación de prefijos del contenido de los registros

Al recopilar registros de salida estándar del contenedor, el contenido sin procesar incluye prefijos redundantes. Puede utilizar uno de los siguientes métodos para eliminar dichos prefijos.

Mejora del rendimiento de recopilación de Logtail

En la consola de SAE, puede establecer variables de entorno para configurar los parámetros de inicio de Logtail. La configuración de estos parámetros mejora el rendimiento de recopilación de Logtail y ayuda a resolver cuellos de botella que afectan la recolección de registros, como el alto consumo de memoria por archivos de registro grandes, el elevado tráfico de datos de registro y una alta tasa de envío de datos de Logtail.

En la sección Environment Variable, seleccione Custom o Reference Configuration Item y, a continuación, introduzca el Variable Name y el Variable Value/Variable Reference. Para más detalles, consulte Set environment variables.

• Reglas de nomenclatura de variables

  Añada el prefijo sls_ a la variable de entorno de Logtail que desee configurar. Por ejemplo, si desea agregar el parámetro de Logtail max_read_buffer_size, establezca la variable de entorno como sls_max_read_buffer_size. Este parámetro especifica el tamaño máximo de una sola entrada de registro que Logtail puede leer, que en este ejemplo es de 524,288 bytes. Para consultar más parámetros, véase Set Logtail startup parameters.

• Correspondencia entre variables de entorno y parámetros de inicio de Logtail

  Para más detalles, consulte Environment variable descriptions.

Cuotas y límites

Cada cuenta de Alibaba Cloud puede crear hasta 200 Logstores y 50 Projects. Los límites de los recursos básicos de SLS pueden afectar la recopilación de registros para las aplicaciones de SAE, lo que podría causar problemas como periodos cortos de retención de registros o fallos en la recopilación. Para conocer más límites de uso, consulte Basic resource limits.

Facturación

El uso de Simple Log Service genera cargos adicionales. Para más detalles, consulte SLS billing.

Preguntas frecuentes

• ¿Admite la recopilación de registros de SAE la rotación de registros?

  Sí. Puede implementar la rotación de registros añadiendo un comodín al nombre del archivo de registro.

  Los comodines admitidos para nombres de archivo son el asterisco (*) y el signo de interrogación (?).

• No aparecen datos en la consola de SLS al consultar los registros de archivo. ¿Qué debo hacer?

  De forma predeterminada, SLS consulta los datos de los últimos 15 minutos. Si no aparecen datos en SLS, utilice Webshell para comprobar si su aplicación ha generado archivos de registro. Para más detalles, consulte Use Webshell to diagnose an application.

  • Si existen datos de registro, únase al grupo de DingTalk (ID de grupo: 32874633) y póngase en contacto con un experto técnico del producto para obtener asistencia.

  • Si no existen datos de registro, revise la configuración de su aplicación.