Comando mfwkadm

En esta sección se reproduce la página del manual (man) correspondiente al comando mfwkadm, un comando de mantenimiento incluido en la página del manual, sección 1M. Utilice este comando para administrar el contenido de un agente de nodo, incluyendo todos los módulos de componentes en supervisión y las reglas de supervisión (conocidas también como trabajos) que haya definido en este nodo. Algunos de los términos y descripciones de la página del manual (man) se han modificado aquí para que coincidan con los utilizados en este documento.

Resumen

Supervisión del rendimiento

Supervisión del estado de funcionamiento

Supervisión del valor de umbral

Descripción

La utilidad mfwkadm es la interfaz de línea de comandos para administrar el agente de Monitoring Framework, denominado también agente de nodo. El agente de nodo se ejecuta dentro de Common Agent Container. La utilidad mfwkadm se puede utilizar para detener y reiniciar el agente de nodo y para administrar los trabajos de supervisión que realiza. Este comando se debe ejecutar desde el mismo host en el que se ejecuta el agente de nodo. Se debe respetar el orden de los argumentos de este comando que se indica aquí.

Para cambiar el idioma de los mensajes de salida, defina la variable de entorno LC_MESSAGE según su configuración regional. El comando mfwkadm utilizará los mensajes incluidos en el archivo llamado JesmfMessages_ configuración regional.pm existente en el directorio lib/resources. Si la configuración regional no tiene ningún archivo de mensajes correspondiente, o si no se especifica ninguna configuración regional, el comando mfwkadm utilizará el conjunto de mensajes predeterminado del archivo JesmfMessages.pm.

La utilidad mfwkadm tiene los siguientes subcomandos. Los marcados con un asterisco (*) requieren que Common Agent Container esté ejecutándose y que el agente de nodo esté cargado:

• start

• stop

• restart

• list-params (*)

• list-modules (*)

• info (*)

• pm-job (*)

• opstat-job (*)

• thrsh-job (*)

Dependiendo del número de módulos de Common Agent Container que se cargue, se producirá un retardo de unos segundos a unos minutos entre el inicio del agente de nodo y la disponibilidad de la utilidad mfwkadm. Durante este periodo de tiempo, los comandos fallan mostrando un mensaje explícito.

Opciones

Se admiten las siguientes opciones.

--help

Muestra el resumen de utilización.

Subcomandos

start

Inicia el agente de nodo de Monitoring Framework y sus módulos de producto componente asociados sin detener Common Agent Container.

Esta acción implementa en Common Agent Container el agente de nodo primero y, a continuación, los módulos de producto componente asociados. Esta utilidad es un programa de ajuste además de los subcomandos lock y undeploy de la utilidad cacaoadm.

El subcomando start sólo inicia el agente de nodo y los módulos del componente de Java ES asociados a Monitoring Framework. Los módulos del componente tienen el prefijo com.sun.cmm.

Seguridad: el subcomando start sólo lo puede ejecutar el usuario que inicie Common Agent Container. En caso contrario, aparecerá un mensaje de error similar al mostrado a continuación:

Error occured in mfwkadm Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

stop

Detiene el agente de nodo de Monitoring Framework y sus módulos del componente asociados de Java ES en Common Agent Container.

Esta acción detiene primero los módulos del componente de Java ES implementados en Common Agent Container y, a continuación, detiene el agente de nodo. Esta utilidad es un programa de ajuste además de los subcomandos lock y unlock de la utilidad cacaoadm.

El subcomando stop detiene sólo los módulos del componente de Java ES asociados a Monitoring Framework y, a continuación, el agente de nodo en sí. Los módulos del componente tienen el prefijo com.sun.cmm.

Seguridad: el subcomando stop sólo lo puede ejecutar el usuario que inicie Common Agent Container. En caso contrario, aparecerá un mensaje de error similar al mostrado a continuación:

Error occured in mfwkadm Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

restart

Reinicia el agente de nodo de Monitoring Framework y sus módulos del componente asociados de Java ES en Common Agent Container.

Esta acción intentará detener y, a continuación, iniciar el agente de nodo y sus módulos asociados en Common Agent Container de la misma manera que los subcomandos stop y start.

Seguridad: el subcomando restart sólo lo puede ejecutar el usuario que inicie Common Agent Container. En caso contrario, aparecerá un mensaje de error similar al mostrado a continuación:

Error occured in mfwkadm Problem running //usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

list-params

Enumera todos los parámetros de configuración relacionados con el agente de nodo de Monitoring Framework.

Seguridad: no existe ninguna restricción de usuario para este comando.

list-modules

Muestra una lista de los módulos de producto componente que implementan el Common Monitoring Model (CMM) y que se cargan en Common Agent Container. Este subcomando enumera también todas las instancias en ejecución de cada componente de Java ES instalado. Cada componente puede tener una, varias o ninguna instancia en ejecución.

Seguridad:para los usuarios que no sean el que ha iniciado Common Agent Container, la lista de componentes de Java ES instalados no incluye instancias de componente.

info Instanciaenejecución

Muestra información sobre la Instanciaenejecución nombrada. La Instanciaenejecución debe coincidir con una instancia en ejecución enumerada en la salida del subcomando list-modules.

La información mostrada incluye lo siguiente:

• Para cada tipo de trabajo de supervisión, todos los objetos observables asociados a la instancia en ejecución, ordenados según su nombre de clase. Los objetos observables son aquellos en los que puede crear un trabajo de supervisión del rendimiento, un trabajo de estado de funcionamiento o un trabajo de supervisión del umbral utilizando los subcomandos pm-job, opstat-job o thrsh-job, respectivamente.

• Para cada clase de objetos observables, todos sus atributos observables, incluyendo el nombre y tipo de cada uno de ellos.

Seguridad: para los usuarios que no sean el que ha iniciado Common Agent Container, no aparecerá ninguna información.

Supervisión del rendimiento

pm-job observable-classes

Muestra la lista de todas las clases de objetos actualmente observables para los que se pueden crear trabajos de supervisión del rendimiento.

pm-job observable-objects [class= Clasedeobjeto] [domain=Dominiodeobjeto]

Muestra la lista de todos los objetos actualmente observables para los que se pueden crear trabajos de supervisión del rendimiento. De manera predeterminada, se enumerarán todos los objetos de todas las clases observables y en todos los dominios. La lista de objetos se ordena según su nombre de clase.

class=Clasedeobjeto

Al especificar la Clasedeobjeto opcional, la salida se limitará a los objetos observables de esa clase específica. La Clasedeobjeto debe ser una de las clases enumeradas por el subcomando pm-job observable-classes.

domain=Dominiodeobjeto

Al especificar el Dominiodeobjeto opcional, la salida se limitará a los objetos observables de ese dominio. El dominio de un objeto es la cadena que precede a los dos puntos (:) en el nombre de un objeto.

pm-job observable-attributes class=Clasedeobjeto

Muestra la lista de todos los atributos observables de la Clasedeobjeto especificada. Los atributos aparecen con su nombre y tipo. La Clasedeobjeto debe ser una de las clases que admite trabajos de supervisión del rendimiento, según se enumeran mediante el subcomando pm-job observable-classes .

pm-job list

Muestra la lista de todos los trabajos de supervisión del rendimiento actualmente definidos. Los trabajos se enumeran para cada objeto que tenga un trabajo de rendimiento definido, y los objetos se ordenan según su nombre de clase. La información mostrada para cada trabajo es la misma que la mostrada por el subcomando pm-job info.

Seguridad: para los usuarios que no sean el que ha iniciado Common Agent Container, no aparecerá ningún trabajo.

pm-job info Nombredetrabajo

Muestra información detallada sobre un trabajo de supervisión del rendimiento llamado Nombredetrabajo. El Nombredetrabajo debe ser uno de los mostrados por el subcomando pm-job list. Este subcomando muestra la siguiente información:

• Nombre del trabajo de supervisión del rendimiento.

• Tipo de trabajo de supervisión del rendimiento, ya sea "por objeto o por clase".Los trabajos por objeto supervisan una o varias instancias de objetos con nombre, mientras que los trabajos por clase supervisan todas las instancias de una clase de objeto. Tenga en cuenta que no es posible crear trabajos por clase con la utilidad mfwkadm.

• Estado del trabajo de supervisión del rendimiento: activo en servicio, activo fuera de servicio o suspendido. Un trabajo activo en servicio está programado actualmente para ejecutarse y está recopilando datos. Un trabajo activo fuera de servicio está ejecutándose pero no recopila datos, ya que la hora actual está fuera de su programación de funcionamiento. Un trabajo suspendido no está ejecutándose ni recopilando datos. Utilice los subcomandos pm-job suspend y pm-job resume para cambiar el estado de ejecución de un trabajo de supervisión del rendimiento.

• La granularidad en segundos del trabajo de supervisión del rendimiento. Se trata del intervalo para la recopilación de datos por parte de este trabajo.

• El periodo de informe del trabajo de supervisión. El periodo de informe de la granularidad equivale a la frecuencia de notificación. Por ejemplo, si el periodo de granularidad es de 10 segundos y el periodo de informe es de 6, un trabajo que informe por evento recopilará datos cada 10 segundos y enviará una notificación que incluye 6 informes cada 60 segundos (10*6). Si el trabajo informa también por archivo, enviará un evento cada 60 segundos que contiene las ubicaciones de los 6 archivos generados.

• Si el trabajo de supervisión del rendimiento informa por evento. Esto significa que los resultados del trabajo de supervisión del rendimiento se envían como notificaciones a un cliente registrado.

• Si el trabajo de supervisión del rendimiento informa por archivo. Esto significa que los informes del trabajo de supervisión del rendimiento se escriben en archivos locales y notificaciones que contienen los nombres de archivo que se envían a clientes registrados.

• El formato del informe del trabajo de supervisión del rendimiento, que es siempre XML.

• La programación del trabajo de supervisión del rendimiento. La programación especifica los días y horas en que el trabajo está activo en servicio o activo fuera de servicio (recopilando datos o no, respectivamente).

A continuación, para un trabajo por objeto:

• La lista de objetos observados, ordenados por nombre.

• Si sólo se especifica un subconjunto de atributos observables, los atributos observados de los objetos observados se enumerarán por nombre y tipo.

Y para un trabajo por clase:

• La lista de clases observadas, ordenadas por nombre.

• Si sólo se especifica un subconjunto de atributos observables, los atributos observados de las clases observadas se enumerarán por nombre y tipo. Estos atributos son comunes a todas las clases.

Seguridad: para los usuarios que no sean el que ha iniciado Common Agent Container, no aparecerá ninguna información.

pm-job create Nombredetrabajo granularity= Valordenúmeroentero object=Nombredeobjeto [object= Nombredeobjeto ...]

Crea un trabajo de supervisión del rendimiento en uno o varios objetos. El comando mfwkadm no puede crear trabajos por clase. Al crear trabajos de supervisión del rendimiento, se pueden definir los siguientes parámetros:

Nombredetrabajo

Cadena que identifica exclusivamente el trabajo de supervisión del rendimiento. El Nombredetrabajo no puede estar utilizándose ya en ningún otro trabajo de supervisión del rendimiento.

granularity=Valordenúmeroentero

Tiempo especificado en segundos entre el inicio de dos recopilaciones sucesivas de datos de medición, mientras el trabajo está activo en servicio. Ejemplos de periodo de granularidad pueden ser 300 segundos (5 minutos), 900 segundos (15 minutos), 1.800 segundos (cada media hora) y 3.600 segundos (cada hora). Un periodo de granularidad de 300 segundos es suficiente en la mayoría de los casos. Para algunas mediciones, puede ser más significativo recopilar datos con periodos mayores de granularidad.

object=Nombredeobjeto [object= Nombredeobjeto ...]

Uno o varios objetos observables a partir de los que el trabajo de supervisión del rendimiento recopilará datos y sobre los que informará. El Nombredeobjeto debe ser uno de los mostrados por los subcomandos pm-job list o pm-job observable-objects. Al especificar parámetros multiple object= Nombredeobjeto, se creará un único trabajo de supervisión del rendimiento que supervisará varios objetos.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

pm-job delete Nombredetrabajo

Elimina un trabajo de supervisión del rendimiento llamado Nombredetrabajo. El Nombredetrabajo debe ser uno de los mostrados por el subcomando pm-job list.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

pm-job suspend Nombredetrabajo

Suspende un trabajo de supervisión del rendimiento llamado Nombredetrabajo. Un trabajo suspendido no está activo y no recopilará datos, independientemente de su programación. No obstante, el trabajo permanece definido y se puede activar de nuevo con el subcomando pm-job resume. El Nombredetrabajo debe ser uno de los mostrados por el subcomando pm-job list.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

pm-job resume Nombredetrabajo

Reanuda un trabajo de supervisión del rendimiento llamado Nombredetrabajo. Un trabajo reanudado comenzará a recopilar datos y a enviar informes según su programación. El Nombredetrabajo debe ser uno de los mostrados por el subcomando pm-job list. Es el equivalente al subcomando pm-job suspend.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

Supervisión del estado de funcionamiento

opstat-job observable-classes

Muestra la lista de todas las clases de objetos actualmente observables para los que se pueden crear trabajos de supervisión del estado de funcionamiento.

opstat-job observable-objects [class= Clasedeobjeto] [domain=Dominiodeobjeto]

Muestra la lista de todos los objetos actualmente observables para los que se pueden crear trabajos de supervisión del estado de funcionamiento. De manera predeterminada, se enumerarán todos los objetos de todas las clases observables y en todos los dominios. La lista de objetos se ordena según su nombre de clase.

class=Clasedeobjeto

Al especificar la Clasedeobjeto opcional, la salida se limitará a los objetos observables de esa clase específica. La Clasedeobjeto debe ser una de las clases enumeradas por el subcomando opstat-job observable-classes.

domain=Dominiodeobjeto

Al especificar el Dominiodeobjeto opcional, la salida se limitará a los objetos observables de ese dominio. El dominio de un objeto es la cadena que precede a los dos puntos (:) en el nombre del objeto.

opstat-job observable-attributes class= Clasedeobjeto

Muestra la lista de todos los atributos observables de la Clasedeobjeto especificada. Los atributos aparecen con su nombre y tipo. La Clasedeobjeto debe ser una de las clases enumeradas por el subcomando opstat-job observable-classes.

opstat-job list

Muestra la lista de todos los trabajos de supervisión del estado de funcionamiento actualmente definidos. Los trabajos se enumeran para cada objeto que tenga un trabajo de estado de funcionamiento definido, y los objetos se ordenan según su nombre de clase. La información mostrada para cada trabajo es la misma que la mostrada por el subcomando opstat-job info.

Seguridad: Para los usuarios que no sean el que ha iniciado Common Agent Container, no aparecerá ningún trabajo.

opstat-job info Nombredetrabajo

Muestra información detallada sobre un trabajo de supervisión del estado de funcionamiento llamado Nombredetrabajo. El Nombredetrabajo debe ser uno de los mostrados por el subcomando opstat-job list. Este subcomando muestra la siguiente información:

• Nombre del trabajo de supervisión del estado de funcionamiento.

• Tipo de trabajo de supervisión del estado de funcionamiento, ya sea "por objeto" o "por clase".Los trabajos por objeto supervisan una instancia de objeto con nombre, mientras que los trabajos por clase supervisan todas las instancias de una clase de objeto. Tenga en cuenta que no es posible crear trabajos por clase con la utilidad mfwkadm.

• Estado del trabajo de supervisión del estado de funcionamiento: activo en servicio, activo fuera de servicio o suspendido. Un trabajo activo en servicio está programado actualmente para ejecutarse y está recopilando datos. Un trabajo activo fuera de servicio está ejecutándose pero no recopila datos, ya que la hora actual está fuera de su programación de funcionamiento. Un trabajo suspendido no está ejecutándose ni recopilando datos. Utilice los subcomandos opstat-job suspend y opstat-job resume para cambiar el estado de ejecución de un trabajo de supervisión del estado de funcionamiento.

• La granularidad en segundos del trabajo de supervisión del estado de funcionamiento. Se trata del intervalo para la recopilación de datos por parte de este trabajo.

• Si el trabajo de supervisión del estado de funcionamiento informa por evento. Esto significa que los resultados del trabajo de supervisión del estado de funcionamiento se envían como notificaciones a un cliente registrado.

• Si el trabajo de supervisión del estado de funcionamiento informa por archivo. Esto significa que los informes del trabajo de supervisión del estado de funcionamiento se escriben en archivos locales y notificaciones que contienen los nombres de archivo que se envían a clientes registrados.

• El formato del informe del trabajo de supervisión del estado de funcionamiento, que es siempre XML.

• La programación del trabajo de supervisión del estado de funcionamiento. La programación especifica los días y horas en que el trabajo está activo en servicio o activo fuera de servicio (recopilando datos o no, respectivamente).

• Para un trabajo por objeto, la lista de objetos observados, ordenados por nombre.

• Para un trabajo por clase, la lista de clases observadas, ordenadas por nombre.

Seguridad: para los usuarios que no sean el que ha iniciado Common Agent Container, no aparecerá ninguna información.

opstat-job create Nombredetrabajo granularity= Valordenúmeroentero object=Nombredeobjeto [object= Nombredeobjeto ...]

Crea un trabajo de supervisión del estado de funcionamiento en uno o varios objetos. El comando mfwkadm no puede crear trabajos por clase. Al crear trabajos de supervisión del rendimiento, se pueden definir los siguientes parámetros:

Nombredetrabajo

Cadena que identifica exclusivamente el trabajo de supervisión del estado de funcionamiento. El Nombredetrabajo no puede estar utilizándose ya en ningún otro trabajo de supervisión del estado de funcionamiento.

granularity=Valordenúmeroentero

Tiempo especificado en segundos entre el inicio de dos recopilaciones sucesivas de datos de medición, mientras el trabajo está activo en servicio.

object=Nombredeobjeto [object= Nombredeobjeto ...]

Uno o varios objetos observables a partir de los que el trabajo de supervisión del estado de funcionamiento recopilará datos y sobre los que informará. El Nombredeobjeto debe ser uno de los mostrados por los subcomandos opstat-job list o opstat-job observable-objects. Al especificar parámetros multiple object= Nombredeobjeto, se creará un único trabajo de supervisión del estado de funcionamiento que supervisará varios objetos.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

opstat-job delete Nombredetrabajo

Elimina un trabajo de supervisión del estado de funcionamiento llamado Nombredetrabajo. El Nombredetrabajo debe ser uno de los mostrados por el subcomando opstat-job list.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

opstat-job suspend Nombredetrabajo

Suspende un trabajo de supervisión del estado de funcionamiento llamado Nombredetrabajo. Un trabajo suspendido no está activo y no recopilará datos, independientemente de su programación. No obstante, el trabajo permanece definido y se puede activar de nuevo con el subcomando opstat-job resume. El Nombredetrabajo debe ser uno de los mostrados por el subcomando opstat-job list.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

opstat-job resume Nombredetrabajo

Reanuda un trabajo de supervisión del estado de funcionamiento llamado Nombredetrabajo. Un trabajo reanudado comenzará a recopilar datos y a enviar informes según su programación. El Nombredetrabajo debe ser uno de los mostrados por el subcomando opstat-job list. Es el equivalente al subcomando opstat-job suspend.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

Supervisión del valor de umbral

thrsh-job observable-classes

Muestra la lista de todas las clases de objetos actualmente observables para los que se pueden crear trabajos de supervisión del umbral.

thrsh-job observable-objects [class= Clasedeobjeto] [domain=Dominiodeobjeto]

Muestra la lista de todos los objetos actualmente observables para los que se pueden crear trabajos de supervisión del umbral. De manera predeterminada, se enumerarán todos los objetos de todas las clases observables y en todos los dominios. La lista de objetos se ordena según su nombre de clase.

class=Clasedeobjeto

Al especificar la Clasedeobjeto opcional, la salida se limitará a los objetos observables de esa clase específica. La Clasedeobjeto debe ser una de las clases enumeradas por el subcomando thrsh-job observable-classes.

domain=Dominiodeobjeto

Al especificar el Dominiodeobjeto opcional, la salida se limitará a los objetos observables de ese dominio. El dominio de un objeto es la cadena que precede a los dos puntos (:) en el nombre del objeto.

thrsh-job observable-attributes class=Clasedeobjeto

Muestra la lista de todos los atributos observables de la Clasedeobjeto especificada. Los atributos aparecen con su nombre y tipo. La Clasedeobjeto debe ser una de las clases enumeradas por el subcomando thrsh-job observable-classes.

thrsh-job list

Muestra la lista de todos los trabajos de supervisión del umbral actualmente definidos. Los trabajos se enumeran para cada objeto que tenga un trabajo de umbral definido, y los objetos se ordenan según su nombre de clase. La información mostrada para cada trabajo es la misma que la mostrada por el subcomando thrsh-job info.

Seguridad: Para los usuarios que no sean el que ha iniciado Common Agent Container, no aparecerá ningún trabajo.

thrsh-job info Nombredetrabajo

Muestra información detallada sobre un trabajo de supervisión del umbral llamado Nombredetrabajo. El Nombredetrabajo debe ser uno de los mostrados por el subcomando thrsh-job list. Este subcomando muestra la siguiente información:

• Nombre del trabajo de supervisión del umbral.

• Multiplicidad del trabajo de supervisión del umbral. En esta versión, sólo se pueden realizar trabajos de umbral simples que supervisen un atributo en un objeto.

• Estado del trabajo de supervisión del umbral: activo en servicio, activo fuera de servicio o suspendido. Un trabajo activo en servicio está programado actualmente para ejecutarse y está recopilando datos. Un trabajo activo fuera de servicio está ejecutándose pero no recopila datos, ya que la hora actual está fuera de su programación de funcionamiento. Un trabajo suspendido no está ejecutándose ni recopilando datos. Utilice los subcomandos thrsh-job suspend y thrsh-job resume para cambiar el estado de ejecución de un trabajo de supervisión del umbral.

• La granularidad en segundos del trabajo de supervisión del umbral. Se trata del intervalo para la recopilación de datos por parte de este trabajo.

• La programación del trabajo de supervisión del umbral. La programación especifica los días y horas en que el trabajo está activo en servicio o activo fuera de servicio (recopilando datos o no, respectivamente).

• La configuración de la alarma del trabajo de supervisión del umbral. Se trata de la alarma que se activará cuando el valor observado del atributo supervisado cruce el valor de umbral definido. En la indicación se incluye el tipo y gravedad de la alarma.

• El objeto observado del trabajo de supervisión del umbral.

• El nombre de atributo al que se aplica el umbral.

• El valor del umbral que activará una alarma.

• La dirección del progreso del valor que activará una alarma en el umbral, ya sea RISING o FALLING.

• El desplazamiento de tolerancia del umbral. Si la dirección es RISING, la alarma no se activará de nuevo hasta que el atributo observado sea inferior al Valordeumbral-Valordedesplazamiento. Si la dirección es FALLING, la alarma no se activará de nuevo hasta que el atributo observado sea superior al Valordeumbral+Valordedesplazamiento. Este comportamiento conserva el valor "true" incluso cuando el desplazamiento es cero.

Seguridad: para los usuarios que no sean el que ha iniciado Common Agent Container, no aparecerá ninguna información.

thrsh-job create Nombredetrabajo object= Nombredeobjeto granularity=Valordenúmeroentero attributeName= Nombredeatributo attributeType=Tipodeatributo thresholdValue= Valordeumbral thresholdOffset=Valordedesplazamiento thresholdDirection= [RISING|FALLING]

Crea un trabajo de supervisión del umbral que supervisa un atributo en un solo objeto. Al crear trabajos de umbral, se pueden definir los siguientes parámetros:

Nombredetrabajo

Cadena que identifica exclusivamente el trabajo de supervisión del umbral. El Nombredetrabajo no puede estar utilizándose ya en ningún otro trabajo de supervisión del umbral.

object=Nombredeobjeto

El objeto observable en el que el trabajo de supervisión del umbral recopilará los valores de atributo para compararlos con el umbral. El Nombredeobjeto debe ser uno de los mostrados por los subcomandos thrsh-job list o thrsh-job observable-objects

granularity=Valordenúmeroentero

Tiempo especificado en segundos entre el inicio de dos observaciones sucesivas del valor de atributo, mientras el trabajo está activo en servicio.

attributeName=Nombredeatributo

El nombre del atributo para el que el trabajo de supervisión del umbral recopila valores y los compara con el umbral. El Nombredeatributo debe enumerarse mediante los subcomandos thrsh-job info o thrsh-job observable-attributes.

attributeType=Tipodeatributo

Tipo de atributo observable que va a supervisarse. El Tipodeatributo debe enumerarse mediante los subcomandos thrsh-job info o thrsh-job observable-attributes.

thresholdValue=Valordeumbral

El valor del atributo supervisado que provocará que este trabajo de umbral active una alarma al cruzarse en la dirección especificada por thresholdDirection.

thresholdOffset=Valordedesplazamiento

El Valordedesplazamiento determina la tolerancia del trabajo de umbral al activar alarmas sucesivas. El Valordedesplazamiento debe ser cero o un valor positivo. Tras activarse un evento de alarma, no se activará ningún evento de alarma nuevo hasta que el valor del atributo supervisado supere el rango definido por el Valordedesplazamiento y la Direccióndeumbral.

thresholdDirection=[RISING|FALLING]

Si la dirección es RISING, el evento de alarma no se activará de nuevo hasta que el valor del atributo observado sea inferior al Valordeumbral-Valordedesplazamiento. Si la dirección es FALLING, el evento de alarma no se activará de nuevo hasta que el valor del atributo observado sea superior al Valordeumbral+Valordedesplazamiento. Este comportamiento conserva el valor "true" incluso cuando el Valordedesplazamiento es cero.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

thrsh-job delete Nombredetrabajo

Elimina un trabajo de supervisión del umbral llamado Nombredetrabajo. El Nombredetrabajo debe ser uno de los mostrados por el subcomando thrsh-job list.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

thrsh-job suspend Nombredetrabajo

Suspende un trabajo de supervisión del umbral llamado Nombredetrabajo. Un trabajo suspendido no está activo y no recopilará datos, independientemente de su programación. No obstante, el trabajo permanece definido y se puede activar de nuevo con el subcomando thrsh-job resume. El Nombredetrabajo debe ser uno de los mostrados por el subcomando thrsh-job list.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

thrsh-job resume Nombredetrabajo

Reanuda un trabajo de supervisión del umbral llamado Nombredetrabajo. Un trabajo reanudado comenzará a recopilar datos y a enviar informes según su programación. El Nombredetrabajo debe ser uno de los mostrados por el subcomando thrsh-job list. Es el equivalente al subcomando thrsh-job suspend.

Seguridad: este subcomando sólo lo puede ejecutar el usuario que inicie Common Agent Container.

Ejemplos

En el siguiente escenario de ejemplo se muestra cómo emplear la utilidad mfwkadm , junto con sus opciones y subcomandos.

El subcomando list-modules muestra las instancias del componente de Java ES en el host actual y sus módulos correspondientes en Common Agent Container. En el siguiente ejemplo se enumeran dos componentes instalados: Directory Server sin instancias en ejecución y Web Server con una instancia en ejecución.

$ mfwkadm list-modules

Installed products and their running instances:
==============================================

Instances for installed product: com.sun.cmm.ds:collectionID=/opt/SUNWdsee/ds6,
name=Sun Java(TM) System Directory Server,type=CMM_InstalledProduct
-------------------------------

No instance.

Instances for installed product: com.sun.cmm.ws:collectionID=/var/opt/SUNWwbsvr7,
name=WebServer,type=CMM_InstalledProduct
-------------------------------

/wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,type=CMM_ApplicationSystem

El siguiente subcomando info muestra objetos observables en la instancia de Web Server, con sus clases y atributos para cada tipo de trabajo.

$ mfwkadm info /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,\\
type=CMM_ApplicationSystem

Information about running instance: /wsPrefix/com.sun.cmm.ws:
name=https-hostname.example.com,type=CMM_ApplicationSystem
==================================

Observable objects for performance jobs:
---------------------------------------

+ Objects of class: com.sun.cmm.settings.CMM_ApplicationSystemSetting

        /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com-setting,
type=CMM_ApplicationSystemSetting

        Observable attributes:

        Caption [STRING]
        ConfigurationDirectory [STRING]
        CreationClassName [STRING]
        Description [STRING]
        DirectoryName [STRING]
        ElementName [STRING]
        InstanceID [STRING]
        Name [STRING]
        URL [STRING]

+ Objects of class: com.sun.cmm.settings.CMM_KeepAliveSetting

        /wsPrefix/com.sun.cmm.ws:name=process-1-keepalive-setting,
type=CMM_KeepAliveSetting

        Observable attributes:

        AllocationUnit [STRING]
        Caption [STRING]
        ConnectionsUpperBound [LONG]
        CreationClassName [STRING]
        Description [STRING]
        ElementName [STRING]
        InputUnit [STRING]
        InstanceID [STRING]
        LowerAllocationLimit [LONG]
        LowerInputLimit [LONG]
        LowerOutputLimit [LONG]
        Name [STRING]
        OtherAllocationUnit [STRING]
        OtherInputUnit [STRING]
        OtherLowerAllocationLimit [LONG]
        OtherLowerInputLimit [LONG]
        OtherLowerOutputLimit [LONG]
        OtherOutputUnit [STRING]
        OtherUpperAllocationLimit [LONG]
        OtherUpperInputLimit [LONG]
        OtherUpperOutputLimit [LONG]
        OutputUnit [STRING]
        QueuedUpperBound [LONG]
        SecondsTimeout [LONG]
        TimeoutUpperBound [LONG]
        UpperAllocationLimit [LONG]
        UpperInputLimit [LONG]
        UpperOutputLimit [LONG]
        ...

El siguiente comando muestra la lista de trabajos de supervisión del rendimiento definidos. En este ejemplo, hay un trabajo de rendimiento llamado myPerfJob que supervisa un objeto:

$ mfwkadm pm-job list

BY_OBJECTS performance jobs:
===========================

Performance job information for: myPerfJob
-------------------------------

Type:                BY_OBJECTS
State:               ACTIVE_ON_DUTY
Granularity period:  30
Reporting period:    1
By event:            EVENT_SINGLE
By file:             EVENT_SINGLE
Report format:       XML
Schedule:
        Global start time: Immediately
        Global stop time: Forever
        Weekly schedule: Everyday
        Daily schedule: All day
Observed objects:
                /wsPrefix/com.sun.cmm.ws:name=virtualServer-hostname.example.com-
webApp-/-stats,type=CMM_VirtualServerWebModuleStats
Observed attributes:
                All available

BY_CLASSES performance jobs:
===========================

No jobs found.

El siguiente comando crea un trabajo de supervisión del estado de funcionamiento relacionado con dos objetos observables que se obtienen de los subcomandos opstat-job info o opstat-job observable-objects:

$ mfwkadm opstat-job create myOpStatJob granularity=60 \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1,type=CMM_UnixProcess \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1-DNSCache1,type=CMM_DnsCache

El siguiente comando suspende el trabajo creado anteriormente:

$ mfwkadm opstat-job suspend myOpStatJob

El siguiente comando muestra las clases observables correspondientes a los trabajos de supervisión del umbral potenciales:

$ mfwkadm thrsh-job observable-classes

Threshold jobs observable classes:
=================================

com.sun.cmm.cim.CIM_ScopedSettingData
com.sun.cmm.cim.CIM_SettingData
com.sun.cmm.cim.CIM_StatisticalData
com.sun.cmm.cim.statistics.CIM_EthernetPortStatistics
com.sun.cmm.cim.statistics.CIM_NetworkPortStatistics
com.sun.cmm.cim.statistics.j2ee.CIM_J2eeJVMStats
com.sun.cmm.cim.statistics.j2ee.CIM_J2eeStatistic
com.sun.cmm.settings.CMM_ApplicationSystemSetting
com.sun.cmm.settings.CMM_KeepAliveSetting
com.sun.cmm.settings.CMM_QueueTimeoutSetting
com.sun.cmm.settings.CMM_RFC2788ApplicationSystemSetting
com.sun.cmm.settings.CMM_ScopedSettingData
com.sun.cmm.settings.CMM_SoftwareResourceSetting
com.sun.cmm.settings.CMM_SWRBufferSetting
com.sun.cmm.settings.CMM_SWRLimitSetting
com.sun.cmm.settings.CMM_SWRQueueSetting
com.sun.cmm.settings.CMM_VirtualServerSetting
com.sun.cmm.statistics.CMM_ApplicationSystemStats
com.sun.cmm.statistics.CMM_ApplicationSystemWatchdogStats
com.sun.cmm.statistics.CMM_ConnectionQueueStats
com.sun.cmm.statistics.CMM_DnsCacheStats
com.sun.cmm.statistics.CMM_EthernetPortStats
com.sun.cmm.statistics.CMM_FileCacheStats
com.sun.cmm.statistics.CMM_HTTPResponsesStats
com.sun.cmm.statistics.CMM_JVMJSR174ExtStats
com.sun.cmm.statistics.CMM_JVMJSR174Stats
com.sun.cmm.statistics.CMM_JVMStats
com.sun.cmm.statistics.CMM_NetworkPortStats
com.sun.cmm.statistics.CMM_OperatingSystemStats
com.sun.cmm.statistics.CMM_ProcessorStats
com.sun.cmm.statistics.CMM_ProcessStats
com.sun.cmm.statistics.CMM_QueueTimeoutStats
com.sun.cmm.statistics.CMM_RFC2788ApplicationTableStats
com.sun.cmm.statistics.CMM_ServiceStats
com.sun.cmm.statistics.CMM_SoftwareResourceStats
com.sun.cmm.statistics.CMM_SolarisEthernetPortStats
com.sun.cmm.statistics.CMM_SolarisNetworkPortStats
com.sun.cmm.statistics.CMM_SolarisOperatingSystemStats
com.sun.cmm.statistics.CMM_SolarisProcessorStats
com.sun.cmm.statistics.CMM_SolarisProcessorSysinfoStats
com.sun.cmm.statistics.CMM_SolarisProcessorVmStats
com.sun.cmm.statistics.CMM_Statistic
com.sun.cmm.statistics.CMM_SWRBufferStats
com.sun.cmm.statistics.CMM_SWRCacheStats
com.sun.cmm.statistics.CMM_SWRLimitStats
com.sun.cmm.statistics.CMM_SWRQueueStats
com.sun.cmm.statistics.CMM_UnixOperatingSystemStats
com.sun.cmm.statistics.CMM_UnixProcessStats
com.sun.cmm.statistics.CMM_VirtualServerWebModuleStats
com.sun.cmm.statistics.CMM_WebModuleStats

El siguiente comando muestra los atributos observables de trabajos de umbral que supervisan objetos de clase com.sun.cmm.statistics.CMM_SWRQueueStats existentes en el ejemplo anterior:

$ mfwkadm thrsh-job observable-attributes \\
class=com.sun.cmm.statistics.CMM_SWRQueueStats

Threshold jobs observable attributes:
====================================

Class: com.sun.cmm.statistics.CMM_SWRQueueStats

Attributes:

BufferSize [LONG]
EntriesCount [LONG]
EntriesHighWaterMark [LONG]
EntriesLowWaterMark [LONG]
EntriesTotal [LONG]
ErrorCount [INTEGER]
FailedOperations [LONG]
LowerLimit [LONG]
OperationsCount [LONG]
OtherLowerLimit [LONG]
OtherUpperLimit [LONG]
OverflowsCount [LONG]
QueuedCount [LONG]
QueuedHighWater [LONG]
SampleInterval [LONG]
TotalQueuedCount [LONG]
UpperLimit [LONG]

El siguiente comando es otro ejemplo de creación de trabajos, aquí con un trabajo de umbral:

$ mfwkadm thrsh-job create myThreshJob granularity=30 \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1-threadPool-NativePool-stats,\\
type=CMM_SWRQueueStats attributeName=EntriesCount attributeType=LONG \\
thresholdValue=1000 thresholdOffset=10 thresholdDirection=RISING

En el siguiente ejemplo se muestra la salida del subcomando thrsh-job info correspondiente al trabajo de supervisión del umbral creado en el anterior ejemplo:

$ mfwkadm thrsh-job info myThreshJob

Threshold job information for: myThreshJob
-----------------------------

Type:                SIMPLE
State:               ACTIVE_ON_DUTY
Granularity period:  30
Schedule:
        Global start time: Immediately
        Global stop time: Forever
        Weekly schedule: Everyday
        Daily schedule: All day
Alarm configuration:
                Type: QualityOfServiceAlarm
                Severity: INDETERMINATE
Threshold definition(s):
                Object: /wsPrefix/com.sun.cmm.ws:name=process-1-threadPool-
NativePool-stats,type=CMM_SWRQueueStats
                        Attribute: EntriesCount [LONG]
                        Value: 1000
                        Direction: RISING
                        Offset: 10

Estado de salida

Se devuelven los siguientes valores de salida:

0

Finalización correcta

1

Se ha producido un error

Atributos

Consulte también

cacao.5, cacaoadm.1m