¿Dónde se encuentran los registros de Medulla?
Medulla utiliza varios registros que permiten diagnosticar el funcionamiento de los agentes, los servicios del servidor, los despliegues, la inscripción de las máquinas y las actualizaciones.
El registro que debe consultarse depende del componente o la funcionalidad en cuestión.
Nota:
Antes de reiniciar un servicio o modificar su configuración, se recomienda consultar los registros correspondientes para identificar el origen del problema.
1. Tabla resumen de los principales registros de Medulla
| Función | Registro / comando | Uso |
|---|---|---|
| Agente de Medulla para Windows | C:\Program Files\Medulla\var\log\xmpp-agent-machine.log |
Conexión, inscripción, reconfiguración y funcionamiento del agente |
| Asignación de relays | /var/log/mmc/master-asse.log |
Asignación de máquinas a los servidores de relay |
| Inscripción de máquinas | /var/log/mmc/master-reg.log |
Inscripción y reinscripción de los agentes |
| Windows Updates | /var/log/mmc/master-upd.log |
Procesamiento de las KB y búsqueda de actualizaciones |
| Servicios de Medulla | journalctl -u NOMBRE_DEL_SERVICIO |
Diagnóstico de un servicio de systemd |
| SSH en Windows | C:\ProgramData\ssh\logs\ |
Diagnóstico del servidor OpenSSH de Windows |
2. Registros del agente de Medulla en Windows
En una máquina con Windows, el registro principal del agente Medulla es:
C:\Program Files\Medulla\var\log\xmpp-agent-machine.log
Este archivo permite, entre otras cosas, diagnosticar:
- el inicio del agente;
- la conexión del agente a Medulla;
- la inscripción de la máquina;
- las reconfiguraciones del agente;
- la información enviada por el agente;
- el envío de las KB de Windows;
- algunos problemas que se han producido durante un despliegue.
Buscar una reconfiguración del agente
El siguiente mensaje indica que se ha iniciado una reconfiguración:
We start a reconfiguration of the medulla agent
Para buscar este mensaje desde Windows:
find /c "We start a reconfiguration of the medulla agent" "C:\Program Files\Medulla\var\log\xmpp-agent-machine.log"
Un número elevado de ocurrencias en un breve periodo de tiempo puede indicar que el agente se está reconfigurando de forma repetida.
3. Registros de asignación de servidores de relay
Las operaciones relacionadas con la asignación de una máquina a un servidor de relay pueden consultarse en:
/var/log/mmc/master-asse.log
Este registro resulta especialmente útil para diagnosticar:
- la asignación de un relay a una máquina;
- los cambios de asignación;
- las reconfiguraciones anormalmente frecuentes;
- los problemas relacionados con las reglas de asignación.
Mostrar las últimas líneas
tail -n 100 /var/log/mmc/master-asse.log
Seguir el registro en tiempo real
tail -f /var/log/mmc/master-asse.log
Buscar una máquina
grep -i "NOMBRE_DE_LA_MAQUINA" /var/log/mmc/master-asse.log
Identificar las máquinas reconfiguradas varias veces
La guía de explotación también proporciona el siguiente comando para contabilizar las reconfiguraciones registradas a lo largo del día:
grep "$(date +'%Y-%m-%d') .*Configuring machine" /var/log/mmc/master-asse.log* | awk '{print $NF}' | sort | uniq -c | sort -n
Este comando permite, en particular, detectar una máquina que se haya reconfigurado con una frecuencia anómala.
4. Registros de inscripción de las máquinas
La inscripción de las máquinas se registra en:
/var/log/mmc/master-reg.log
Este registro resulta especialmente útil cuando una máquina:
- no se registra en Medulla;
- tarda un tiempo anormalmente largo en aparecer;
- se vuelve a registrar con regularidad;
- presenta una incoherencia entre sus interfaces de red y su inscripción.
Mostrar las últimas líneas
tail -n 100 /var/log/mmc/master-reg.log
Seguir las inscripciones en tiempo real
tail -f /var/log/mmc/master-reg.log
Buscar una máquina
grep -i "NOMBRE_DE_LA_MAQUINA" /var/log/mmc/master-reg.log
Contar las inscripciones de las máquinas
El siguiente comando permite conocer el número de inscripciones de las máquinas a lo largo del día:
grep "$(date +'%Y-%m-%d') .*Registering machine" /var/log/mmc/master-reg.log* | cut -f 8 -d ' ' | cut -f 1 -d'/' | sort | uniq -c | sort -n
Se puede utilizar, en particular, para identificar una máquina que se registra con una frecuencia anómala.
5. Registros del módulo Windows Updates
Los procesos relacionados con las actualizaciones de Windows se pueden consultar en:
/var/log/mmc/master-upd.log
Este registro permite, entre otras cosas, verificar la información transmitida por las máquinas al módulo Updates.
Comprobar el envío de las KB desde la máquina
En el registro del agente de Windows, la lista de KB instaladas puede aparecer con el siguiente formato:
"kb_list": "(5037592,5003791,5026037,...)"
Para buscar esta información:
findstr "kb_list" "C:\Program Files\Medulla\var\log\xmpp-agent-machine.log"
Comprobar la recepción de las KB en el servidor
Cuando el nivel de registro del componente Updates está en DEBUG, la lista de KB instaladas se puede encontrar en:
/var/log/mmc/master-upd.log
Por ejemplo:
Installed KB list: (5037592,5003791,5026037,...)
Para buscar estas líneas:
grep "Installed KB list" /var/log/mmc/master-upd.log
Nota:
La comparación entre la lista kb_list presente en el agente y la lista recibida en master-upd.log permite comprobar que la información de Windows Updates se transmite correctamente al servidor.
6. Registros de los servicios de Medulla con journalctl
Los servicios gestionados por systemd pueden diagnosticarse con el comando journalctl.
Consultar los registros de un servicio
journalctl -u NOMBRE_DEL_SERVICIO
Por ejemplo:
journalctl -u mmc-agent
Mostrar los últimos 100 eventos
journalctl -u NOMBRE_DEL_SERVICIO -n 100
Ejemplo:
journalctl -u mmc-agent -n 100
Seguir un servicio en tiempo real
journalctl -u NOMBRE_DEL_SERVICIO -f
Mostrar los registros desde el último inicio
journalctl -u NOMBRE_DEL_SERVICIO -b
Consejo:
Cuando un servicio de Medulla presente un error, compruebe primero su estado con systemctl status y, a continuación, utilice journalctl para obtener los detalles de los eventos.
7. Comprobar el estado de un servicio antes de consultar sus registros
Antes de analizar los registros, compruebe el estado del servicio en cuestión:
systemctl status NOMBRE_DEL_SERVICIO
Por ejemplo:
systemctl status mmc-agent
Para obtener únicamente su estado:
systemctl is-active mmc-agent
Un servicio que funciona con normalidad devuelve:
active
Los siguientes estados requieren un análisis:
inactive
failed
8. Registros SSH en máquinas Windows
Cuando el problema afecte a la conexión SSH a una máquina Windows, comience por comprobar el estado del servicio:
sc query sshd
A continuación, puede consultar los registros de OpenSSH con:
powershell Get-Content C:\ProgramData\ssh\logs\*.log
Estos registros pueden resultar especialmente útiles en caso de errores como:
Permission denied
ssh_exchange_identification: read: Connection reset by peer
Nota:
Los problemas relacionados con SSH y con la cuenta pulseuser pueden requerir comprobaciones adicionales en la máquina Windows.
9. Buscar un error en un registro
El comando grep permite buscar rápidamente información en los registros del servidor.
Buscar una máquina
grep -i "NOMBRE_DE_LA_MAQUINA" /var/log/mmc/NOMBRE_DEL_LOG.log
Buscar un error
grep -i "error" /var/log/mmc/NOMBRE_DEL_LOG.log
Buscar varios tipos de errores
grep -Ei "error|warning|failed|abort" /var/log/mmc/NOMBRE_DEL_LOG.log
Incluir los archivos de registro archivados
grep -i "NOMBRE_DE_LA_MAQUINA" /var/log/mmc/NOMBRE_DEL_LOG.log*
Consejo:
En caso de incidencia, busque, si es posible, el nombre de la máquina y la hora exacta en que se produjo el problema para reducir el volumen de información que hay que analizar.
10. ¿Qué registro debe consultar en función del problema?
| Problema | Primer registro que debe consultar |
|---|---|
| Máquina sin conexión | C:\Program Files\Medulla\var\log\xmpp-agent-machine.log |
| Máquina que no se registra | /var/log/mmc/master-reg.log y, a continuación, el registro del agente |
| Máquina que se reconfigura periódicamente | /var/log/mmc/master-asse.log y el registro del agente |
| Asignación incorrecta a un relay | /var/log/mmc/master-asse.log |
| Windows Updates / KB no enviadas | C:\Program Files\Medulla\var\log\xmpp-agent-machine.log y, a continuación, /var/log/mmc/master-upd.log |
| Error en el servicio Medulla | journalctl -u NOMBRE_DEL_SERVICIO |
| Problema con SSH en Windows | C:\ProgramData\ssh\logs\ |
11. Aumentar temporalmente el nivel de registro
Cuando la información disponible en los registros no sea suficiente para identificar el origen de un problema, algunos componentes de Medulla pueden configurarse temporalmente con un nivel de registro DEBUG.
Atención:
El nivel DEBUG genera una cantidad mucho mayor de registros. Debe utilizarse temporalmente durante el diagnóstico y desactivarse una vez recopilada la información necesaria.
El procedimiento completo se describe en la documentación:
Activar temporalmente los registros DEBUG de Medulla
12. Buenas prácticas de diagnóstico
- identificar con precisión la máquina, el relay o el servicio en cuestión;
- anotar la fecha y la hora del incidente;
- comenzar por los registros correspondientes a la funcionalidad en cuestión;
- buscar el nombre de la máquina en los registros siempre que sea posible;
- consultar el estado del servicio antes de reiniciarlo;
- conservar los registros correspondientes al periodo del incidente;
- activar el nivel DEBUG solo durante el tiempo necesario para el diagnóstico.
Recomendación:
Para diagnosticar eficazmente un incidente de Medulla, comience por identificar el componente afectado; a continuación, consulte su registro y busque los eventos correspondientes a la hora exacta en que se produjo el problema. La comparación de los registros de la máquina cliente y del servidor suele permitir identificar rápidamente en qué etapa falló la comunicación o el procesamiento.