Registros de asistencia

Además de usar el nodo support para recuperar información de asistencia, también puedes recuperar registros de Docker, registros de AWS e identificadores de solicitudes HTTP para solucionar problemas.

En este documento se incluye lo siguiente:

• Recuperación de registros (locales)
• Información del registro de bloqueos (local)
• Recuperación de registros de Kubernetes
• Recuperación de registros (AWS)
• Recopilación de identificadores de solicitudes HTTP

Consulta Contactar con el servicio de asistencia para obtener más información sobre cómo abrir una solicitud de asistencia directa.

Recuperar registros de Docker

Mediante WADebug (método preferido)

Puedes usar la herramienta WADebug para recopilar y subir registros automáticamente. Recibirás un valor de run_id como parte de la respuesta, al que puedes hacer referencia en la asistencia directa para agilizar las investigaciones. Solo tienes que ejecutar el comando siguiente:

  wadebug logs --send

Nota: En el modo de alta disponibilidad o conexión múltiple, en el que los contenedores se descargan en uno o varios hosts, debes iniciar sesión en cada uno de ellos, descargar WADebug y ejecutar el comando anterior. Obtendrás un valor de run_id de cada ejecución del comando realizada correctamente, al que puedes hacer referencia en la asistencia directa para agilizar las investigaciones.

Mediante Docker

Si no puedes usar la herramienta WADebug, puedes utilizar el comandodocker logs para recuperar los registros de cada contenedor de forma individual. Por ejemplo, para recuperar los registros del contenedor waweb, debes ejecutar el comando siguiente:

docker logs <container id of waweb> >> waweb.log

Puedes usar las múltiples opciones del comando docker logs para limitar el tamaño de los archivos de registro. Por ejemplo, para obtener solo las últimas 1000 líneas de registros del contenedor waweb, debes ejecutar el comando siguiente:

docker logs <container id of waweb> --tail 1000 >> waweb.log

Si solo quieres obtener los registros del contenedor waweb de un periodo de tiempo concreto, ejecuta el comando con las opciones --since y --until, por ejemplo:

docker logs <container id of waweb> --since 2020-01-20T20:00:00Z --until 2020-01-21T08:00:00Z >> waweb.log

Ejecuta el comando con todos los contenedores de WhatsApp y envía los archivos a WhatsApp para su análisis y depuración. Consulta la documentación oficial del comando docker logs para ver más opciones.

Nota: Todos los registros de contenedor se encuentran en la zona horaria GMT. Debes pasar las marcas de tiempo GMT a los parámetros --since y --until.

Mediante Docker Compose

Para obtener todos los registros de todos los contenedores de WhatsApp, ejecuta el comando siguiente:

WA_API_VERSION=new-whatsapp-version docker-compose logs > debug_output.txt

Nota: Este comando puede generar archivos de registro muy grandes. Consulta la sección "Mediante Docker" para ver las opciones de recuperación de registros de menor tamaño y más relevantes.

Puedes enviar estos archivos a WhatsApp para su análisis y depuración.

Registros de bloqueos

Hemos implementado un nuevo sistema de registro de bloqueos en la versión 2.53, que guarda archivos de volcado cada vez que se produce un bloqueo. Estos archivos, que se conocen como volcados de memoria, se almacenan en el directorio logs/ y se conservan durante 30 días. Los archivos solo se almacenan localmente en las máquinas y se pueden recuperar de la misma forma que los archivos de registro. Los volcados de memoria pueden incluir datos de memoria asociados al proceso bloqueado.

Recuperar registros de Kubernetes

Mediante kubectl

Para obtener los registros de un determinado servicio implementado, como la aplicación web, ejecuta el comando siguiente en la configuración de Kubernetes:

kubectl logs deployments/whatsapp-web-deployment > whatsapp-web-deployment.txt

Puedes enviar el archivo a WhatsApp para su análisis y depuración.

Recuperar registros de AWS

Sigue los pasos que se indican a continuación para recuperar los registros en una configuración de AWS:

Establecer el valor de Rollback on Failure en No para garantizar que los registros no se eliminen en caso de error

Esta acción se debe realizar durante el paso de creación o actualización de la pila, como se muestra a continuación:

Obtener los eventos y registros de creación de la pila de CloudFormation desde la consola de CloudWatch

Conectarse a la instancia de EC2 (si se ha creado correctamente)

Sigue la guía de AWS para obtener información sobre cómo utilizar SSH en la instancia de EC2. Ten en cuenta que durante la creación o actualización de la pila de la API de WhatsApp Business, puedes elegir usar una VPC pública o privada. Con una VPC privada, debes seguir las instrucciones de la sección sobre cómo conectarse de forma segura a instancias de Linux que se ejecuten en una VPC privada de Amazon.

Obtener registros

Cuando tengas acceso al contenedor, recupera los registros siguientes y adjúntalos a una solicitud de asistencia directa.

1. sudo docker logs ecs-agent > ecs-agent.log
2. Comprime y recupera las entradas /var/log de todas las instancias de EC2 que haya creado la pila.
3. Descarga WADebug en todas las instancias de EC2 y ejecuta los comandoswadebug logs para recopilar todos los registros de contenedor.
4. Si no se puede usar WADebug en el paso 3, ejecuta los comandos que se incluyen a continuación para recopilar los registros de forma manual:
   • Ejecuta docker ps -a para enumerar todos los contenedores en ejecución y compartir la salida.
   • Ejecuta docker logs <docker container id of the core app> >> wacore.log y comparte los registros.
   • Ejecuta docker logs <docker container id of the web app> >> waweb.log y comparte los registros.
   • Ejecuta docker cp <docker container id of the web app>:/var/log/whatsapp/web.log ./web.log y comparte los registros.
   • Ejecuta docker cp <docker container id of the web app>:/var/log/lighttpd/error.log ./error.log y comparte los registros.

Historial de actividad

Si no se ha creado la instancia de EC2, se necesita el historial de actividad del grupo de Auto Scaling correspondiente. Dicho historial se puede encontrar en la consola de EC2 -> Auto Scaling -> Auto Scaling Groups (Grupos de Auto Scaling). A continuación, selecciona el grupo correspondiente a la pila que tiene el problema y haz clic en la pestaña Activity History (Historial de actividad).

Recopilar identificadores de solicitudes HTTP

A partir de la versión v2.21.3, la API de WhatsApp Business genera identificadores de solicitud únicos para cada solicitud HTTP entrante que recibe. Dichos identificadores se utilizan para ayudar a localizar registros relacionados con una solicitud concreta a fin de solucionar los problemas rápidamente. Si quieres notificar un error, incluye los valores de los encabezados de respuesta X-Request-ID y X-Internal-Request-IDS en la solicitud para ayudarnos a localizar y reproducir el problema.