Microserveis

Els microserveis són components independents que s'executen per prevenir o solucionar problemes freqüents en els dispositius, millorar el seu rendiment o agilitzar tasques que podrien requerir molt de temps per fer-les manualment. Els microserveis poden executar-se de forma autònoma o com a part d'una funcionalitat més àmplia dins d'un sistema.

Microserveis permet crear, habilitar i publicar microserveis perquè puguin executar-se a nivell d'organització, com a mecanisme de prevenció o autorremediació —a través de fluxos o alertes—, o directament per l'usuari final.

nota

En aquest document es descriu en línies generals què són els microserveis i les maneres d'executar-los. Els següents articles aporten informació més precisa sobre el seu comportament i configuració:

• Habilitat. Descriu com activar un microservei per a la seva execució per part d'un usuari final o des de Workspaces.
• Marketplace. Mostra el catàleg de microserveis disponibles.
• Dissenyador. Explica com crear nous microserveis i configurar els existents.
• Crear amb IA. Explica pas a pas com generar microserveis utilitzant llenguatge natural.

Característiques

Microserveis ofereix una sèrie d'avantatges clau. A continuació, es descriuen les més rellevants:

Accés a un catàleg centralitzat

Els microserveis disponibles es troben organitzats a la secció Marketplace, on els usuaris poden explorar el catàleg, seleccionar i habilitar microserveis específics segons les necessitats de la seva organització o casos d'ús particulars.

Creació de microserveis personalitzats

Portal permet crear microserveis de manera senzilla a través de la secció Dissenyador. Aquesta eina guia a l'usuari, sempre que compti amb els permisos adequats, a través de totes les fases necessàries per construir i configurar el seu propi microservei.

Configuració de l'àmbit d'execució

Cada microservei pot definir-se per tal que s'executi en un dels següents contextos, configurables des de la secció Dissenyador.

Execució des de l'administrador local

Permet interactuar directament amb serveis del sistema operatiu, processos i altres recursos que requereixen privilegis elevats. És ideal per a operacions que s'han d'executar amb permisos d'administrador, però pot limitar l'accés a informació específica de l'usuari o la seva sessió.

Execució des de sessió d'usuari

Útil per accedir a informació de l'usuari com el registre o informació continguda en el perfil. El script s'executarà amb el nivell de permisos que tingui l'usuari, per tant, si no compta amb privilegis d'administrador local, no podrà realitzar accions que requereixin accés al sistema.

Maneres de consumir els microserveis

Els microserveis poden crear-se i habilitar-se en Portal, i a partir d'aquí ser configurats perquè siguin executats per l'usuari final, posats en marxa a través d'un flux o perquè siguin executats amb accions automatitzades o de suport des de Workspaces.

Execució a demanda des de Workspaces

Qualsevol microservei que hagi estat habilitat prèviament en Portal pot executar-se des de Workspaces.

1. Accedir al mòdul Workspaces -> secció Workspaces o Sessions.
2. Seleccionar els dispositius o sessions en els quals vols aplicar el microservei.
3. Al menú superior fer clic sobre la icona de Microserveis (>_).
4. Seleccionar el microservei que es desitja executar.

Els microserveis estaran visibles a la secció Workspaces quan prèviament s'hagin configurat per executar-se en el context Sistema, i a la secció Sessions quan en la seva configuració s'hagi seleccionat el context Sessió.

La gestió de l'àmbit de l'execució del microservei i dels permisos es pot realitzar des de la secció Dissenyador. S'ha de tenir en compte que la potestat d'executar determinats microserveis dependrà del rol que tingui l'usuari a la plataforma.

Execució programada a través de Fluxos

Fluxos és una funcionalitat que permet definir seqüències d'automatització per executar accions programades sobre els dispositius segons l'avaluació de condicions lògiques preestablertes.

La seva principal característica és que simplifica les accions de diagnòstic i soluciona els problemes ràpidament a través de l'execució d'un microservei.

Per obtenir més informació sobre com executar un microservei a través d'un flux, si us plau consulta aquesta guia.

Execució programada a través de Configuració d'alertes

A través de Configuració d'alertes és possible vincular esdeveniments (event logs) a un o més microserveis, per prevenir inconvenients amb el dispositiu o resoldre problemes amb immediatesa.

1. Accedir a Portal -> Monitor -> Configuració d'alertes.
2. A la taula, seleccionar un nom d'alerta per accedir a la seva informació detallada.
3. Al menú lateral esquerre, fer clic a la pestanya Microserveis.
4. Fer clic a Vincular.
5. Al formulari, triar el microservei que es vol vincular a l'alerta i l'ordre d'execució (útil quan es vol vincular més d'un microservei).
6. Al formulari, fer clic a Vincular.

Per obtenir més informació sobre com vincular una alerta a un microservei, si us plau consulta la documentació de Configuració d'alertes.

Execució de l'usuari final

En crear un microservei, aquest no queda habilitat automàticament per a la seva execució per part de l'usuari final. Per habilitar-lo, cal completar la configuració següent:

1. Accedir a Portal -> Microserveis -> Activat.
2. Seleccionar un microservei de la llista.
3. A la pestanya Destinataris dirigir-se a l'apartat Execució per l'usuari final.
4. Fer clic a Editar i activar Execució per l'usuari final.

A continuació, de manera opcional, es pot configurar la recepció de notificacions.

Notificacions

Aquesta opció permet definir si es notificarà a l'usuari quan el microservei comenci a executar-se i quan acabi, ja sigui de forma satisfactòria o amb errors.

Per això, s'ha d'activar Notificació d'usuari i completar els següents camps:

• Text inicial. Missatge que es mostrarà al començar l'execució del microservei.
• Text d'èxit. Missatge que es mostrarà quan l'execució finalitzi correctament.
• Text d'error. Missatge que es mostrarà quan l'execució finalitzi amb errors.

Les notificacions apareixeran a la barra de notificacions de Windows.

Canviar el nom de la carpeta de microserveis

Quan els microserveis estan habilitats per a l'execució per part de l'usuari final, s'afegeixen automàticament a una carpeta del dispositiu anomenada Flexxible; no obstant això, aquest nom es pot modificar.

1. Accedir a Portal -> Configuració -> Organització.
2. Al menú lateral esquerre, fes clic a la pestanya Microserveis -> Editar la configuració de microserveis.
3. Canviar el nom de la carpeta.
4. Fer clic a Guardar.

El nom triat ha de tenir entre 3 i 50 caràcters, i només pot contenir lletres, números, guions i guions baixos.

Si el dispositiu té Windows 11 com a sistema operatiu i només s'habilita un microservei per a un usuari final, la carpeta no es mostrarà; en el seu lloc, al menú d'inici, només es veurà la icona del microservei.

consell

Per obtenir més informació sobre com habilitar un microservei per a l'usuari final, si us plau consulta aquesta guia.

Seguiment de l'execució d'un microservei

Per facilitar l'anàlisi i la resolució d'incidències, la plataforma permet consultar l'estat, la durada i el resultat de l'execució dels microserveis a través de la secció Operacions.

Per consultar les operacions:

1. Accedir a Portal -> Operacions.

2. Seleccionar l'operació corresponent. El menú lateral permet accedir a diferents àmbits de l'execució: Detalls, Espais de treball i Esdeveniments.

   

Detalls

Aquesta pestanya mostra targetes resum amb els principals indicadors de l'operació:

• Estat. Situació actual de l'operació.
• Resum. Indicador visual del resultat global de l'operació.
• Duració. Temps total que va durar l'execució de l'operació.
• Espais de treball. Quantitat de dispositius en què s'ha executat l'operació.
• Microservei. Nom del microservei executat. En fer clic s'accedeix a la seva vista de detall.

Visió general

Aquest apartat presenta una taula amb la següent informació:

• Descripció. Breu explicació de l'operació realitzada.
• Tipus d'operació. Operació executada.
• Estat. Situació actual de l'execució: Pendent, En curs, Error, Timeout o Finalitzat.
• Creat el. Data i hora de creació del registre de l'operació.
• Iniciat el. Data i hora d'inici de l'execució.
• Finalitzat el. Data i hora de finalització de l'execució.
• Data programada. Data i hora a partir de la qual s'executarà el microservei.
• Data programada màxima. Data i hora límit per a l'execució del microservei.

Workspaces

Aquesta pestanya mostra una taula amb el llistat dels dispositius sobre els quals es va executar el microservei.

Cada registre inclou la següent informació:

• Nom. Identificació del dispositiu. En fer clic s'accedeix a la seva vista de detall.
• Grup de report: grup de report al qual pertany el dispositiu.
• Estat. Estat de l'execució de l'operació en aquest dispositiu.
• Iniciat el. Data i hora d'inici de l'execució.
• Finalitzat el. Data i hora de finalització.
• Accions. Permet accedir al Detall del microservei executat.

Esdeveniments

Aquesta secció mostra l'historial d'esdeveniments generats pel sistema durant l'execució del microservei, la qual cosa permet diagnosticar errors o verificar el seu progrés.

La informació de cada esdeveniment inclou:

• Data. Data i hora en què s'ha registrat l'event.
• Tipus. Nivell de l'esdeveniment: Informació, Error o Crític.
• Origen. Component del sistema que va generar l'esdeveniment.
• Missatge. Descripció detallada de l'esdeveniment.

Estats d'una operació

• Pendent. L'operació està registrada, però encara no ha començat a executar-se.
• En curs. L'operació es troba actualment en execució.
• Error. L'operació va finalitzar amb errors.
• Timeout. L'operació no va finalitzar dins del temps màxim permès. En els microserveis aquest temps és d'aproximadament quatre hores.
• Finalitzat. L'operació va acabar correctament.

Consideracions

• Si un microservei s'executa sobre un dispositiu apagat, l'operació finalitzarà amb error.

• Si en el moment d'executar un microservei el dispositiu està apagat o no està reportant, l'execució fallarà i no s'executarà automàticament quan el dispositiu s'encengui.

• Quan un microservei es llança sobre un grup molt gran de dispositius, les operacions es processen en cua (estat Pendent). En aquest cas, pot passar que, quan s'inicia l'operació des de la consola, l'ordre encara no hagi estat enviada al dispositiu. Si durant aquest temps el dispositiu s'encén, l'operació sí podrà executar-se.

• L'execució d'un microservei també pot programar-se per a començar a partir d'una hora determinada. En aquest cas, l'operació queda programada i no començarà fins a l'hora indicada. Durant aquest temps, l'estat dels dispositius pot canviar.

• El temps màxim d'execució d'un microservei és d'aproximadament 4 hores. Si durant l'execució el dispositiu es reinicia, l'operació romandrà activa a la consola fins a assolir aquest límit. Transcorregut aquest temps, finalitzarà amb estat Timeout.

Detall del microservei executat

La vista de detall de l'execució del microservei inclou la següent informació:

• Iniciat el. Data i hora d'inici de l'execució.
• Finalitzat el. Data i hora de finalització.
• Durada. Temps total transcorregut entre l'inici i la finalització.
• Microservei executat. Codi identificador del microservei.
• Output. Informació generada com a resultat de l'execució, útil per validar el resultat i analitzar possibles incidències.

consell

Per a més informació sobre Operacions, consulta la seva documentació.