24.6 Inspección de controladores

Puede utilizar el Inspector de controladores para ver información detallada acerca de los objetos asociados a un controlador. Esta sección se divide en las siguientes categorías:

24.6.1 Inspector de controladores

Para ver los objetos asociados a un controlador:

En OpenText Identity Console, seleccione Controladores > Inspector > pestaña Inspector de controladores.
En el campo Controlador, especifique el nombre completo del controlador que desea inspeccionar o haga clic en el icono Examinar para buscar y seleccionar el controlador que desee.
Cuando haya seleccionado el controlador que desea inspeccionar, haga clic en Aceptar para visualizar la página Inspector de controladores.

En la página, se muestra información acerca de los objetos asociados al controlador seleccionado. Puede llevar a cabo cualquiera de las siguientes acciones:
- Suprimir: elimina la asociación entre el controlador y un objeto. Marque la casilla de verificación del objeto que ya no desea asociar al controlador, haga clic en el icono y, a continuación, haga clic en Aceptar para confirmar la supresión.
- Actualizar: seleccione el icono Actualizar para volver a leer todos los objetos asociados al controlador y actualizar la información.
- Mostrar: seleccione el número de asociaciones que se mostrarán por página. Puede seleccionar un número predefinido (25, 50 o 100) o especificar otro número de su elección. El valor por defecto es 10 asociaciones por página. Si hay más asociaciones que el número mostrado, puede utilizar los botones de flecha para visualizar las páginas de asociaciones siguientes y anteriores.
- Acciones: lleve a cabo acciones en los objetos asociados al controlador. Haga clic en Acciones y, a continuación, seleccione una de las siguientes opciones:
  - Mostrar todas las asociaciones: muestra todos los objetos asociados al controlador.
  - Filtrar para asociaciones 'Inhabilitadas': muestra todos los objetos asociados al controlador que presentan el estado Inhabilitado.
  - Filtrar para asociaciones 'Manuales': muestra todos los objetos asociados al controlador que presentan el estado Manual.
  - Filtrar para asociaciones 'Migrar': muestra todos los objetos asociados al controlador que presentan el estado Migración.
  - Filtrar para asociaciones 'Pendientes': muestra todos los objetos asociados al controlador que presentan el estado Pendiente.
  - Filtrar para asociaciones 'Procesadas': muestra todos los objetos asociados al controlador que presentan el estado Procesado.
  - Filtrar para asociaciones 'Sin definir': muestra todos los objetos asociados al controlador que presentan el estado Sin definir.
  - Resumen de asociaciones: muestra el estado de todos los objetos asociados al controlador.
- DN de objeto: muestra el DN de los objetos asociados.
- Estado: muestra el estado de asociación del objeto.
- ID de objeto: muestra el valor de la asociación.

24.6.2 Inspector del caché de controladores

Puede ver las transacciones de un archivo de caché del controlador mediante OpenText Identity Console. El Inspector del caché de controladores muestra información sobre el archivo de caché, incluida una lista de los eventos que procesará el controlador.

En OpenText Identity Console, seleccione Controladores > Inspector > pestaña Inspector del caché de controladores .
En el campo Controlador, especifique el nombre completo del controlador cuyo caché desea inspeccionar o haga clic en el icono Examinar para buscar y seleccionar el controlador deseado y, a continuación, haga clic en Aceptar para visualizar la página del Inspector de caché de controladores.

Un archivo de caché del controlador solo puede leerse cuando el controlador no se está ejecutando. Si se detiene el controlador, la página Inspección del caché de controladores mostrará el caché. Si el controlador se está ejecutando, en la página, se muestra la nota El controlador no se ha detenido; no se puede leer el caché en lugar de las entradas de caché. Para detener el controlador, haga clic en el botón ; a continuación, se leerá y se mostrará el caché.
- Caché del controlador en el servidor: muestra el servidor que contiene esta instancia del archivo de caché. Si el controlador se ejecuta en varios servidores, puede seleccionar otro servidor en la lista para ver el archivo de caché del controlador para ese servidor.
- Iconos de Iniciar/Detener controlador: muestra el estado actual del controlador y permite iniciarlo o detenerlo. El caché solo puede leerse mientras el controlador está detenido.
- Suprimir: seleccione las entradas del caché y, a continuación, haga clic en para eliminarlas del archivo de caché.
- Acciones: permite realizar acciones en las entradas del archivo de caché. Haga clic en Acciones para expandir el menú y, a continuación, seleccione una de las siguientes opciones:
  - Borrar todos los eventos en caché: permite borrar todos los eventos almacenados en caché.
  - Resumen de caché: resume todos los eventos almacenados en el archivo de caché.

Visualización de la información de sistemas conectados de los controladores

Para ver la información de sistemas conectados de un controlador específico, realice las siguientes acciones:

En OpenText Identity Console, haga clic en el módulo Object Inspector.
Busque y seleccione el objeto Controlador específico para el que desea que se muestren los sistemas conectados.
Toda la información de sistemas conectados del objeto Controlador seleccionado se muestra en el equipo.

24.6.3 Inspector de caché de sincronización fuera de banda

Para ver eventos en el caché de sincronización fuera de banda:

En OpenText Identity Console, seleccione Controladores > Inspector > pestaña Inspector de caché de sincronización fuera de banda.
En el campo Controlador, especifique el nombre completo del controlador cuyo caché desea inspeccionar o haga clic en el icono Examinar para buscar y seleccionar el controlador que desee. A continuación, haga clic en Aceptar.

Un archivo de caché del controlador solo puede leerse cuando el controlador no se está ejecutando. Si se detiene el controlador, la página Inspección del caché de controladores mostrará el caché. Si el controlador se está ejecutando, en la página, se muestra la nota El controlador no se ha detenido; no se puede leer el caché en lugar de las entradas de caché. Para detener el controlador, haga clic en el botón ; a continuación, se leerá y se mostrará el caché.
- Nombre de archivo de caché: muestra el nombre de archivo del caché.
- Caché del controlador en el servidor: muestra el servidor que contiene esta instancia del archivo de caché. Si el controlador se ejecuta en varios servidores, puede seleccionar otro servidor en la lista para ver el archivo de caché del controlador para ese servidor.
- Iconos de Iniciar/Detener controlador: muestra el estado actual del controlador y permite iniciarlo o detenerlo. El caché solo puede leerse mientras el controlador está detenido.
- Suprimir: seleccione las entradas del caché y, a continuación, haga clic en para eliminarlas del archivo de caché.
- Acciones: permite realizar acciones en las entradas del archivo de caché. Haga clic en Acciones para expandir el menú y, a continuación, seleccione una de las siguientes opciones:
  - Resumen de caché: resume todos los eventos almacenados en el archivo de caché.
  - Borrar todos los eventos en caché: permite borrar todos los eventos almacenados en caché.

24.6.4 Inventario de controladores

El inventario de controladores presenta información del controlador. Indica lo que admite el controlador e incluye algunos ajustes de configuración. El desarrollador del controlador debe proporcionar el inventario de controladores. Por lo general, un administrador de red no necesita editar el inventario de controladores. Si el administrador desea editar el inventario de controladores, debe seleccionar Controladores > Inspector > Inventario de controladores > Habilitar edición de XML.

24.6.5 Supervisión de actividad del controlador

La supervisión de actividad del controlador permite ver el estado de actividad actual de un controlador como verde, amarillo o rojo y definir las acciones que se realizarán en función de cada uno de estos estados.

Puede crear las condiciones (criterios) que determinan cada uno de los estados de actividad y también definir las acciones que se realizan cada vez que cambia el estado de actividad del controlador. Por ejemplo, si la actividad del controlador cambia de un estado verde a amarillo, puede llevar a cabo acciones como reiniciar el controlador o apagarlo y enviar un mensaje de correo electrónico a la persona designada para resolver los problemas con el controlador.

Mediante este módulo, puede realizar las siguientes acciones:

Modificación de las condiciones de actividad del controlador

Puede controlar las condiciones que determinan cada estado de actividad. El estado verde debe representar un controlador con actividad correcta y un estado rojo, un controlador con actividad incorrecta.

Las condiciones del estado verde se evalúan primero. Si el controlador no cumple las condiciones del estado verde, se evalúan las condiciones del estado amarillo. Si el controlador no cumple las condiciones del estado amarillo, se le asigna automáticamente un estado de actividad rojo.

Para modificar las condiciones de un estado:

En OpenText Identity Console, abra la página Configuración de actividad de controladores de un controlador cuyas condiciones desee modificar:
1. Abra la página principal de OpenText Identity Console.
2. Seleccione Controladores > haga clic en el controlador adecuado en la lista > Inspector > Configuración de actividad de controladores.
Haga clic en la pestaña del estado (verde o amarillo) que desee modificar.

En la pestaña, se muestran las condiciones actuales del estado de actividad. Las condiciones se organizan en grupo y se utilizan operadores lógicos, AND u OR, para combinar cada condición y cada grupo. Tenga en cuenta el siguiente ejemplo del estado verde:
```
GROUP1
Condition1 and
Condition2
Or
GROUP2
Condition1 and
Condition2 and
Condition3
```
En el ejemplo, al controlador se le asigna un estado verde si las condiciones de GROUP1 o GROUP2 se evalúan como verdaderas. Si ninguno de los dos grupos de condiciones es verdadero, se evalúan las condiciones del estado amarillo.

Las condiciones que se pueden evaluar son las siguientes:
- Estado del controlador: en ejecución, detenido, en inicio, no en ejecución o en proceso de cierre. Por ejemplo, una de las condiciones por defecto del estado de actividad verde es que el controlador se está ejecutando.
- Desbordamiento de controladores en caché: el estado del caché utilizado para conservar transacciones del controlador. Si el controlador presenta un desbordamiento de caché, se ha utilizado todo el caché disponible. Por ejemplo, la condición por defecto del estado de actividad verde es que la condición Desbordamiento de controladores en caché es falsa y la condición por defecto del estado de actividad amarillo es que esta condición es falsa.
- Más reciente: la antigüedad de la transacción más reciente del caché.
- Más antigua: la antigüedad de la transacción más antigua del caché.
- Tamaño total: el tamaño del caché.
- Tamaño sin procesar: el tamaño de todas las transacciones sin procesar del caché.
- Transacciones sin procesar: el número de transacciones sin procesar del caché. Puede especificar todos los tipos de transacciones o tipos específicos (como, por ejemplo, adiciones, eliminaciones o cambios de nombre).
- Historial de transacciones: el número de transacciones procesadas en varios puntos del canal de suscriptor o de editor durante un periodo determinado. Esta condición utiliza varios elementos con el siguiente formato:
  
  <tipo de transacción> <ubicación y periodo de la transacción > <operador relacional> <número de transacciones>.
  - <tipo de transacción>: especifica el tipo de transacción que se está evaluando. Puede tratarse de todas las transacciones, adiciones, eliminaciones, cambios de nombre, etc.
  - <ubicación y periodo de la transacción>: especifica la ubicación del canal del suscriptor o del editor y el periodo que se está evaluando. Por ejemplo, puede evaluar el número total de transacciones procesadas como eventos notificados del editor en las últimas 48 horas. Por defecto, los datos del historial de transacciones se conservan durante dos semanas, lo que implica que no es posible especificar un periodo superior a este a menos que cambie el ajuste por defecto de Duración de los datos de la transacción.
  - <operador relacional>: indica que las transacciones identificadas deben ser igual a, no ser igual a, ser menor que, ser menor o igual que, ser mayor que o ser mayor o igual que el <número de transacciones>.
  - <número de transacciones>: especifica el número de transacciones que se utilizan en la evaluación.
  A continuación, se proporciona un ejemplo de condición Historial de transacciones:
  
  <número de adiciones> <como comandos del editor> <en los últimos 10 minutos> <es menor que> <1000>
- Historial disponible: la cantidad de datos del historial de transacciones que están disponibles para su evaluación. El objetivo principal de esta condición es asegurarse de que una condición Historial de transacciones no provoca el fallo del estado actual porque no tiene suficientes datos de historial de transacciones recopilados durante el periodo de evaluación.
  
  Por ejemplo, supongamos que desea utilizar la condición Historial de transacciones para evaluar el número de adiciones como comandos de editor durante las últimas 48 horas (el ejemplo mostrado en la sección Historial de transacciones anterior). Sin embargo, no desea que la condición falle si aún no hay 48 horas de datos, como puede ser después de la configuración inicial de la actividad del controlador o si el servidor del controlador se reinicia (ya que los datos del historial de transacciones se guardan en la memoria). Por lo tanto, puede crear grupos de condiciones similares a los siguientes:
  
  Historial disponible de Group1 <es menor que> <48 horas> o Historial disponible de Group2 <es mayor o igual que> <48 horas> e Historial de transacciones <número de adiciones> <como comandos del editor> <en las últimas 48 horas> <es menor que> <1000>
  
  El estado se evalúa como verdadero si cualquiera de los dos grupos de condiciones es verdadero, lo que significa que a) hay menos de 48 horas de datos o b) hay al menos 48 horas de datos y el número de adiciones como comandos del editor durante las últimas 48 horas es inferior a 1000.
  
  El estado se evalúa como falso si ambas condiciones se evalúan como falsas, lo que significa que a) hay al menos 48 horas de datos y b) el número de adiciones como comandos del editor durante las últimas 48 horas es superior a 1000.
Modifique los criterios según sea necesario.
- Para añadir un nuevo grupo, haga clic en el icono situado junto a los Grupos de condiciones.
- Para añadir una condición, haga clic en el icono situado junto a los operadores lógicos (AND/OR). También puede hacer clic en el enlace Añadir nueva condición.
- Para reordenar grupos de condiciones o condiciones individuales, marque la casilla de verificación situada junto al grupo o la condición que desee mover y, a continuación, haga clic en los botones de flecha para subir o bajar. También puede utilizar los botones de flecha para mover una condición de un grupo a otro.
Cuando haya terminado, guarde los cambios. Para ello, haga clic en el botón Guardar.
Si desea cambiar las acciones asociadas a las condiciones que ha definido, continúe con Modificación de las acciones de actividad del controlador.

Modificación de las acciones de actividad del controlador

Puede determinar las acciones que desea llevar a cabo cuando cambie el estado del controlador. Por ejemplo, si el estado cambia de verde a amarillo, puede apagar o reiniciar el controlador, generar un evento o iniciar un flujo de trabajo. O bien, si el estado cambia de amarillo a verde, se llevarán a cabo las acciones asociadas al estado verde.

Las acciones de un estado de actividad solo se llevan a cabo una vez cuando se cumplen las condiciones; mientras el estado sea verdadero, las acciones no se repetirán. Si el estado cambia porque ya no se cumplen sus condiciones, las acciones se volverán a realizar la próxima vez que se cumplan.

En OpenText Identity Console, abra la página Configuración de actividad de controladores de un controlador cuyas acciones desee modificar:
1. Abra la página principal de OpenText Identity Console.
2. Seleccione Controladores > haga clic en el controlador adecuado en la lista > Inspector > Configuración de actividad de controladores.
Haga clic en la pestaña Verde, Amarillo o Rojo del estado cuyas acciones desee modificar.
Haga clic en el icono más (+) situado junto al encabezado Acciones para añadir una acción y, a continuación, seleccione el tipo de acción que desee:
- Iniciar controlador: inicia el controlador.
- Detener controlador: detiene el controlador.
- Reiniciar controlador: detiene y, a continuación, inicia el controlador.
- Borrar caché del controlador: elimina todas las transacciones, incluidas las transacciones sin procesar, del caché.
- Enviar mensaje de correo electrónico: envía un mensaje de correo electrónico a uno o varios destinatarios. La plantilla que desea utilizar en el cuerpo del mensaje de correo electrónico debe existir. Para incluir el nombre del controlador, el nombre del servidor y la información de estado de actividad actual en el mensaje de correo electrónico, añada los testigos $Driver$, $Server$ y $HealthState$ a la plantilla de correo electrónico y, a continuación, incluya los testigos en el texto del mensaje. Por ejemplo:
```
The current health state of the $Driver$ driver running on $Server$ is $HealthState$.
```
  IMPORTANTE:Para enviar mensajes de correo electrónico a varios usuarios, separe cada dirección solo con una coma (,). No utilice punto y coma en lugar de coma.
- Escribir mensaje de seguimiento: escribe un mensaje en el archivo de registro de la tarea Actividad de controladores o en el archivo de registro del conjunto de controladores si el archivo de seguimiento no se ha configurado en la tarea Actividad de controladores.
- Generar evento: genera un evento que pueden utilizar Audit y Sentinel.
- Ejecutar ECMAScript: ejecuta un ECMAScript existente.
  
  Para obtener información sobre cómo crear guiones ECMA, consulte Using ECMAScript in Policies (Uso de ECMAScript en directivas) en OpenText Identity Manager - Using Designer to Create Policies (OpenText Identity Manager: uso de Designer para crear directivas).
- Iniciar un flujo de trabajo: inicia un flujo de trabajo de provisión.
- Al producirse un error: si falla una acción, indica lo que se debe hacer con las acciones restantes, el estado de actividad actual y la tarea Actividad de controladores.
  - Aplicar a acciones por: puede seguir ejecutando las acciones restantes o detenerlas, o bien establecer el valor actual como por defecto. El ajuste actual solo se aplica si tiene varias acciones Al producirse un error y define la opción Aplicar acciones por en una de las acciones Al producirse un error anteriores.
  - Aplicar a estado por: puede guardar o rechazar el estado actual, o bien establecer el valor actual como por defecto. Si guarda el estado, las condiciones del estado se seguirán evaluando como verdaderas. Al rechazar el estado, las condiciones del estado se evaluarán como falsas. El ajuste actual solo se aplica si tiene varias acciones Al producirse un error y define la opción Aplicar a estado por en una de las acciones Al producirse un error anteriores.
  - Aplicar a tarea de estado del controlador por: puede continuar con la ejecución de la tarea, abortarla e inhabilitarla o establecer el valor actual como por defecto. Si se sigue ejecutando la tarea, esta terminará de evaluar las condiciones para determinar el estado de actividad del controlador y realizará cualquier acción asociada al estado. Al abortar e inhabilitar la tarea, se detiene su actividad actual y se cierra; la tarea no se volverá a ejecutar hasta que la habilite. El ajuste actual solo se aplica si tiene varias acciones Al producirse un error y define la opción Aplicar a tarea de estado del controlador por en una de las acciones Al producirse un error anteriores.
Cuando haya terminado, guarde los cambios. Para ello, haga clic en el botón Guardar.

Creación de un estado personalizado

Puede crear uno o varios estados personalizados para realizar acciones independientemente del estado de actividad actual del controlador (verde, amarillo o rojo). Si se cumplen las condiciones de un estado personalizado, sus acciones se llevan a cabo independientemente del estado de actividad actual.

Al igual que con los estados verde, amarillo y rojo, las acciones de un estado personalizado se llevan a cabo solo una vez cuando se cumplen las condiciones; mientras el estado sea verdadero, las acciones no se repetirán. Si el estado cambia porque ya no se cumplen sus condiciones, las acciones se volverán a realizar la próxima vez que se cumplan.

En OpenText Identity Console, abra la página Configuración de actividad de controladores del controlador para el que desee crear un estado personalizado:
1. Abra la página principal.
2. Seleccione Controladores > haga clic en el controlador adecuado en la lista > Inspector > Configuración de actividad de controladores.
Haga clic en el icono situado junto a los iconos de estado de actividad del controlador (verde, amarillo y rojo).
Siga las instrucciones indicadas en Modificación de las condiciones de actividad del controlador y Modificación de las acciones de actividad del controlador para definir las condiciones y las acciones del estado personalizado.

Modificación de un estado personalizado

Para modificar estados personalizados, realice los siguientes pasos:

En OpenText Identity Console, abra la página Configuración de actividad de controladores del controlador para el que desee crear un estado personalizado:
1. Abra la página principal.
2. Seleccione Controladores > haga clic en el controlador adecuado en la lista > Inspector > Configuración de actividad de controladores.
Haga clic en el icono situado junto a los iconos de estado de actividad del controlador (verde, amarillo y rojo).
Siga las instrucciones indicadas en Modificación de las condiciones de actividad del controlador y Modificación de las acciones de actividad del controlador para definir las condiciones y las acciones del estado personalizado.