Tiet · Connect
Referencia de la interfaz: Cambio de marca ligero de octubre de 2026 · Verificado el 23 de octubre de 2026.
Tiet · Connect recibe mensajes de sistemas externos (HL7 v2 sobre MLLP, HTTP, archivos, Kafka, DICOMweb y otros), los procesa a través de un canal y los entrega a uno o más destinos. En el producto, un canal se muestra como una tubería. Esta página describe las funciones actuales de Connect y el grado de madurez de cada componente. Para crear una tubería paso a paso, consulte Crear una tubería de Connect.
Las etiquetas de disponibilidad y sus fechas de verificación se mantienen en el estado de Capacidad. El modo Hub utiliza el estado GA posterior confirmado por el propietario. El modo Spoke conserva la etiqueta Beta de la matriz a la espera de la confirmación de la disponibilidad de su versión actual. Las actualizaciones de estándares y otros límites de verificación se enumeran en esa página.
Dónde encontrarlo
Conectar está en la navegación izquierda debajo de Tiet · Connect: Network tiene las entradas Mesh, Pipes, Messages & DLQ y Transformers. Dentro de la consola de red el interruptor en la parte superior dice Mesh | Pipes | DLQ.
Por separado, Device Fleet (Dispositivos, Proveedores, Inscripción, Alertas, Automatizaciones, Configuración) administra los dispositivos conectados y los wearables. Consulte Wearables y Dispositivos.
La entrada Transformers está en la navegación, pero no hay ninguna página vinculada en las rutas del frontend. Existe una página Transformations independiente que dice "Próximamente". Se seleccionan los pasos de transformación dentro de una tubería, en el paso de procesamiento.
Antes de crear una tubería
Necesitas permiso para abrir la red, un origen y un destino accesibles, y las credenciales que requieran esos sistemas. Confirma si tu servidor Connect se ejecuta en modo independiente o en modo concentrador: las opciones de reintento y descarte solo están disponibles en modo concentrador.
- Abra Tiet · Connect → Network → Pipes y seleccione New pipe.
- Siga las instrucciones para crear una canalización Connect para configurar el origen, el procesamiento compatible y los destinos.
- Tras guardar, seleccione Resume para desplegar la tubería. Crearla por sí sola no inicia sus oyentes.
- Envía un mensaje de prueba sintético. Abre el mensaje Messages → In channel, inspecciona su carga útil y estado, y verifica que el destino haya recibido los datos esperados. Una confirmación de transporte exitosa por sí sola no prueba la asignación ni la escritura en el destino.
Modos de funcionamiento
Connect se ejecuta en uno de estos modos, elegido con la variable de entorno SERVER_MODE del servidor Connect:
| Modo | Madurez | Qué es |
|---|---|---|
standalone (predeterminado) | Georgia | Una instancia de Connect gestiona los canales, los conectores y la consola de red. No requiere una red troncal centralizada. |
hub | Georgia | Un concentrador con una red troncal NATS, un registro de nodos secundarios, enrutamiento y una cola de mensajes no entregados (DLQ) desde la que se pueden reintentar y descartar. |
spoke | Beta en la matriz retenida; disponibilidad actual no verificada. | Un nodo en una topología de concentrador. |
La conmutación por error entre nodos y una cola local en los nodos (resiliencia sin conexión) son Roadmap: no confíe en ellas.
Cuando Connect se ejecuta en modo independiente, la consola de red muestra el aviso "Modo independiente: sin red troncal del hub". Los nodos que aparecen en la lista son registros almacenados, y su estado solo se actualiza hasta su último latido.
Malla
Tiet · Connect → Network → Mesh muestra el hub y los radios registrados con insignias de salud: Conectado, Degradado, Obsoleto, Fuera de línea, En proceso o Desconocido. Un radio que informa estar en buen estado pero no ha enviado una señal de actividad durante más de 5 minutos se muestra como Stale.
Para agregar un nodo, use Add spoke en la vista Malla. Campos: Spoke ID (obligatorio, por ejemplo spoke-eu-west-1), un nombre; Region (por ejemplo eu-west-1 o on-prem), un punto final y capacidades. Programáticamente, POST /api/spokes/register requiere el token de servicio del nodo (SPOKE_SERVICE_TOKEN), no un token de usuario.
Tubería
Tiet · Connect → Network → Pipes muestra cada canal como una tarjeta de tubería, agrupada bajo On the mesh y Direct. El resumen en la parte superior muestra Spokes en vivo, Canales (desplegados del total), Hub, Promg msg/min (un promedio desde que cada spoke se registró, no una tasa actual) y Dead-letter. Filtros: All, On mesh, Direct, Needs attention. New pipe inicia el constructor de seis pasos.
Una tubería es un conector de origen, procesadores que se ejecutan en el orden indicado y uno o más destinos. La ruta es Direct (origen a destino en un solo proceso) o On mesh (raíz de origen, concentrador, rama de destino). La consola de tuberías también denomina "Fan-out" a una ruta con varios destinos.
La API Connect ignora las opciones de radio enviadas con la creación o actualización de un canal: solo el punto final de la ruta del hub (PUT /api/channels/:id/route, token de malla) puede establecer source_spoke_id y destination_spoke_id. Los On mesh selectores de radio del constructor los envían con el canal, por lo que una tubería que cree de esa manera aún puede aparecer como Direct. Verifique la ruta en el inspector después de guardar.
Salud de las tuberías
Haz clic en una tubería para abrir su inspector. El color y la etiqueta provienen de los indicadores del canal y sus contadores:
| Etiqueta | Significado |
|---|---|
| Stopped | El canal está desactivado. |
| Ready | Habilitado pero no desplegado, por lo que no hay nada escuchando. Una tubería que acaba de crear se encuentra en este estado. |
| Deployed | Implementado correctamente y sin errores. |
| Errors recorded | Se ha implementado y se ha detectado al menos un error desde que se creó el canal. |
| High error share | Los errores representan más del 20% de los mensajes entregados, incluyendo los mensajes con errores. |
Los contadores (Total recibido, Entregado, Filtrado, Errores, En cola, Latencia promedio) son acumulativos desde que se creó el canal. Una tubería con errores antiguos conserva la etiqueta "Errores registrados" aunque ahora funcione correctamente. "En cola" cuenta los mensajes que entraron en la cola, no la profundidad actual de la misma.
Pausar y reanudar
El pie de página del inspector tiene Pause / Resume, Messages, Edit (panel lateral para nombre, ruta, destinos y transformaciones) y Full editor (el constructor de seis pasos).
- El comando Pause desactiva el canal: los conectores de origen y destino se detienen y los procesos terminan las tareas en cola. Un receptor HL7 en pausa ya no acepta conexiones.
- Resume lo despliega de nuevo.
La pausa no retiene los mensajes para su posterior procesamiento: mientras una conexión está en pausa, el remitente recibe un error de conexión.
Mensajes y la perspectiva de la carta muerta
Messages abre un cajón con dos pestañas, In channel y Dead-letter. Consulta Crear una tubería Connect para saber cómo usarla.
Tiet · Connect → Network → DLQ (entrada de menú Messages & DLQ) muestra los mensajes fallidos de todos los canales, con un filtro de canal.
| Acción | Independiente (GA) | Modo concentrador (GA) |
|---|---|---|
| Lo que aparece en la lista DLQ | Mensajes cuyo estado es Error | Registros de la cola de mensajes no entregados con estado Pendiente, Reintentando, Descartado, Resuelto o Caducado |
| Reintentar / Repetir | No disponible | Disponible (individual, seleccionado o "Página de reproducción") |
| Desechar | No disponible para cartas muertas | Disponible; se requiere y registra un motivo. |
| Caducan | No disponible | La opción "Caducar por antigüedad" elimina los registros resueltos y descartados con más de N días de antigüedad (valor predeterminado: 7). |
| Número de reintentos y motivos de fallo | No se realiza seguimiento | Mostrado |
En modo independiente, la consola indica: "La cola de mensajes no entregados es de solo lectura". Para reenviar un mensaje que falló, corrija la causa y vuelva a enviarlo desde el origen.
Conectores (orígenes y destinos)
La lista de conectores en el constructor proviene del catálogo de conectores de Connect (internal/connectors/catalog.go), por lo que muestra lo que el motor puede ejecutar. La madurez proviene de la matriz de capacidades.
| Conector (tal como se indica en el constructor) | Fuente | Destino | Madurez |
|---|---|---|---|
| TCP (MLLP/HL7) | Sí | Sí | Georgia |
| HTTP / HTTPS | Sí | Sí | Georgia |
| WebSocket | Sí | Sí | Servidor GA, cliente Beta |
| Correo electrónico SMTP | No | Sí | Georgia |
| FHIR REST | Sí | Sí | Un destino que utiliza el conector HTTP. Comportamiento del paquete: consulte Crear una tubería Connect. |
| DICOMweb, oyente de DICOMweb | Sí | Solo DICOMweb | Georgia |
| DICOM (DIMSE) | Sí | Sí | Georgia |
| Almacenamiento DICOM | No | Sí | No aparece en la matriz. |
| CDA / C-CDA | Sí | Sí | GA (análisis sintáctico) |
| XDS.b (IHE) | No | Sí | Georgia |
| Sistema de archivos | Sí | Sí | Georgia |
| Salida de parquet | No | Sí | Georgia |
| Activo del espacio de datos | No | Sí | Punto final de extracción GA |
| Base de datos | Sí | Sí | PostgreSQL GA. MySQL y MongoDB están en la hoja de ruta, aunque la lista de controladores los indique. |
| Apache Kafka | Sí | Sí | Georgia |
| CloudEvents HTTP | Sí | No | No aparece en la matriz. |
| IoT / MQTT | Sí | Sí | Versión beta. Se conecta a un broker MQTT que usted proporcione. Connect no incluye un broker. |
| Hydra Pipeline | Sí | No | Ejecuta un flujo de trabajo implementado según un cronograma o una sola vez. |
| Hydra Segment | No | Sí | No aparece en la matriz. |
| Lago de datos de Cloudera | Sí | Sí | No aparece en la matriz. |
El EDI X12 se gestiona únicamente mediante un analizador en el código base de Connect. Los nodos de análisis y flujo de trabajo X12 están disponibles de forma general; esto no implica un conector de transporte dedicado. No existe un conector X12 ni un conector SAP IDoc.
Los tipos de mensajes HL7 ADT^A01, A03, A08 y ORU^R01 son de disponibilidad general (GA). Los mensajes ORM, SIU, VXU, BAR y de farmacia también son de disponibilidad general (GA).
Procesamiento en una tubería
El paso Procesamiento ofrece estas entradas (etiquetas como se muestra): Pipeline, Anonymizer, Filter, Tag Transformer, AI Inference, JavaScript, 6, HL7 to FHIR, FHIR to HL7, XPath, Regex. Cada una tiene On error configuración: Detener en caso de error, Omitir en caso de error o Volver a la JSONPath anterior en caso de error.
Por separado, el catálogo de transformadores del motor enumera estos transformadores integrados: HL7 v2.x a FHIR R4, IoT a HL7 (PCD DEC), Alerta a HL7 (PCD ACM), CDA a FHIR R4, FHIR R4 a CDA, MHD a XDS.b, XDS.b a MHD, Debezium CDC a FHIR R4 y JavaScript. XSLT, JSONPath y Template están en el catálogo marcados como planificados, aún no implementados.
Algunas opciones de procesamiento guardadas no se ejecutan. Una entrada no compatible también puede impedir que se cree la cadena de procesamiento DICOM del canal. Pruebe la carga útil convertida y la escritura de destino antes de utilizar una tubería.
| Opción | Limitación actual | ¿Qué hacer? |
|---|---|---|
| Pipeline | Ejecuta un flujo de trabajo en línea; necesita la conexión del motor de flujo de trabajo del servidor y el procesamiento agente habilitado. | Confirma que HYDRA_API_URL y que CONNECT_AGENTIC_PROCESSORS_ENABLED no es false |
| Filter, Anonymizer | Estos procesadores actúan únicamente sobre el contenido DICOM en formato JSON; otro contenido pasa a través de | Utilice datos de prueba DICOM e inspeccione el resultado. |
| Tag Transformer, AI Inference | El constructor guarda los identificadores que no coinciden con el registro del motor. | No confíe en estas entradas guardadas hasta que se haya corregido y probado la discrepancia del identificador. |
| HL7 to FHIR, FHIR to HL7, JavaScript, XPath, JSONPath, Regex | Las entradas de procesamiento guardadas no son ejecutadas por el registro del procesador en el backend auditado. | Utilice un flujo de trabajo verificado o la conversión de canal configurada por separado que se describe a continuación. |
| Conversión de canal HL7 a FHIR | Requiere transform_to_fhir=true; el constructor no tiene ningún campo para ello. | Configure a través de la API del canal y verifique el manejo del tipo de paquete y del destino. |
| Conversión de resultados de laboratorio de ORU | Requiere transformer_type=HL7_ORU_TO_FHIR y sus opciones a través de la API del canal. | Pruebe el paquete de transacciones resultante; esta asignación rechaza una conversión fallida. |
Para obtener detalles sobre la conversión paso a paso y el procesamiento por lotes, consulte HL7 a FHIR: lo que necesita saber. Los diagnósticos de ingeniería, incluidos los identificadores del procesador, permanecen en el registro de evidencia de la página.
Cuando FHIR batching está activado, se muestra un mensaje Queued hasta que el servidor FHIR responde, luego Sent o Error. Consulte Crear una canalización Connect.
Los procesadores que llaman a un flujo de trabajo lo ejecutan en línea. Si se establece en CONNECT_AGENTIC_PROCESSORS_ENABLED=false en el servidor Connect, esto se desactiva.
Pedidos
Por defecto, un canal distribuye los mensajes sin un orden específico. Si Max threads es mayor que 1, se pueden aplicar dos mensajes sobre el mismo paciente fuera de orden, por lo que una corrección puede ser sobrescrita por el mensaje que corrige. El canal ADT que Connect inicializa utiliza 25 subprocesos.
La opción Preserve per-key order (ordering_enabled, Beta, desactivada por defecto) mantiene los mensajes que comparten una clave de ordenación en orden de llegada entre los hilos. Las diferentes claves se siguen ejecutando en paralelo. La clave se deriva de la carga útil (HL7 PID-3, sujeto FHIR) a menos que se seleccione la opción Ordering key source (el motor acepta los valores hl7.pid3, fhir.subject o none). El orden se verifica solo a nivel de despacho, no de extremo a extremo.
Lo que no está disponible
- No hay opción TLS en el oyente MLLP en el catálogo de conectores. Finalice TLS delante de Connect.
- El cifrado en reposo con claves por organización y mTLS entre el concentrador y los nodos periféricos forman parte de la hoja de ruta.
- El creador de canales mediante arrastrar y soltar es Roadmap; el creador es un formulario paso a paso.
- La asignación de roles para administrador, operador y espectador está en la hoja de ruta.
- En Pipes no hay gráficos de rendimiento por minuto ni por hora. La vista de monitorización está en fase beta.
Solución de problemas
| Síntoma | Controlar |
|---|---|
| Una nueva tubería muestra Ready y no llega nada. | Create channel no se despliega. Abra la tubería y haga clic en Resume. |
| Los mensajes son rechazados con un error de conexión. | La tubería está en pausa o lista (no desplegada), o el puerto no es accesible desde el remitente. |
| Se muestra un mensaje Error | Abra Messages → In channel, selecciónelo y lea Errors. El texto indica el destino que está fallando. |
El error dice Queue full | La cola del canal permaneció llena más allá del tiempo de espera de cola llena del motor y el mensaje se descartó. Generar Queue buffer size o Max threads. |
| La cola de denegación de servicio (DLQ) no tiene botón de reintento. | El servidor Connect está en modo independiente. Consulte la tabla anterior. |
| El radio muestra Stale | No se ha registrado ningún latido cardíaco durante más de 5 minutos. |
¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..



