device

device_xml

El comando device_xml devuelve un documento XML que contiene información acerca de un activo. Para acceder al activo, el usuario debe pertenecer al grupo de usuarios asignado al activo.

Sintaxis

http://localhost/knm/extract.xsi?cmd=device_xml&user=Admin&id=2

cmd	device_xml
Usuario	Nombre de usuario de KNM
ID	Número de ID del activo

Datos devueltos

Un documento XML.

Campos XML

DEVICE	Raíz del árbol
NAME	Nombre real
DESC	Descripción del activo
IP_ADDRESS	Dirección IP o nombre de host del activo
MAC_ADDRESS	Dirección MAC del activo (si está disponible)
ACTIVE	YES si el activo está habilitado; NO si está deshabilitado
MAINTENANCE	“Available” si el usuario está programado y en servicio, “n/a” si no está en servicio o programado.
MONITOR	Secundario de ASSET
NAME	Nombre del Monitor
TEST_INTERVAL	Intervalo entre pruebas, en segundos
ALARM_DELAY	Intervalo entre pruebas cuando el monitor está en estado Alarm (Alarma), en segundos
ALARM_GENERATION	La cantidad de pruebas consecutivas que deben fallar antes de que un monitor se considere en estado Alarm (Alarma).
LAST_TEST	Hora de la prueba más reciente
LAST_OK_TEST	Hora de la prueba correcta más reciente
LAST_FAILED_TEST	Hora de la prueba errónea más reciente
TEST_DONE	Cantidad de pruebas realizadas desde el último reinicio
ACTIVE	YES si el monitor está habilitado o NO si está deshabilitado
TYPE	Tipo de monitor
ESTADO	El estado del monitor; puede ser OK (Correcto), FAILED (Erróneo) o ALARM (Alarma).
STATUS_STRING	La cadena de estado más reciente
UPTIME	Tiempo durante el cual el monitor estuvo en estado OK (Correcto) o ALARM (Alarm); cuando está en estado ALARM, la cadena está precedida por un signo “*”.
INM_ALARM_MESSAGE	Secundario de MONITOR, muestra las 5 últimas cadenas de estado
MESSAGE	Texto de estado
TIME	Hora de la entrada
ESTADO	OK (Correcto), FAILED (Erróneo) o ALARM (Alarma)
INM_GRAPH_LINK	Secundario de MONITOR, contiene información acerca de los gráficos en tiempo real que se muestran en la página de información del monitor
LINK	Un vínculo de extracción de datos al gráfico
DESC	Descripción del gráfico
UNIT	Unidad del eje Y del gráfico
PERIOD	Período del gráfico
STATUS_EX	Estado extendido de monitores de SNMP, Script de SSH2, ODBC y WinPerf
ESTADO	El estado del monitor puede ser OK (Correcto), FAILED (Erróneo) o ALARM (Alarma).
UNIT	Unidad definida por el usuario
COMPARE_VALUE	Valor definido por el usuario con el que se compara el valor obtenido en la prueba, para evaluar el resultado de la prueba.
COMPARE_OPERATION	Operación para comparar el valor de devolución de la prueba y el valor de comparación definido por el usuario. Puede ser: EQUAL NOT EQUAL GREATER LESS EQUAL OR GREATER EQUAL OR LESS
LAST_VALUE	Último valor obtenido en la prueba.

Ejemplo

<DEVICE>

	<NAME>DOMAINSERVER</NAME>

	<DESC></DESC>

	<IP_ADDRESS>192.168.1.1</IP_ADDRESS>

	<MAC_ADDRESS>00-00-5A-A8-07-D8</MAC_ADDRESS>

	<ACTIVE>YES</ACTIVE>

	<MAINTENANCE>NO</MAINTENANCE>

	<MONITOR>

		<NAME>Bandwidth test</NAME>

		<TEST_INTERVAL>10</TEST_INTERVAL>

		<ALARM_DELAY>600</ALARM_DELAY>

		<ALARM_GENERATION>5</ALARM_GENERATION>

		<LAST_TEST>2004-06-10 13:38:55</LAST_TEST>

		<LAST_OK_TEST>2004-06-10 13:38:40</LAST_OK_TEST>

		<TEST_DONE>0</TEST_DONE>

		<ACTIVE>NO</ACTIVE>

		<TYPE>Bandwidth test</TYPE>

		<STATUS>OK</STATUS>

		<STATUS_STRING></STATUS_STRING>

		<UPTIME>23t 4m 45s</UPTIME>

	</MONITOR>

</DEVICE>