Registros de asistencia

Además de usar el nodo support para recuperar tu información de compatibilidad, también puedes recuperar registros de Docker y AWS, e identificadores de solicitudes HTTP para corregir errores.

En este documento, se explica lo siguiente:

• Recuperar registros (en las instalaciones)
• Información de registro de bloqueo (en las instalaciones)
• Recuperar registros de Kubernetes
• Recuperar registros (AWS)
• Recopilar identificadores de solicitudes HTTP

Consulta comunícate con Soporte para obtener más información sobre cómo abrir un ticket de asistencia directa.

Recuperar registros de Docker

Uso de WADebug (preferido)

Puedes usar la herramienta WADebug para recopilar y subir registros automáticamente. Como parte de la respuesta, recibirás un run_id, que puedes proporcionar a la asistencia directa para acelerar las investigaciones. Basta con ejecutar el siguiente comando:

  wadebug logs --send

Nota: Para el modo Alta disponibilidad/Conexión múltiple, donde los contenedores están instalados en uno o varios hosts, debes iniciar sesión en cada host, instalar WADebug y ejecutar el comando mencionado anteriormente. Recibirás un run_id con cada ejecución correcta del comando, que puedes proporcionar a la asistencia directa para acelerar las investigaciones.

Uso de Docker

Si no puedes utilizar la herramienta WADebug, puedes usar el comandodocker logs para obtener registros de cada uno de los contenedores. Por ejemplo, para recuperar registros del contenedor waweb, ejecuta el siguiente comando:

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

Puedes usar las diferentes opciones del comando docker logs para limitar el tamaño de los archivos de registro. Por ejemplo, para obtener solamente las últimas 1.000 líneas de registros del contenedor waweb, ejecuta el siguiente comando:

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

Para obtener solamente los registros del contenedor waweb entre una duración específica, 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 esos archivos a WhatsApp para su análisis y depuración. Consulta la documentación oficial de docker logs para obtener más opciones.

Nota: La zona horaria de todos los registros de contenedor es GMT. Debes pasar las marcas de tiempo GMT a parámetros --since y --until.

Uso de Docker Compose

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

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

Nota: Este comando puede generar archivos de registro muy grandes. En la sección "Uso de Docker", encontrarás opciones que permiten recuperar registros más pequeños y relevantes.

Luego, podrás enviar estos archivos a WhatsApp para que los analicen y los depuren.

Registros de bloqueos

Implementamos un nuevo sistema de bloqueo en la versión 2.53, que guarda archivos de volcado siempre que se produce un bloqueo. Estos archivos, conocidos como volcados de bloqueo, se almacenan en el directorio logs/ y se mantienen por 30 días. Los archivos solo se almacenan localmente en las máquinas y se pueden recuperar de la misma manera que los archivos de registro. Los volcadores de bloqueo pueden incluir datos de memoria asociados con el hilo bloqueado.

Recuperar registros de Kubernetes

Uso de kubectl

Para obtener registros para un servicio implementado en particular, como Webapp, ejecuta el siguiente comando en la configuración de Kubernetes:

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

A continuación, podrás enviar el archivo a WhatsApp para el análisis y la depuración.

Recuperar registros de AWS

Sigue los pasos que figuran debajo para capturar los registros con AWS:

Establece Rollback on Failure en No para asegurarte de que no se eliminen los registros ante un error.

Esto se debe configurar durante el paso de creación y actualización de pilas, como se ve a continuación:

Obtén registros y eventos de creación de pilas de CloudFormation de la consola de CloudWatch

Conéctate a tu instancia de EC2 (si se crea correctamente)

Sigue la guía de AWS sobre cómo usar la herramienta SSH en la instancia de EC2. Ten en cuenta que, durante la creación y actualización de pilas de la API de WhatsApp Business, puedes optar por usar una VPC privada o pública. Con una VPC privada, debes seguir las indicaciones de la sección Establecer una conexión segura con instancias de Linux que se ejecutan en una VPC privada de Amazon.

Obtener registros

Una vez que tengas acceso al contenedor, captura los siguientes registros y adjúntalos a un ticket de asistencia directa.

1. sudo docker logs ecs-agent > ecs-agent.log
2. Comprime y recupera /var/log de todas las instancias de EC2 creadas por la pila
3. Instala WADebug en todas las instancias de EC2 y ejecuta los comandos wadebug logs para recopilar todos los registros del contenedor.
4. Si WADebug no se puede usar en el paso 3, ejecuta los siguientes comandos para recopilar registros manualmente:
   • Ejecuta docker ps -a para listar todos los contenedores en ejecución y compartir el resultado.
   • 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 crea la instancia de EC2, se necesita un historial de actividad del grupo de escalamiento automático correspondiente. Se puede hallar en EC2 console -> Auto Scaling -> Auto Scaling Groups. Luego, selecciona el grupo correspondiente para la pila que tenga el problema y selecciona la pestaña Historial de actividad.

Recopilar identificadores de solicitudes HTTP

A partir de la v2.21.3, la API de WhatsApp Business genera identificadores de solicitudes únicos para cada solicitud HTTP entrante que recibe. Estos identificadores de solicitudes se usan para ayudar a marcar registros relacionados con una solicitud en particular y solucionar así problemas rápidamente. Si deseas notificar un error, incluye en el ticket los valores de los encabezados X-Request-ID y X-Internal-Request-IDS de la respuesta con el fin de identificar y reproducir el problema.