Microservicios

Los microservicios son componentes independientes que se ejecutan para prevenir o solucionar problemas frecuentes en los dispositivos, mejorar su desempeño o agilizar tareas que podrían requerir mucho tiempo hacerlas manualmente. Los microservicios pueden ejecutarse de forma autónoma o como parte de una funcionalidad más amplia dentro de un sistema.

Microservicios permite crear, habilitar y publicar microservicios para que puedan ejecutarse a nivel de organización, como mecanismo de prevención o autorremediación —a través de flujos o alertas—, o directamente por el usuario final.

nota

En este documento se describe en líneas generales qué son los microservicios y las maneras de ejecutarlos. Los siguientes artículos aportan información más precisa sobre su comportamiento y configuración:

• Habilitado. Describe cómo activar un microservicio para su ejecución por parte de un usuario final o desde Workspaces.
• Marketplace. Muestra el catálogo de microservicios disponibles.
• Diseñador. Explica cómo crear microservicios nuevos y configurar los existentes.
• Crear con IA. Explica paso a paso cómo generar microservicios utilizando lenguaje natural.

Características

Microservicios ofrece una serie de ventajas clave. A continuación, se describen las más relevantes:

Acceso a un catálogo centralizado

Los microservicios disponibles se encuentran organizados en la sección Marketplace, donde los usuarios pueden explorar el catálogo, seleccionar y habilitar microservicios específicos según las necesidades de su organización o casos de uso particulares.

Creación de microservicios personalizados

Portal permite crear microservicios de manera sencilla a través de la sección Diseñador. Esta herramienta guía al usuario, siempre que cuente con los permisos adecuados, a través de todas las fases necesarias para construir y configurar su propio microservicio.

Configuración del ámbito de ejecución

Cada microservicio puede definirse para que se ejecute en uno de los siguientes contextos, configurables desde la sección Diseñador.

Ejecución desde el administrador local

Permite interactuar directamente con servicios del sistema operativo, procesos y otros recursos que requieren privilegios elevados. Es ideal para operaciones que deben ejecutarse con permisos de administrador, pero puede limitar el acceso a información específica del usuario o su sesión.

Ejecución desde sesión de usuario

Útil para acceder a información del usuario como el registro o información contenida en el perfil. El script se ejecutará con el nivel de permisos que tenga el usuario, por lo que, si no cuenta con privilegios de administrador local, no podrá realizar acciones que requieran acceso al sistema.

Formas de consumir los microservicios

Los microservicios pueden crearse y habilitarse en Portal, y a partir de ahí ser configurados para que sean ejecutados por el usuario final, puestos en marcha a través de un flujo o para que sean ejecutados con acciones automatizadas o de soporte desde Workspaces.

Ejecución a demanda desde Workspaces

Cualquier microservicio que haya sido habilitado previamente en Portal puede ejecutarse desde Workspaces.

1. Acceder al módulo Workspaces -> sección Workspaces o Sesiones.
2. Seleccionar los dispositivos o sesiones en los que desea aplicar el microservicio.
3. En el menú superior hacer clic sobre el icono de Microservicios (>_).
4. Seleccionar el microservicio que se desea ejecutar.

Los microservicios estarán visibles en la sección Workspaces cuando previamente se hayan configurado para ejecutarse en el contexto Sistema, y en la sección Sesiones cuando en su configuración se haya seleccionado el contexto Sesión.

La gestión del ámbito de la ejecución del microservicio y de los permisos puede realizarse desde la sección Diseñador. Se debe tener en cuenta que la potestad de ejecutar determinados microservicios dependerá del rol que tenga el usuario en la plataforma.

Ejecución programada a través de Flujos

Flujos es una funcionalidad que permite definir secuencias de automatización para ejecutar acciones programadas sobre los dispositivos según la evaluación de condiciones lógicas preestablecidas.

Su principal característica es que simplifica las acciones de diagnóstico y soluciona los problemas rápidamente a través de la ejecución de un microservicio.

Para obtener más información sobre ejecutar un microservicio a través de un flujo, por favor consulta esta guía.

Ejecución programada a través de Configuración de alertas

A través de Configuración de alertas es posible vincular eventos (event logs) a uno o más microservicios, para prevenir inconvenientes con el dispositivo o resolver problemas con inmediatez.

1. Acceder a Portal -> Monitor -> Configuración de alertas.
2. En la tabla, seleccionar un nombre de alerta para acceder a su información detallada.
3. En el menú lateral izquierdo, hacer clic en la pestaña Microservicios.
4. Hacer clic en Vincular.
5. En el formulario, elegir el microservicio que se desea vincular a la alerta y el orden de ejecución (útil cuando se desea vincular más de un microservicio).
6. En el formulario, hacer clic en Vincular.

Para obtener más información sobre cómo vincular una alerta a un microservicio, por favor consulta la documentación de Configuración de alertas.

Ejecución por el usuario final

Al crear un microservicio, este no queda habilitado automáticamente para su ejecución por parte del usuario final. Para habilitarlo, es necesario completar la siguiente configuración:

1. Acceder a Portal -> Microservicios -> Habilitado.
2. Seleccionar un microservicio del listado.
3. En la pestaña Destinatarios dirigirse al apartado Ejecución por el usuario final.
4. Hacer clic en Editar y activar Ejecución por el usuario final.

A continuación, de forma opcional, se puede configurar la recepción de notificaciones.

Notificaciones

Esta opción permite definir si se notificará al usuario cuando el microservicio empiece a ejecutarse y cuando termine, ya sea de forma satisfactoria o con errores.

Para ello, se debe activar Notificación de usuario y completar los siguientes campos:

• Texto inicial. Mensaje que se mostrará al comenzar la ejecución del microservicio.
• Texto de éxito. Mensaje que se mostrará cuando la ejecución finalice correctamente.
• Texto de error. Mensaje que se mostrará cuando la ejecución finalice con errores.

Las notificaciones aparecerán en la barra de notificaciones de Windows.

Cambiar el nombre de la carpeta de microservicios

Cuando los microservicios están habilitados para su ejecución por el usuario final, se añaden automáticamente a una carpeta del dispositivo llamada Flexxible; no obstante, este nombre se puede modificar.

1. Acceder a Portal -> Configuración -> Organización.
2. En el menú lateral izquierdo, hacer clic en la pestaña Microservicios -> Editar la configuración de microservicios.
3. Cambiar el nombre de la carpeta.
4. Hacer clic en Guardar.

El nombre elegido debe tener entre 3 y 50 caracteres, y solo puede contener letras, números, guiones y guiones bajos.

Si el dispositivo tiene Windows 11 como sistema operativo y solo se habilita un microservicio para un usuario final, la carpeta no se mostrará; en su lugar, en el menú de inicio, solo se verá el icono del microservicio.

tip

Para obtener más información sobre cómo habilitar un microservicio para el usuario final, por favor consulta esta guía.

Seguimiento de la ejecución de un microservicio

Para facilitar el análisis y la resolución de incidencias, la plataforma permite consultar el estado, la duración y el resultado de la ejecución de los microservicios a través de la sección Operaciones.

Para consultar las operaciones:

1. Acceder a Portal -> Operaciones.

2. Seleccionar la operación correspondiente. El menú lateral permite acceder a distintos ámbitos de la ejecución: Detalles, Workspaces y Eventos.

   

Detalles

Esta pestaña muestra tarjetas resumen con los principales indicadores de la operación:

• Estado. Situación actual de la operación.
• Resumen. Indicador visual del resultado global de la operación.
• Duración. Tiempo total que duró la ejecución de la operación.
• Workspaces. Cantidad de dispositivos en los que se ejecutó la operación.
• Microservicio. Nombre del microservicio ejecutado. Al hacer clic se accede a su vista de detalle.

Visión general

Este apartado presenta una tabla con la siguiente información:

• Descripción. Breve explicación de la operación realizada.
• Tipo de operación. Operación ejecutada.
• Estado. Situación actual de la ejecución: Pendiente, En curso, Error, Timeout o Finalizado.
• Creado el. Fecha y hora de creación del registro de la operación.
• Iniciado el. Fecha y hora de inicio de la ejecución.
• Finalizado el. Fecha y hora de finalización de la ejecución.
• Fecha programada. Fecha y hora a partir de la cual se ejecutará el microservicio.
• Fecha programada máxima. Fecha y hora límite para la ejecución del microservicio.

Workspaces

Esta pestaña muestra una tabla con el listado de los dispositivos sobre lo que se ejecutó el microservicio.

Cada registro incluye la siguiente información:

• Nombre. Identificación del dispositivo. Al hacer clic se abre su vista de detalle.
• Grupo de reporte. Grupo de reporte al que pertenece el dispositivo.
• Estado. Estado de la ejecución de la operación en ese dispositivo.
• Iniciado el. Fecha y hora de inicio de la ejecución.
• Finalizado el. Fecha y hora de finalización.
• Acciones. Permite acceder al Detalle del microservicio ejecutado.

Eventos

Esta sección muestra el historial de eventos generados por el sistema durante la ejecución del microservicio, lo que permite diagnosticar errores o verificar su progreso.

La información de cada evento incluye:

• Fecha. Fecha y hora en la que se registró el evento.
• Tipo. Nivel del evento: Información, Error o Crítico.
• Origen. Componente del sistema que generó el evento.
• Mensaje. Descripción detallada del evento.

Estados de una operación

• Pendiente. La operación está registrada, pero todavía no ha empezado a ejecutarse.
• En curso. La operación se encuentra actualmente en ejecución.
• Error. La operación finalizó con errores.
• Timeout. La operación no finalizó dentro del tiempo máximo permitido. En los microservicios este tiempo es de aproximadamente cuatro horas.
• Finalizado. La operación terminó correctamente.

Consideraciones

• Si un microservicio se ejecuta sobre un dispositivo apagado, la operación finalizará con error.

• Si en el momento de ejecutar un microservicio el dispositivo está apagado o no está reportando, la ejecución fallará y no se ejecutará automáticamente cuando el dispositivo se encienda.

• Cuando un microservicio se lanza sobre un grupo muy grande de dispositivos, las operaciones se procesan en cola (estado Pendiente). En ese caso, puede ocurrir que, cuando se inicia la operación desde la consola, la orden aún no haya sido enviada al dispositivo. Si durante ese tiempo el dispositivo se enciende, la operación sí podrá ejecutarse.

• La ejecución de un microservicio también puede programarse para comenzar a partir de una hora determinada. En este caso, la operación queda en programado y no comenzará hasta la hora indicada. Durante ese tiempo, el estado de los dispositivos puede cambiar.

• El tiempo máximo de ejecución de un microservicio es de aproximadamente 4 horas. Si durante la ejecución el dispositivo se reinicia, la operación permanecerá activa en la consola hasta alcanzar ese límite. Transcurrido ese tiempo, finalizará con estado Timeout.

Detalle del microservicio ejecutado

La vista de detalle de la ejecución del microservicio incluye la siguiente información:

• Iniciado el. Fecha y hora de inicio de la ejecución.
• Finalizado el. Fecha y hora de finalización.
• Duración. Tiempo total transcurrido entre el inicio y la finalización.
• Microservicio ejecutado. Código identificador del microservicio.
• Output. Información generada como resultado de la ejecución, útil para validar el resultado y analizar posibles incidencias.

tip

Para más información sobre Operaciones, consulta su documentación.