Skip to main content

¿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.