XML Reporting Service (XRS) es un servicio bajo demanda que proporciona datos a través de solicitudes HTTP. Al enviar una solicitud HTTP GET con el formato correcto para xmlreporter.dotcom-monitor.com con parámetros válidos, recibirá un documento XML con los datos solicitados. Puede trabajar con los datos del documento XML como necesite. Las posibilidades incluyen la importación de los datos a otro sistema o tablero.

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

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

  • <error Ha alcanzado 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>

La solicitud XML FEED 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-78789A2394764BA880A4DCAC62AAE90D  &Sitio-57628  &Tipo-Detalle&ubicación-NY, EE. UU. 

UID de cuenta

Para crear una solicitud XML, necesita que su cuenta Unique Identifire (UID) la use como parámetro de solicitud  [unique_account_uid] . Este identificador se puede encontrar cuando se inicia sesión en su cuenta en el menú de navegación en Identificador único de integraciones de cuenta > Integrations > (UID) para el tipo de intergartion de fuente XML.

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 del identificador único de integraciones de cuenta > Integrations > (UID). Utilice el UID del departamento en lugar del UID de la cuenta  [unique_account_uid]  en la solicitud de fuente XML.

Componentes de solicitud disponibles

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 <>

Este es la columna Identificador único global de su cuenta(Integraciones de cuenta > Integrations > del identificador único (UID).

  • Sitio < 1 > &. &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. Puede generar varios sitios en una solicitud. Utilice * para seleccionar todos los sitios.

Ejemplos:

https://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx?pid=78789A2394764BA880A4DCAC62AAE90D&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 <>

Este es la columna Identificador único global de su cuenta(Integraciones de cuenta > Integrations > del identificador único (UID).

  • Sitio < 1 > &. &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.

  • Task1 < > &.. &TaskTM < TaskN > O Task*- Lista de tareas

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) y cada 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”
Para el formato de fecha y horade la UE , utilice guiones “AAAA-MM-DD H:M”

  • 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”
Para el formato de fecha y horade la UE , utilice guiones “AAAA-MM-DD H:M”

Formato de EE. UU.:

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=9D7B3CBCEFAD4B41A188E88E750BB865&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=C8BE4C42486C471ABE06E2DCE5ADB0DF&Site=59106&Type=Detail&from=2012-03-04 15:20&to-2012-03-05 15:20
  • 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=Detail &Ubicación [agent1] [agent2] &Ubicación… &Ubicación [agent5] … 

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

Lista de valores de cadenas de agentes:

América

  • San Francisco
  • IPv6 San Franciso
  • 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=78789A2394764BA880A4DCAC62AAE90D&Site=*&Type=Overall
https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78789A2394764BA880A4DCAC62AAE90D&Task=*&Type=Detail
[/su_highlight]
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 <>

Este es la columna Identificador único global de su cuenta(Integraciones de cuenta > Integrations > del 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.

  • Task1 < > &.. &TaskTM < TaskN > O Task*- Lista de tareas

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=78789A2394764BA880A4DCAC62AAE90D&SiteName=em*&Type=Task
https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?pid=78789A2394764BA880A4DCAC62AAE90D&SiteName=*&TaskName=*&Type=Field
XML Response Fields

Ejemplo:

<Respuesta> 
<ID > 3424533543 < /ID> 
<Nombre > Solicitud de demostración < /Nombre> 
<http://demo.webportal.com/APIv1/json?userid=test;userweight=22 de > URL; ACT-DASW < /URL>
<Monitoring-Date-Time > 3/26/2014 12:38:38 PM < /Monitoring-Date-Time> 
<Duración > 114 < /Duración>
<DnsTime > 0 < /DnsTime>
<SSLTime > 0 < /SSLTime> 
<ConnectionTime > 15 < /ConnectionTime> 
<RequestTime > 0 < /RequestTime> 
<FirstPacketTime > 97 < /FirstPacketTime> 
<DownloadTime > 2 < /DownloadTime> 
<Estado > S < /Estado> 
<Monitoreo-Ubicación > FL, EE.UU. < /Monitoreo-Ubicación> 
</Respuesta>
  • Duración – tiempo total necesario para completar la tarea (Básicamente – suma de 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 tiempos de envío largos resultarán de la carga de 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.