Atributos y pruebas registrados del proveedor de diagnósticos

Cada proveedor de diagnósticos (DP) proporciona una lista de atributos de volcado de estado, atributos de volcado de configuración, autopruebas y atributos de autoprueba. Las pruebas son operaciones que puede realizar el DP. Los atributos son porciones de información que se pueden recopilar de un volcado de configuración, vuelvo de estado o prueba de autodiagnóstico específico.

Cada atributo puede verse como una porción de información con una etiqueta. Además los atributos se consideran registrados o no registrados. Un atributo registrado es uno que debe estar disponible de un release de WebSphere Application Server al siguiente. Es posible que un atributo no registrado no esté disponible en su forma actual en futuros releases del producto (no existe ningún compromiso).

Al realizar un vuelvo de configuración, volcado de estado o prueba de autodiagnóstico, un administrador o las herramientas automáticas pueden solicitar valores sólo registrados o todos dependiendo de las necesidades del administrador o herramienta. Tenga en cuenta que la opción de filtrado de resultados sólo está disponible a través de la interfaz del MBean JMX (Java™ Management Extension) del proveedor de diagnósticos, a la que puede acceder de forma programada o mediante la herramienta wsadmin.

Archivo XML DiagnosticProviderRegistration

El archivo XML (Extensible Markup Language) DiagnosticProviderRegistration se utiliza junto con las signaturas de método para filtrar los resultados de la invocación de varios métodos. Este archivo XML define la información de configuración, información de estado y pruebas de autodiagnóstico expuestas por el componente. En la información de configuración y de estado, la unidad de trabajo clave se conoce como atributo. La especificación de un atributo se realiza del siguiente modo:
<attribute>
        <id><Expresión regular que representa el nombre de atributo></id>
        <descriptionKey><MsgKey en un ResourceBundle para la localización de la etiqueta></descriptionKey>
        <registered>true</registered>
   </attribute>
Las partes son las siguientes:
ID:
Nombre del atributo. Este nombre puede expresarse con caracteres comodín siguiendo la sintaxis de expresiones regulares. El ID de atributo registrado se utiliza en los siguientes lugares:
  • En los métodos de volcado de configuración y de estado del proveedor de diagnósticos para determinar qué atributos se van devolver.
  • En la consola administrativa para hacer coincidir las claves de descripción con los atributos devueltos por una petición a un proveedor de diagnósticos para realizar un volcado de configuración, un volcado de estado o una operación de autodiagnóstico.
Como ejemplo, si un volcado de configuración devuelve un atributo con el ID cachedServlet-MyServlet-servletPath a la consola administrativa, ésta podría utilizar la descriptionKey correspondiente al atributo registrado como <id>cachedServlet-.*-servletPath</id> al seleccionar qué texto de descripción que se va a colocar al lado del nombre y valores de retorno de este atributo.
descriptionKey:
Esta es una clave incluida en un resourceBundle para la localización.
registered:
Se trata de un booleano que cualifica si este atributo estará disponible de un release de software al siguiente. Si registered está establecido en true, este atributo debería estar disponible en el próximo release. Si registered es false, no hay garantía de que este atributo continúe existiendo. Se debe tener cuidado con la automatización al manejar atributos que no estén registrados.
La especificación de una selfDiagnosticTest se realiza del siguiente modo:
<test>
       <id><Expresión regular del nombre de la prueba></id>
       <descriptionKey><MsgKey en un ResourceBundle para la localización de la etiqueta></descriptionKey>
       <attribute><Uno o varios atributos que serán la salida de esta prueba></attribute>
</test>
Las partes son las siguientes:
ID:
Parecido al ID del atributo pero, en este caso, describe la prueba que se va a realizar en lugar del atributo que se va a devolver.
descriptionKey:
Esta es una clave incluida en un resourceBundle para la localización.

Interfaces de método

public DiagnosticEvent [] configDump(String aAttributeId, boolean aRegisteredOnly);
public DiagnosticEvent [] stateDump(String aAttributeId, boolean aRegisteredOnly);

Estos métodos invocan el volcado de configuración o de estado del componente y especifican un filtro de expresiones regulares para los atributos que se deben devolver además de filtrar la salida para que incluya todos los atributos que coincidan o sólo los atributos que estén registrados. Esto permite al administrador o software automático que controla el método especificar un subconjunto de los campos globales (de especial importancia si se exponen muchos atributos o si la especificación de la colección de estados incrementa la cantidad de datos disponibles). Los siguientes métodos de ayudante están disponibles para ayudar con el filtrado de la salida:

Para tomar una lista de atributos que estén disponibles para que se devuelvan y se filtren:
    public static AttributeInfo [] queryMatchingDPInfoAttributes(String aAttributeId,
        AttributeInfo [] inAttrs, String [] namesToCheck, boolean aRegisteredOnly) {
Para tomar un sólo atributo que esté disponible para que se devuelva y se filtre:
    public static AttributeInfo queryMatchingDPInfoAttributes(String aAttributeId,
        AttributeInfo [] inAttrs, String nameToCheck, boolean aRegisteredOnly) {
Para examinar un conjunto lleno de información de atributos y eliminar la partes innecesarias:
    public static void filterEventPayload(String aAttributeId, HashMap payLoad) {

Para obtener detalles de estos mensajes, revise la documentación de la API para la clase DiagnosticProviderHelper. El concepto básico es que, una vez que el componente tenga conocimiento de los atributos que se pueden devolver, el método de ayudante determinará cuáles se devolverán en función de la lógica de expresión regular y del booleano de registro.

La interfaz del método selfDiagnostic es parecida a las interfaces Configdump y Statedump:
public DiagnosticEvent[] selfDiagnostic(String aTestId, boolean aRegisteredOnly)
La diferencia es que el primer parámetro es un filtro de expresiones regulares para la prueba que se debe ejecutar.

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ctrb_dpregattest
File name: ctrb_dpregattest.html