|
|
|
Puede añadir especificaciones relativas a zonas horarias a las llamadas getQuery o runQuery. Puede recuperar una lista de las zonas horarias disponibles mediante el comando getTimeZones.
Ejemplo de especificación de zona horaria
https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryViewer&objectId=Subscription/panels/System_Event_Count_By_Event_Action&timezone=TIMEZONENAME
En este caso, "&timezone=" especifica el nombre de la zona horaria que desea utilizar. Sustituya "TIMEZONENAME" por el nombre de la zona horaria deseada, tal como se muestra en la lista devuelta por la llamada getTimeZones.
Nota: La respuesta a una zona horaria no válida varía en función de la llamada en la que se incluye dicha zona:
Es posible predefinir filtros de CA Enterprise Log Manager para informes en formato XML y agregarlos a las URL de getQueryViewer, getReportViewer, getIncidentViewer, o runQuery mediante el término filterXML. Se pueden anidar varios filtros mediante el uso de los términos AND y OR y los paréntesis. Básicamente, se trata de la creación de filtros avanzados de CA Enterprise Log Manager en XML.
Importante: Los términos FilterXml son complejos y la API no lleva a cabo la validación. Los términos de filtros no válidos generan errores de consulta. Por este motivo, le recomendamos que preste especial atención a la hora de crear los términos de filtros.
Los elementos de filtro disponibles, enumerados según el orden en que deben utilizarse, son los siguientes:
Define el número de paréntesis izquierdos. Los valores válidos son 0 o cualquier número superior.
Especifica el término lógico que conecta los filtros; AND u OR. Siempre deberá dejar vacío el valor lógico del primer término de filtro.
Define las columnas de eventos en las que se realiza la consulta. Puede obtener la lista de columnas disponibles mediante el comando getDataModel.
Define un operador del filtro. Los valores válidos, que distinguen entre mayúsculas y minúsculas, son los siguientes:
Define el valor objeto de la búsqueda del filtro.
Define el número de paréntesis derechos. Los valores válidos son 0 o cualquier número superior. El número total de paréntesis derechos coincide siempre con el número de paréntesis izquierdos.
En la visualización de consultas o informes gráficos, es posible ver o ajustar los términos FilterXML establecidos en la sección de filtros avanzados del cuadro de diálogo Filtros locales de la interfaz del visor.
Ejemplo de especificación de FilterXml
En el siguiente ejemplo se muestra una llamada getQueryViewer con una instrucción de filtro. Los términos de filtro se muestran expandidos para una mayor claridad.
https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryViewer&objectId=Subscription/panels/System_Event_Count_By_Event_Action&server=ELMSERVER&filterXml= <Filter logic="" lparens="1" col="source_username" oper="LIKE" val="su" rparens="0"/> <Filter logic="AND" lparens="0" col="event_logname" oper="LIKE" val="CALM" rparens="1"/> </Scope>
"&filterxml=" denota la presencia de una instrucción de filtro.
La instrucción de filtro indica a la consulta que busque en la columna source_username el elemento "su" y en la columna event_logname el elemento "CALM". Dado que ambos términos se unen mediante la instrucción AND (Filter logic="AND"), sólo se devolverán los eventos que incluyan los dos valores en sus columnas respectivas.
Es posible establecer filtros de CA Enterprise Log Manager para las consultas o informes en formato XML cuando se autentica mediante el nombre y la contraseña del certificado. Un filterXML de acceso pasado en una llamada de inicio de sesión se aplica a todas las consultas e informes ejecutados durante esa sesión. Si se pasa un filterXML en la consulta o el informe después de iniciar sesión con un filterXML de acceso, CA Enterprise Log Manager aplica los dos filtros para recuperar los resultados.
Los elementos XML de los filtros de acceso resultan similares a los elementos XML de los filtros.
Ejemplo de especificaciones XML para un filtro de acceso sin la utilización de un filtro XML
En el siguiente ejemplo se muestra una llamada getQueryViewer con una instrucción XML de filtro de acceso. Los términos de filtro se muestran expandidos para una mayor claridad.
https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryViewer&objectId=Subscription/panels/System_Event_Count_by_Event_Source&certname=test&password=test&accessFilterXml=<AccessScope><Filter logic="" lparens="0" col="event_logname"oper="LIKE" val="CALM" rparens="0"/></AccessScope>
"&accessFilterXml=" denota la presencia de una instrucción de filtro de acceso.
Ejemplo de especificaciones para un filtro XML de acceso con un filtro XML
Este ejemplo muestra una llamada objectId con instrucciones XML de filtro y de filtro de acceso.
https://ELMSERVER:5250/spin/calmapi/runQuery.csp?objectId=Subscription/panels/System_Event_Count_by_Event_Source&filterXml=<Scope><Filter logic="" lparens="1" col="event_logname" oper="INSET" val="'CALM','Unix'" rparens="1"/></Scope>&certname=test&password=test&accessFilterXml=<AccessScope><Filter logic="" lparens="1" col="event_logname" oper="LIKE" val="CALM" rparens="1"/></AccessScope>
"&filterXml=" denota la presencia de una instrucción de filtro.
"&accessFilterXml=" denota la presencia de una instrucción de filtro de acceso.
| Copyright © 2011 CA. Todos los derechos reservados. | Enviar correo electrónico a CA Technologies acerca de este tema |