L Luna Labs · Soporte
Solución de problemas

Diagnóstico de problemas con instrumentos ASTM

Cuando el analizador envía resultados pero algo falla: cómo leer el log de mensajes, entender los estados de error y resolver los problemas más comunes.

Equipo Luna Labs 9 min de lectura Responsable

En resumen

Luna Labs registra cada mensaje ASTM recibido con un estado que indica si los resultados se aceptaron o por qué fallaron. La mayoría de los problemas se resuelven verificando tres cosas: que el Sender ID del instrumento coincida, que existan mapeos de código configurados, y que la orden esté creada con el folio correcto antes de que el analizador envíe resultados.

Antes de diagnosticar

Asegúrate de tener claros estos conceptos (si no, lee primero Integración con instrumentos):

  • Sender ID: el identificador que el analizador envía en cada mensaje ASTM. Debe coincidir con el que configuraste en Luna Labs.
  • Mapeo de códigos: la tabla que traduce el código que usa el instrumento (por ejemplo, "GLU1") al código del catálogo de Luna Labs (por ejemplo, "GLU").
  • Bridge ASTM: el servidor TCP de Luna Labs que escucha mensajes del analizador (por defecto en el puerto 9100).

El log de mensajes

Tu herramienta principal de diagnóstico es el log de mensajes de cada instrumento:

  1. Ve a Instrumentos y abre el instrumento que tiene problemas.
  2. Cambia a la pestaña Mensajes.
  3. Verás cada mensaje ASTM recibido, con fecha, estado y detalles del error.

El log se actualiza automáticamente cada 5 segundos. Si no ves ningún mensaje, el problema es de conectividad (ve a Problemas de conectividad).

Estados de error

Cada mensaje recibido tiene uno de estos estados:

EstadoSignificadoAcción
acceptedTodos los resultados se guardaron correctamenteNinguna — todo bien
partialAlgunos resultados se aceptaron, otros noRevisa cuáles fallaron en los detalles del mensaje
no_orderNo existe una orden con ese folioCrea la orden primero, o verifica que el folio sea correcto
no_mappingEl instrumento no tiene mapeos configuradosConfigura los mapeos de código en la pestaña Mapeos
unknown_senderEl Sender ID no coincide con ningún instrumentoVerifica el Sender ID en la configuración del instrumento
errorError de validación del mensaje ASTMRevisa el detalle — puede ser un formato incorrecto o checksum inválido

unknown_sender

Este es el error más común al conectar un instrumento por primera vez.

Causa: el Sender ID que envía el analizador no coincide con el que registraste en Luna Labs, o el instrumento está marcado como inactivo.

Cómo resolver:

  1. Revisa el detalle del mensaje en el log — ahí puedes ver el Sender ID que envió el analizador.
  2. Ve a Instrumentos y abre el instrumento.
  3. Compara el campo Sender ID con el que aparece en el mensaje. Deben ser idénticos (mayúsculas y minúsculas importan).
  4. Si el instrumento existe pero está inactivo, actívalo.
Tip: el Sender ID lo configura el proveedor del equipo. Consulta el manual de tu analizador o pide al ingeniero de servicio que te confirme el valor exacto.

no_order

Causa: el analizador envió resultados con un folio que no existe en Luna Labs.

Cómo resolver:

  • Verifica que la orden se haya creado antes de procesar la muestra en el analizador.
  • Compara el folio que envió el analizador (visible en el detalle del mensaje) con el folio de la orden en Luna Labs.
  • El folio debe coincidir exactamente. Si tu analizador usa un campo distinto (por ejemplo, Sample ID), confirma que estés capturando el folio correcto al registrar la muestra en el equipo.

no_mapping

Causa: el instrumento está registrado pero no tiene mapeos de código configurados.

Cómo resolver:

  1. Abre el instrumento y ve a la pestaña Mapeos.
  2. Agrega un mapeo por cada analito que reporta el equipo. Por ejemplo: código del instrumento GLU1 → código del catálogo GLU.
  3. Guarda y pide al analizador que reenvíe los resultados (o procesa una nueva muestra).

partial

Causa: el analizador envió varios resultados en un solo mensaje. Algunos coincidieron con analitos de la orden, otros no.

Cómo resolver:

  • Abre el detalle del mensaje para ver cuáles resultados se aceptaron y cuáles se rechazaron.
  • Los rechazos más comunes son: código del instrumento sin mapeo, o analito no incluido en esa orden.
  • Si falta un mapeo, agrégalo. Si el analito no estaba en la orden, probablemente el analizador reportó un estudio que no se solicitó — esto es normal y no requiere acción.

Problemas de conectividad

Si el log de mensajes está vacío y el analizador debería estar enviando, el problema es de red:

  1. 1

    Verifica que el bridge ASTM esté activo

    El bridge se inicia automáticamente con el servidor. Revisa los logs del servidor para confirmar que el puerto TCP (por defecto 9100) está escuchando.

  2. 2

    Confirma la IP y el puerto en el analizador

    El analizador debe apuntar a la IP del servidor de Luna Labs y al puerto configurado (variable INSTRUMENT_TCP_PORT, por defecto 9100). Confirma con el ingeniero de servicio del equipo.

  3. 3

    Revisa el firewall

    Asegúrate de que el puerto TCP esté abierto en el firewall del servidor. Si estás en una red hospitalaria, es posible que el equipo de TI necesite habilitar la comunicación.

  4. 4

    Prueba la conexión manualmente

    Si tienes acceso a una terminal, puedes verificar con telnet <IP_servidor> 9100. Si la conexión se rechaza, el problema es de red o firewall.

Importante: si cambiaste la variable INSTRUMENT_TCP_HOST de 127.0.0.1 a 0.0.0.0 para aceptar conexiones de red, asegúrate de que el firewall proteja el puerto. No expongas el puerto ASTM a Internet.

Siguientes pasos