Stiamo disattivando l'API On-Premises. Consulta il nostro documento Disattivazione API On-Premises per i dettagli e per scoprire come eseguire la migrazione alla nostra API Cloud di nuova generazione.
Registri per l'assistenza
Come supporto alla risoluzione di eventuali problemi, oltre a utilizzare il nodo support per acquisire le informazioni per l'assistenza, puoi recuperare anche i registri Docker e AWS e gli ID delle richieste HTTP.
Questo documento tratta gli argomenti seguenti:
Consulta Contattare l'assistenza per maggiori informazioni sull'apertura di un ticket per l'Assistenza diretta.
Recupero dei registri Docker
Uso di WADebug (metodo preferito)
Puoi utilizzare lo strumento WADebug per recuperare e caricare automaticamente i registri. Nella risposta riceverai un run_id, che potrai indicare all'Assistenza diretta per accelerare gli approfondimenti. Ti basterà eseguire il comando seguente:
wadebug logs --send
Nota: per la modalità High Availability/Multiconnect in cui i contenitori sono installati su uno o più host, devi accedere a ciascun host, installare WADebug ed eseguire il comando precedente. Riceverai un run_id da ogni esecuzione del comando andata a buon fine, che potrai indicare all'Assistenza diretta per accelerare gli approfondimenti.
Uso di Docker
Se non puoi usare lo strumento WADebug, usa il comandodocker logs per recuperare i registri da ogni singolo contenitore. Ad esempio, per recuperare i registri dal contenitore waweb, esegui il comando seguente:
docker logs <container id of waweb> >> waweb.log
Puoi usare varie opzioni del comando docker logs per limitare le dimensioni dei file di registro. Ad esempio, per recuperare solo le ultime 1000 righe dei registri dal contenitore waweb, esegui il comando seguente:
docker logs <container id of waweb> --tail 1000 >> waweb.log
Per ottenere i registri del contenitore waweb relativi esclusivamente a uno specifico intervallo di tempo, esegui il comando con le opzioni --since e --until, ad esempio:
docker logs <container id of waweb> --since 2020-01-20T20:00:00Z --until 2020-01-21T08:00:00Z >> waweb.log
Esegui il comando con tutti i contenitori di WhatsApp e invia i file a WhatsApp per scopi di analisi e debug. Per altre opzioni, consulta la documentazionedocker logs ufficiale.
Nota: tutti i registri dei contenitori sono nel fuso orario GMT. Ai parametri --since e --until devi passare marche temporali GMT.
Uso di Docker Compose
Per ottenere tutti i registri da tutti i contenitori WhatsApp, esegui il comando seguente:
WA_API_VERSION=new-whatsapp-version docker-compose logs > debug_output.txt
Nota: questo comando può generare file di registro molto grandi. Consulta la sezione "Uso di Docker" per le opzioni per recuperare registri di dimensioni minori e più pertinenti.
Puoi quindi inviare i file a WhatsApp per analisi e debug.
Registri degli arresti anomali
Abbiamo implementato un nuovo sistema di registro degli arresti anomali nella versione 2.53, che salva i file di dump ogni volta che si verifica un arresto anomalo. Questi file, noti come crash dump, sono memorizzati nella directory logs/ e conservati per 30 giorni. I file sono memorizzati solo localmente su macchine e possono essere recuperati nello stesso modo dei file di registro. I crash dump possono includere dati di memoria associati ai thread che si sono arrestati in maniera anomala.
Recupero dei registri Kubernetes
Uso di kubectl
Per ottenere i registri per uno specifico servizio distribuito, come Webapp, nella configurazione Kubernetes esegui il comando seguente:
kubectl logs deployments/whatsapp-web-deployment > whatsapp-web-deployment.txt
Puoi quindi inviare i file a WhatsApp per scopi di analisi e debug.
Recupero dei registri AWS
Per recuperare i registri in una configurazione AWS, attieniti alla procedura seguente:
Imposta Rollback on Failure su No per avere la certezza che i registri non vengano eliminati in caso di errore.
Questa impostazione deve essere definita durante la fase di creazione/aggiornamento degli stack, come mostrato di seguito:
Recupero di registri ed eventi di creazione di stack CloudFormation dalla console CloudWatch
Connessione all'istanza EC2 (se creata correttamente)
Segui la guida AWS per scoprire come connetterti tramite SSH all'istanza EC2. Durante la creazione/l'aggiornamento degli stack dell'API di WhatsApp Business, puoi scegliere se utilizzare un VPC privato o pubblico. Con un VPC privato, devi seguire la sezione Securely Connect to Linux Instances Running in a Private Amazon VPC.
Recupero dei registri
Dopo aver ottenuto l'accesso al contenitore, recupera i registri seguenti e allegali a un ticket dell'Assistenza diretta.
sudo docker logs ecs-agent > ecs-agent.log- Comprimi in un file .zip e recupera /var/log di tutte le istanze EC2 create dallo stack.
- Installa WADebug su tutte le istanze EC2 ed esegui il comando
wadebug logsper recuperare tutti i registri dei contenitori. - Se nel passaggio 3 non è possibile usare
WADebug, esegui i comandi seguenti per recuperare i registri manualmente:- Esegui
docker ps -aper ottenere un elenco di tutti i contenitori in esecuzione e condividi l'output. - Esegui
docker logs <docker container id of the core app> >> wacore.loge condividi i registri. - Esegui
docker logs <docker container id of the web app> >> waweb.loge condividi i registri. - Esegui
docker cp <docker container id of the web app>:/var/log/whatsapp/web.log ./web.loge condividi i registri. - Esegui
docker cp <docker container id of the web app>:/var/log/lighttpd/error.log ./error.loge condividi i registri.
Cronologia attività
Se l'istanza EC2 non viene creata, è necessaria la Cronologia attività dell'Auto scaling group appropriato, disponibile in EC2 console -> Auto Scaling -> Auto Scaling Groups. Seleziona il gruppo appropriato per lo stack che presenta problemi e quindi la tab Activity History.
Acquisizione degli ID delle richieste HTTP
A partire dalla v2.21.3, l'API di WhatsApp Business genera ID richieste unici per ogni richiesta HTTP in ingresso ricevuta, utilizzati per individuare i registri relativi a una specifica richiesta e accelerare la risoluzione dei problemi. Se desideri segnalare un bug, includi i valori delle intestazioni della risposta X-Request-ID e X-Internal-Request-IDS nel ticket per aiutarci a individuare e riprodurre il problema.