Verificar y desplegar

Una máquina está desplegada cuando openlatch doctor no informa de ningún problema y la consola tiene su registro. Esta página demuestra ambas cosas y después amplía el despliegue en tres oleadas.

Verificar una máquina

Ejecuta los dos comandos en cada máquina que instales, en este orden.

openlatch status
openlatch doctor

openlatch status responde a una pregunta: ¿está esta máquina cubierta ahora mismo? Un buen resultado muestra la máquina conectada a la consola, políticas presentes en la máquina y cada agente de la máquina conectado.

openlatch doctor responde a la pregunta más difícil: ¿es cierto ese informe? Muestra una causa y una solución para cada cosa que encuentra. Un buen resultado es que no encuentre ningún problema. Es el paso de aceptación de una máquina, así que cuenta una máquina con un problema sin resolver como una máquina fallida en el informe de la oleada. Cuando informe de algo, sigue la solución que indica y vuelve a ejecutarlo, hasta que salga limpio.

Qué confirmas	Cómo es un buen resultado
La máquina está conectada	Ha llegado a la consola y tiene allí un registro actualizado
Las políticas están presentes	Hay políticas en la máquina. Es lo que le permite seguir decidiendo cuando la consola no es accesible
Los agentes están conectados	Cada agente instalado en la máquina está conectado, y ninguno sigue pendiente de que su desarrollador confirme la conexión

Precaución

Una máquina puede estar en marcha sin cubrir nada, y desde fuera parece idéntica a una que funciona: el cliente está en marcha, la consola tiene un registro y uno de los agentes de la máquina nunca se conectó. No pases al siguiente paso del despliegue tras una instalación que openlatch doctor no haya validado.

Crear un archivo de diagnóstico

Cuando una máquina tiene un problema que no puedes resolver con la solución que muestra, crea un archivo de diagnóstico.

openlatch doctor --rescue

El comando genera un único archivo ZIP depurado con el diagnóstico, la configuración del cliente y una ventana reciente de los registros locales de la máquina.

Opción	Qué hace
--since 24h	Limita la ventana de registros locales que incluye el archivo
--yes	Omite la confirmación, para una ejecución desatendida

El archivo permite investigar un problema a partir de las pruebas de la propia máquina y no de una descripción del síntoma. Está depurado con ese fin: envía el archivo y no el directorio en sí.

Nota

Abre un caso de soporte con el archivo adjunto, el sistema operativo de la máquina y la hora del problema con su zona horaria. Contacta con tu responsable técnico de OpenLatch por el canal acordado con tu organización. Envía los avisos de seguridad a security@openlatch.ai.

Confirmar en la consola

Un informe limpio en la máquina es la mitad de la comprobación. La otra mitad es que la consola tenga un registro de la máquina, con los agentes que detectó y la persona a la que se atribuyen sus acciones.

1. Abre el registro de agentes. Inicia sesión en app.openlatch.ai y abre Agents.

   Resultado esperado: una fila por cada agente que ha enviado datos.

2. Busca la máquina. Busca por nombre de host o por el usuario del sistema operativo con el que se ejecutó la instalación.

   Resultado esperado: la máquina aparece en las 24 horas siguientes a la instalación, y en minutos en una red sana.

3. Confirma los agentes de la máquina. Abre un agente y lee sus detalles, incluido su nivel de control.

   Resultado esperado: cada agente instalado en esa máquina aparece, cada uno con su nivel de control. Un agente que falta es un problema de instalación, no de la consola: vuelve a las comprobaciones de la máquina de arriba.

4. Confirma el propietario determinado. La pestaña Identity del agente nombra a la persona a la que se atribuyen sus acciones, con su cargo y su lugar en la organización. Con un directorio conectado, el propietario se determina mediante una búsqueda de solo lectura; sin él, OpenLatch se basa en lo que envía la máquina.

   Junto al nombre hay dos controles: uno explica cómo se llegó a ese propietario y el otro permite sustituirlo a mano. Corregir la propiedad es tarea del rol editor.

   Resultado esperado: una persona con nombre en lugar de un campo vacío.

5. Confirma que llegan los registros. Lee la hora de última actividad del agente mientras un desarrollador trabaja en esa máquina.

   Resultado esperado: la hora avanza. Un registro que deja de avanzar apunta a la ruta de salida de la máquina.

app.openlatch.ai/agents

Agents: una fila por cada agente que ha enviado datos, con su nivel de control y su propietario.

app.openlatch.ai/agents/ci-runner-payments-01/identity

La pestaña Identity de un agente: la persona a la que se atribuyen sus acciones y su lugar en la organización.

Desplegar por oleadas

Tres oleadas de dos semanas, cada una demostrando algo de lo que depende la siguiente. La oleada 1 demuestra la instalación por la ruta de desarrollador. La oleada 2 demuestra la ruta gestionada. La oleada 3 demuestra el perímetro. Emite una credencial de cliente por oleada y revócala en la consola cuando termine la oleada.

Atributo	Oleada 1	Oleada 2	Oleada 3
Alcance	Unas diez máquinas de desarrolladores	Unas cincuenta máquinas	El perímetro completo
Ruta de instalación	Ruta de desarrollador, en el terminal del propio desarrollador	Ruta gestionada, desatendida	Ruta gestionada, desatendida
Duración	Dos semanas	Dos semanas	Dos semanas
Actividad	Inscribir cada máquina, verificarla, perseguir los agentes que siguen pendientes de su desarrollador y anotar los problemas encontrados	Empaquetar la instalación, demostrarla en una máquina de cada sistema operativo, ejecutarla desatendida y leer el informe que recoge	Ejecutar el mismo paquete en todo el perímetro y perseguir las máquinas que nunca envían datos
Criterios de entrada	La organización está configurada y se ha emitido una credencial para la oleada	La oleada 1 cumplió sus criterios de salida, y el script gestionado se ejecuta limpio en una máquina de cada sistema operativo	La ruta gestionada está demostrada en cada sistema operativo del parque, y el tipo de proxy está confirmado en cada subred del alcance
Criterios de salida	Cada máquina inscrita envía datos a la consola en las 24 horas siguientes a la instalación; openlatch doctor no informa de ningún problema en ninguna; ningún agente queda pendiente de su desarrollador; la ruta del proxy está confirmada en cada sistema operativo de la oleada	Los mismos cuatro, más cada máquina instalada sin que un desarrollador abra un terminal	Los mismos cuatro, más la decisión de pasar a operación habitual
Marcha atrás	openlatch uninstall en la máquina afectada	Lo mismo, entregado por la herramienta que lo instaló	Lo mismo, entregado por la herramienta que lo instaló

Figura 1. Tres oleadas, lo que demuestra cada una y la puerta entre ellas.

Problemas más probables

Síntoma	Causa probable	Qué hacer
La máquina envía datos, pero uno de sus agentes no está conectado	Ese agente no estaba instalado cuando se ejecutó la instalación, o su configuración está en una ruta personalizada	Instala el agente y vuelve a ejecutar openlatch init en la máquina. El cliente ya está allí, así que no hace falta descargar nada. Si la ruta es personalizada, defínela en el entorno de la inscripción
Un agente figura como pendiente	Algunos agentes piden al desarrollador que confirme la conexión una vez, la primera vez que se ejecutan tras la instalación	Pide al desarrollador que abra el agente una vez y confirme. Si el entorno bloquea la configuración de los agentes de forma centralizada, entrega la conexión por ese canal gestionado
Las políticas nunca llegan a la máquina	La máquina no ha llegado a la consola desde que se instaló, o su credencial se revocó o se renovó	Confirma primero la ruta de salida, según Requisitos de red. Si la credencial se rechazó, emite una para la oleada y vuelve a ejecutar la instalación
La máquina está conectada, pero sus agentes se comportan como si no hubiera nada	Los puntos de acceso de modelos de los agentes están bloqueados en el proxy, o sus respuestas en streaming se almacenan en búfer	Exime esos puntos de acceso del almacenamiento en búfer de respuestas y de la inspección de flujos. Son el tráfico propio de los agentes y deben seguir siendo accesibles como antes
La máquina nunca aparece en la consola	La ruta de salida está bloqueada, o la inscripción no llegó a completarse	Ejecuta openlatch doctor en la máquina. Nombra lo que falló, lo que distingue un problema de proxy de una instalación que se detuvo antes de tiempo

En resumen

• Una instalación está verificada cuando openlatch doctor no informa de ningún problema y la consola muestra los agentes de la máquina, cada uno con un nivel de control y un propietario determinado.
• openlatch status indica si la máquina está cubierta. openlatch doctor lo demuestra, con una causa y una solución para cada problema detectado.
• openlatch doctor --rescue crea un archivo depurado con el diagnóstico, la configuración y una ventana reciente de los registros locales. Abre cada caso de soporte con él.
• Un agente que sigue pendiente de que su desarrollador confirme la conexión está conectado en teoría pero no en la práctica. Persigue esos casos antes de cerrar una oleada.
• Tres oleadas de dos semanas: unas diez máquinas de desarrolladores, unas cincuenta por la ruta gestionada y, después, el perímetro. Una credencial de cliente por oleada, revocada cuando termina la oleada.