Dotcom-Monitor le permite enviar datos con estadísticas de supervisión en tiempo real o información personalizada a software de terceros, aplicaciones web o paneles en tiempo real. Estos datos de informe en tiempo real pueden incluir información como:

  • Estadísticas sobre la utilización de la cuenta dotcom-monitor (recursos usados y disponibles por solución).
  • Un estado y estado de uno o un conjunto de dispositivos de supervisión.
  • Detalles de respuesta recibidos para uno o un conjunto especificado de dispositivos. La solicitud de la información de respuesta se puede personalizar altamente a un nivel necesario de detalles utilizando una serie de parámetros de solicitud.
  • Supervisión de los datos de configuración de dispositivos y tareas.

Para publicar informes en tiempo real sobre demanda, Dotcom-Monitor usa el marco de marco de XML Reporting Service. XML Reporting Service (XRS) es un servicio bajo demanda que proporciona datos a través de solicitudes HTTP. Mediante el envío de una solicitud GET HTTP(S) con formato adecuado para
xmlreporter.dotcom-monitor.com
con parámetros válidos, recibirá un documento XML con los datos solicitados (consulte las especificaciones sobre los parámetros de solicitud en la sección correspondiente del artículo). Puede trabajar con los datos del documento XML según lo necesite. Las posibilidades incluyen importar los datos a otro sistema, base de datos SQL, panel o publicarlos en Microsoft Excel.

En comparación con los paneles de sharebale de Dotcom-Monitor y otros tipos de informes integrados, con la fuente XML solo puede extraer los parámetros con los que desea trabajar o ver en el panel en otros tipos de aplicaciones de terceros que admiten orígenes de datos XML. Por ejemplo, puede crear una visualización del rendimiento web de determinados dispositivos desde su cuenta dotcom-monitor con el nivel máximo disponible de detalles. El marco XRS flexible le permite extraer solo métricas que son más importantes para el proyecto. Un gran número de parámetros de solicitud de fuente XML están disponibles para personalizar su solicitud – puede elegir si desea recibir un breve resumen en los dispositivos de supervisión de su cuenta o desea tener datos generales en cada dispositivo de supervisión. Echemos un vistazo más de cerca a lo detallados que pueden ser sus datos. Puede configurar su solicitud para que reciba:

  • Datos de resumen, como tiempo de actividad/tiempo de inactividad, número de éxitos y número de errores, datos de rendimiento y desviación estándar.
  • Informe detallado con datos sin procesar para un período solicitado (hasta los últimos 6 meses).
  • Datos de respuesta agregados en períodos de una hora de duración.
  • Datos de respuesta agregados en períodos de 24 horas de duración durante un período especificado.
  • Resumen por semana para el período especificado.
  • Datos estadísticos calculados durante un período de 3 meses.
  • Resumen por mes para un período especificado.
  • Resumen por año para un período especificado.

Además, con los parámetros de solicitud puede especificar la fecha y hora de inicio y finalización para los informes. Para ejecutar un análisis de la carga horaria y diaria (tiempo medio de respuesta, STDDev de tiempo de respuesta, porcentaje de tiempo de inactividad, etc.), puede extraer un informe con promedios calculados durante un período especificado (por ejemplo, un período de una semana).

Si alguna vez ha realizado informes en línea para su dispositivo de monitoreo en Dotcom-Monitor, es probable que le resulte conveniente usar su gráfico de tiempo de actividad/tiempo de inactividad. Con el marco XRS también puede recibir un informe XML con estadísticas de dispositivos desglosadas por períodos de tiempo de actividad y tiempo de inactividad.

También puede aplicar filtros Dotcom-Monitor (Configurar > filtros) a los datos de los informes. Con las programaciones (Configurar > programaciones) creadas en la cuenta de Dotcom-Monitor, solo puede publicar los resultados que se recibieron durante un período especificado en un programador determinado.

Además, solo puede extraer respuestas de error correctas o solo en su elección, filtrar las estadísticas del informe supervisando las ubicaciones del informe de la fuente XML, etc. Consulte las descripciones de todos los parámetros disponibles en la sección correspondiente de este artículo.

Configuración de solicitudes HTTP a la fuente XML

La solicitud de fuente XML es una dirección URL con una serie de parámetros GET, separados por un símbolo “&”.

Una solicitud XML consta de los siguientes elementos:
 [base_url_address]  +  [unique_account_uid]  +  [Site_id]  +  [parameter1]&[parameter2]… 

Solicitudes de ejemplo:
 https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid-4229AF4F0FB545AEA75EAF2013E51BB7  &Sitio-12345  &Tipo-General   https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid=78799A2394884BA880A4DCAC62AAE90D  &Site=57628  &Type=Detail&location=NY, USA 

UID de cuenta

Para crear una solicitud XML, necesita que el identificador único (UID) de su cuenta se utilice como parámetro de solicitud  [unique_account_uid] . Este IDENTIFICADOR se puede encontrar al iniciar sesión en su cuenta en el menú de navegación en Configurar identificador único de > integraciones > (UID) para el tipo de integración de fuente XML.

Limitaciones en el número de solicitudes de fuente XML

El número máximo de solicitudes al servicio de informes XML es de 1 cada 10 segundos.

Si envía más de una solicitud en un plazo de 10 segundos, XRS devuelve un documento XML con el siguiente tiempo de solicitud permitido de la siguiente manera:

  • <errornzado >el límite máximo de solicitudes permitidas por IP[192 .168.107.97]< /error>
  • <nextAllowedTime> Martes, 18 de febrero de 2014 7:50:26 PM< /nextAllowedTime>
  • <nextAllowedTimeGMT >Martes, 18 de febrero de 2014 4:50:26 PM< /nextAllowedTimeGMT>

Componentes de solicitud disponibles

Account.aspx - devuelve la utilización del paquete de cuenta
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/Account.aspx

Esto devolverá el historial de utilización de la cuenta seleccionada con un desglose en las soluciones. El informe incluye información sobre la capacidad del paquete y los recursos usados por paquete. Para las cuentas raíz, se incluirá la utilización de paquetes de departamento.

Parámetro:

  • <UID de cuenta pidid>

Esta es la cuenta Identificador único global(Configurar > integraciones > la columna Identificador único (UID).

Ejemplos:

https://xmlreporter.dotcom-monitor.com/reporting/xml/Account.aspx?PID=78799A2394884BA880A4DCAC62AAE90D

status.aspx - returns devices state and status information
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx

Esto simplemente devolverá el estado de: Arriba/Abajo/Pospuesto y el estado de Active/Postponed/NoTasks para los dispositivos solicitados.

Parámetros:

  • <UID de cuenta pidid>

Esta es la cuenta Identificador único global(Configurar > integraciones > la columna Identificador único (UID).

  • Site=<Site1>&..&Site=<SiteN> OR Site=* – Sites list

Esta es una lista de los iDE del sitio. También llamado “Dispositivos” en Dotcom-Monitor. Los ID de dispositivo individuales se pueden encontrar cuando inicia sesión en su cuenta en la pantalla Administrador de dispositivos haciendo clic en Editar en el menú de acciones situado junto al dispositivo seleccionado. Cuando se cargue la siguiente pantalla, el ID de dispositivo estará en la URL como tal:

https://user.dotcom-monitor.com/Site-Edit.aspx?

id-123456

También puede obtener el identificador de sitio mediante la interfaz XML. Consulte el uso de config.aspx. Puede generar varios sitios en una solicitud. Utilice * para seleccionar todos los sitios.

Ejemplos:

https://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Site=*

responses.aspx - returns responses information
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx

Esta dirección URL base se utiliza para pasar una serie de parámetros en la solicitud, como se detalla a continuación en la lista de parámetros.

Asegúrese de quitar los espacios entre los parámetros o la fuente XML omitirá esos parámetros.

Parámetros:

  • <UID de cuenta pidid>

Esta es la cuenta Identificador único global(Configurar > integraciones > la columna Identificador único (UID).

  • Site=<Site1>&..&Site=<SiteN> OR Site=* – Sites list

Esta es una lista de los iDE del sitio. También llamado “Dispositivos” en Dotcom-Monitor. Los ID de dispositivo individuales se pueden encontrar cuando inicia sesión en su cuenta en la pantalla Administrador de dispositivos haciendo clic en Editar en el menú de acciones situado junto al dispositivo seleccionado. Cuando se cargue la siguiente pantalla, el ID de dispositivo estará en la URL como tal:

https://user.dotcom-monitor.com/Site-Edit.aspx?

id-123456

También puede obtener el identificador de sitio mediante la interfaz XML. Consulte el uso de config.aspx anterior. Puede generar varios sitios en una solicitud. Utilice * para seleccionar todos los sitios.

  • Task=<Task1>&..&Task=<TaskN> OR Task=* – Tasks list

Este es un identificador de tareas, similar en estructura a Site.

Los ID de tarea individuales se pueden encontrar cuando inicia sesión en su cuenta en la pantalla Administrador de dispositivos haciendo clic en Editar en el menú de acciones situado junto a la tarea seleccionada. cuando se cargue la siguiente pantalla, el ID de dispositivo estará en la URL como tal:

https://user.dotcom-monitor.com/task-edit.aspx?

id-123456

También puede obtener el identificador de tarea mediante la interfaz XML. Consulte el uso de config.aspx anterior. Puede generar varias tareas en una solicitud. Utilice * para seleccionar todas las tareas.

Hay varios parámetros opcionales que se pueden anexar a la dirección URL mediante &, especialmente al sondear las respuestas con la dirección URL base de http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx:

  • Tipo-General

Esto proporcionará datos de resumen, como tiempo de actividad/tiempo de inactividad, número de éxitos y número de errores, datos de rendimiento y desviación estándar.

  • Tipo-Hora

Este parámetro agregará respuestas en períodos de una hora y mostrará información estadística para cada hora.

  • Tipo-Día

Incluya el resumen por días durante un período especificado.

  • Tipo-Semana

Incluya el resumen por semana para el período especificado.

  • Tipo-Cuarto

Este parámetro divide un período en un período de 3 meses (cuarto) ycada uno ” </Resumen> …<El elemento /Summary> “ representa datos estadísticos calculados a lo largo de un período de 3 meses.

  • Tipo-Mes

Resumen del mes por mes durante un período especificado.

  • Tipo-Año

Año-resumen por año durante un período especificado.

  • Tipo-Detalle

Proporciona datos sin procesar para un período solicitado. Los datos sin procesar solo están disponibles durante los últimos 6 meses.

  • Lunes de< inicio de semana>

Permite al usuario cambiar el día de inicio de una semana laboral. Por ejemplo, puede establecer el día para comenzar a un domingo, como en los EE. UU. (Inicio de semana-domingo) o el lunes como en la UE (Inicio de semana-lunes)

  • Desde< DateAndTime>

Esto especifica la fecha y hora de inicio para los informes.

Para el formato de fecha y hora de EE. UU., utilice barras diagonales “MM/DD/AAAA H:M:S AM(PM)
Para el formato de fecha y hora de la UE,utilice guiones “AAAA-MM-DD H:M:S”

  • <A la fecha y el tiempo>

Esto especifica una fecha y hora de finalización para los informes.
Para el formato de fecha y hora de EE. UU., utilice barras diagonales “MM/DD/AAAA H:M:S AM(PM)”
Para el formato de fecha y hora de la UE,utilice guiones “AAAA-MM-DD H:M:S”

Formato de EE. UU.:

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Site=70795&Type=overall&from=09/13/2012&to=09/13/2012

Formato de la UE:

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Site=59106&Type=Detail&from=2012-03-04 15:20:30&to=2012-03-05 15:20:30
  • Tipo: Hora del día

Este parámetro proporciona respuestas que contienen 24 piezas numeradas, donde cada ” </Summary> … /<Summary> “ coincide con una hora exacta en un día. Los valores estadísticos (como el tiempo medio de respuesta, el tiempo de respuesta STDDev, el porcentaje de tiempo de inactividad, etc.) reflejan los promedios calculados durante un período especificado (por ejemplo, un período de la semana). Este parámetro es conveniente para el análisis de la carga por hora.

Este tipo solo funciona para períodos de notificación más largos o iguales a 1 día.

  • Tipo: StatusChange

La información estadística se calcula para cada bloque, que corresponde a la longitud de tiempo después de cualquier cambio de estado. Este parámetro hará “< /Summary> … </Summary> “ elementos muestran los períodos de la misma manera que en la sección “Períodos de tiempo de actividad/tiempo de inactividad” de cualquier informe en línea.

  • Tipo: DayOfWeek

Este parámetro proporciona una respuesta que contiene siete (7) piezas numeradas, donde cada “< /Summary> … </Summary> “ coincide con un día exacto a la semana. Los valores estadísticos (como el tiempo medio de respuesta, el tiempo de respuesta STDDev, el porcentaje de tiempo de inactividad, etc.) reflejan los promedios calculados durante un período especificado (por ejemplo, un período de la semana) durante un día. Este parámetro es conveniente para el análisis de la carga diaria.

  • Filter= <FilterID>

Esto proporciona la capacidad de filtrar los datos de acuerdo con las reglas del filtro.

Los ID de filtro individuales se pueden encontrar cuando inicia sesión en su cuenta en la pantalla Administrador de dispositivos en el menú de navegación en Configurar, Filtros. Al hacer clic en un filtro verá el ID en la URL de la página de edición:

https://user.dotcom-monitor.com/Filter-Edit.aspx?

id-123456

  • <SchedulerID Scheduler>

Esto proporciona la capacidad de excluir datos durante un período de tiempo específico.

Los ID de programación individuales se pueden encontrar cuando se inicia sesión en su cuenta en la pantalla Administrador de dispositivos en el menú de navegación en Configurar, Programaciones. al hacer clic en un filtro verá el ID en la URL de la página de edición:

https://user.dotcom-monitor.com/Scheduler-Edit.aspx?

id-123456

  • Estado S

Ver solo las respuestas correctas.

  • Estado F

Ver solo las respuestas de error.

  • Ubicación [agent1]&… &Ubicación?[agent2]

Filtre las respuestas mediante la supervisión de las ubicaciones del agente.

Si desea que la fuente XML muestre los resultados solo de determinados agentes de supervisión, agregue el parámetro de cadena “&Location” a la dirección URL de la solicitud de la siguiente manera:

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=XXXXXXXXXXX&Site=XXXXX &Type=[agent1]Detail&Ubicación &Ubicación& amp[agent2];Ubicación… &Ubicación [agent5]… 

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=XXXXXXXXXXX&Site=XXXXX&Type=Detail  &Location=[agent1]&Location=[agent2]...&Location=[agent5]...

Lista de valores de cadenas de agentes:

América

  • San Francisco
  • IPv6 San Francisco
  • Seattle
  • Dallas
  • Denver
  • Minneapolis
  • Miami
  • Montreal
  • Washington DC
  • Nueva York
  • AWS US-East
  • Buenos Aires
Europa

  • Londres
  • París
  • Amsterdam
  • Copenhague
  • Francfort
  • Varsovia
  • Tel-Aviv
Asia, Australia, Africa

  • Mumbai
  • Hong Kong
  • Beijing
  • Shanghai
  • Tokio
  • Sydney
  • Brisbane
  • Johannesburgo
  • Opciones-Comentarios

Incluya comentarios personalizados asociados a un dispositivo.

  • Opciones/SolicitudDetalles

Para incluir detalles de nivel de elemento (como se incluye en un gráfico de cascada), puede establecer la marca Opciones en RequestDetails.

Incluya “Detalles XML extendidos”.

  • Opciones-AllDownPercentages

Incluya todos los porcentajes del resumen.

  • Opciones-AllTimes

Incluya todos los momentos de resumen, incluidos el tiempo de actividad, el tiempo de inactividad, el tiempo de indefinido, el tiempo de actividad ponderado y el tiempo de inactividad ponderado.

  • Opciones-LatestResponses

Incluya la respuesta más reciente de cada ubicación de supervisión asignada a los dispositivos seleccionados.

  • <Número de cantidad>

Incluya solo <el número> establecido de las últimas respuestas para los dispositivos seleccionados.

  • Detalles-Contenido

Incluir contenido de detalle de hit.

  • Detalles-HtmlBody

Incluir Hitdetail HtmlBody

  • Detalles-CommonDescription

Incluir Hitdetail CommonDescription

  • Detalles-BrowserAction

Incluye tiempos de navegación como Inicio / Fin de navegación, Redirección, Fetch, Búsqueda de dominio, Inicio de solicitud, Descargar evento, Render Start

Ejemplos:

https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Site=*&Type=Overall
https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Task=*&Type=Detail

[/]
config.aspx - returns sites and tasks configuration information

Esta dirección URL base se utiliza para pasar una serie de parámetros en la solicitud, como se detalla a continuación en la lista de parámetros.

  • https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx

Esta dirección URL le permite recuperar los ides de sitio y los ideos de tarea.

Parámetros:

  • <UID de cuenta pidid>

Esta es la cuenta Identificador único global(Configurar > integraciones > la columna Identificador único (UID).

  • NombreSitio <Sitio1> &.. &Sitio<- Sitio O Sitio* >- Lista de sitios

Esta es una lista de los iDE del sitio. También llamado “Dispositivos” en Dotcom-Monitor. Los ID de dispositivo individuales se pueden encontrar cuando inicia sesión en su cuenta en la pantalla Administrador de dispositivos haciendo clic en Editar en el menú de acciones situado junto al dispositivo seleccionado. cuando se cargue la siguiente pantalla, el ID de dispositivo estará en la URL como tal:

https://user.dotcom-monitor.com/Site-Edit.aspx?

id-123456

También puede obtener el identificador de sitio mediante la interfaz XML. Consulte el uso de config.aspx anterior. Puede generar varios sitios en una solicitud. Utilice * para seleccionar todos los sitios.

  • Task=<Task1>&..&Task=<TaskN> OR Task=* – Tasks list

Este es un identificador de tareas, similar en estructura a Site.

Los ID de tarea individuales se pueden encontrar cuando inicia sesión en su cuenta en la pantalla Administrador de dispositivos haciendo clic en Editar en el menú de acciones situado junto a la tarea seleccionada. cuando se cargue la siguiente pantalla, el ID de dispositivo estará en la URL como tal:

https://user.dotcom-monitor.com/task-edit.aspx?

id-123456

También puede obtener el identificador de tarea mediante la interfaz XML. Consulte el uso de config.aspx anterior. Puede generar varias tareas en una solicitud. Utilice * para seleccionar todas las tareas.

También puede usar una máscara para el parámetro “SiteName” para filtrar los resultados de la solicitud por algún patrón de inicio: NombreSitio-em*

  • Tipo-Tarea

Incluye información básica de la tarea.

  • Tipo de campo

Incluye información detallada de la tarea.

Ejemplos:

https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&SiteName=em*&Type=Task
https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&SiteName=*&Type=Task&Type=Field

XML Response Fields

En esta sección, puede encontrar descripciones en algunos campos de la fuente XML Dotcom-Monitor:

<Response> 
<ID>3424533543</ID> 
<Name>Demo request</Name> 
<URL>http://demo.webportal.com/APIv1/json?userid=test;userweight=22;ACT=DASW</URL>
<Monitoring-Date-Time>3/26/2014 12:38:38 PM</Monitoring-Date-Time> 
<Duration>114</Duration>
<DnsTime>0</DnsTime>
<SSLTime>0</SSLTime> 
<ConnectionTime>15</ConnectionTime> 
<RequestTime>0</RequestTime> 
<FirstPacketTime>97</FirstPacketTime> 
<DownloadTime>2</DownloadTime> 
<Status>S</Status> 
<Monitoring-Location>FL, USA</Monitoring-Location> 
</Response>
  • Duración – tiempo total que se ha tardado en completar la tarea (básicamente – la suma de las veces a continuación)
  • DNSTime : es el tiempo necesario para resolver un nombre de host (por ejemplo, www.google.com) en una dirección IP numérica (por ejemplo, 216.239.59.99).
  • SSLTime – es el tiempo necesario para completar el proceso de enlace SSL.
  • ConnectionTime: es el tiempo necesario para crear una conexión TCP al servidor web (o proxy). Las conexiones Keep-Alive se utilizan a menudo para evitar la sobrecarga de conectarse repetidamente al servidor web.
  • RequestTime: es el tiempo necesario para enviar el mensaje de solicitud HTTP al servidor y dependerá de la cantidad de datos que se envían al servidor. Por ejemplo, los largos tiempos de envío serán el resultado de cargar archivos mediante un HTTP POST.
  • FirstPacketTime – (Tiempo hasta el primer byte) tiempo transcurrido para empezar a recibir datos desde el servidor web remoto. En otras palabras, el tiempo entre la solicitud y la respuesta primer byte recibido.
  • DownloadTime: es el tiempo que se tarda en leer el mensaje de respuesta del servidor. Este valor dependerá del tamaño del contenido devuelto, del ancho de banda de red y de si se utilizó la compresión HTTP. En otras palabras, el tiempo entre la respuesta primero y el último bytes.

 

Departamento UID

Si tiene Departamentos configurados en su cuenta, puede configurar la fuente XML para proporcionar datos solo en un departamento determinado. Se asignan UID individuales para cada Departamento. Para acceder a un UID de departamento, cambie su cuenta de Dotcom-Monitor al usuario del Departamento y copie el UID desde Configurar identificador único de > integraciones > (UID). Use el UID del Departamento en lugar del UID de la cuenta en su solicitud de fuente XML.