Dotcom-Monitor vous permet d’envoyer des données avec des statistiques de surveillance en temps réel ou des informations personnalisées à des logiciels tiers, des applications Web ou des tableaux de bord en temps réel. Ces données de rapport en temps réel peuvent inclure des informations telles que :

  • Statistiques sur l’utilisation de votre compte Dotcom-Monitor (ressources utilisées et disponibles par solution).
  • Un état et l’état d’un ou d’un ensemble de dispositifs de surveillance.
  • Détails de réponse reçus pour un ou un ensemble spécifié d’appareils. La demande d’informations de réponse peut être hautement personnalisée à un niveau de détails nécessaire en utilisant un certain nombre de paramètres de demande.
  • Surveillance des périphériques et des données de configuration des tâches.

Pour publier des rapports en temps réel sur demande, Dotcom-Monitor utilise le framework XML Reporting Service.

Le XML Reporting Service (XRS) est un service gratuit à la demande qui fournit des données via les demandes HTTP. Le flux XML fournit des informations sur les périphériques surveillés pour les applications Web et les sites Web dans un format personnalisé. Les exemples de cas d’utilisation incluent : un FAI fournissant des disponibilités indépendantes, des performances et l’état à jour de leurs services à leurs clients via un site Web; ou un centre de données intégrant des données de surveillance à leurs applications internes.

En envoyant une demande HTTP(S) GET correctement formatée
à xmlreporter.dotcom-monitor.com
avec des paramètres valides, vous recevrez un document XML avec les données demandées (voir les spécifications sur les paramètres de demande dans la section correspondante de l’article). Vous pouvez travailler avec les données du document XML au besoin. Les possibilités incluent l’importation des données dans un autre système, base de données SQL, tableau de bord, ou de les publier dans Microsoft Excel.

Contrairement aux tableaux de bord partageables Dotcom-Monitor et à d’autres types de rapports intégrés, en utilisant le flux XML, vous ne pouvez tirer que les paramètres avec qui vous souhaitez travailler ou voir sur votre tableau de bord dans d’autres types d’applications tierces qui soutiennent les sources de données XML. Par exemple, vous pouvez créer une visualisation des performances Web de certains appareils à partir de votre compte Dotcom-Monitor avec le niveau maximum de détails disponibles. Le cadre XRS flexible vous permet de ne tirer que les mesures les plus importantes pour votre projet. Un grand nombre de paramètres de demande de flux XML sont disponibles pour personnaliser votre demande – vous pouvez choisir si vous souhaitez recevoir un bref résumé sur les dispositifs de surveillance de votre compte ou si vous souhaitez avoir des données globales sur chaque appareil de surveillance. Examinons de plus près la façon dont vos données peuvent être détaillées. Vous pouvez configurer votre demande de recevoir :

  • Données sommaires, telles que les temps de disponibilité/temps d’arrêt, le nombre de succès et le nombre d’échecs, les données sur les performances et l’écart type.
  • Rapport détaillé avec données brutes pour une période demandée (jusqu’aux 6 derniers mois).
  • Données de réponse agrégées en périodes d’une heure.
  • Données de réponse agrégées en périodes de 24h de long pour une période déterminée.
  • Résumé par semaine pour la période spécifiée.
  • Données statistiques calculées sur une période de 3 mois.
  • Résumé par mois pour une période déterminée.
  • Résumé par année pour une période déterminée.

En outre, en utilisant les paramètres de demande, vous pouvez spécifier la date de début et de fin et l’heure de déclaration. Pour effectuer une analyse de la charge horaire et quotidienne (temps de réponse moyen, temps de réponse STDDev, pourcentage de temps d’arrêt, etc.), vous pouvez tirer un rapport avec des moyennes calculées sur une période déterminée (par exemple, une période d’une semaine).

Si vous avez déjà tiré des rapports en ligne pour votre appareil de surveillance dans Dotcom-Monitor, vous trouverez peut-être pratique d’utiliser son tableau disponibilité/temps d’arrêt. En utilisant le cadre XRS, vous pouvez également recevoir un rapport XML avec des statistiques d’appareil ventilées par temps de disponibilité et périodes d’arrêt.

Vous pouvez également appliquer des filtres Dotcom-Monitor > (Filtres configurer) aux données de vos rapports. À l’aide des plannings (Configure > Schedules) créés dans votre compte Dotcom-Monitor, vous ne pouvez publier que les résultats reçus au cours d’une période spécifiée dans un calendrier particulier.

En outre, vous ne pouvez tirer que des réponses réussies ou seulement d’échec sur votre choix, filtrer les statistiques du rapport en surveillant les emplacements dans votre rapport d’alimentation XML, etc. Voir les descriptions de tous les paramètres disponibles dans la section correspondante de cet article.

Configurer les demandes HTTP au flux XML

La demande de flux XML est une URL avec un certain nombre de paramètres GET, séparés par un symbole «».

Une demande XML se compose des éléments suivants :
 [base_url_address]  +  [unique_account_uid]  +  [Site_id]  +   [parameter1] [parameter2] … 

Exemples de demandes :
 https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid=4229AF4F0FB545AEA75EAF2013E51BB7  Site=12345  Type=Overall   https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid=78799A2394884BA880A4DCAC62AAE90D  Site=57628  Type=Detaillocation=NY, Etats-Unis 

Compte UID

Pour créer une demande XML, vous avez besoin de votre identifiant unique de compte (UID) pour l’utiliser comme paramètre de demande  [unique_account_uid] . Cet ID peut être trouvé lorsqu’il est connecté à votre compte dans le menu de navigation sous Configure > Integrations > Unique Identifier (UID) pour le type d’intégration de flux XML.

Limitations du nombre de demandes d’alimentation XML

Le nombre maximum de demandes au service de rapport XML est de 1 toutes les 10 secondes.

Si vous soumettez plus d’une demande dans un délai de 10 secondes, XRS retourne un document XML avec le temps de demande suivant autorisé comme suit :

  • <erreur > Vous avez atteint la limite maximale de demandes autorisées par [192 .168.107.97] < IP/erreur>
  • <nextAllowedTime > Tuesday, February 18, 2014 7:50:26 PM < /nextAllowedTime>
  • <nextAllowedTimeGMT > Mardi, Février 18, 2014 4:50:26 PM < /nextAllowedTimeGMT>

Composants de demande disponibles

Compte.aspx - retourne l'utilisation du paquet de compte
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/Account.aspx

Cela permettra de renvoyer l’historique d’utilisation pour le compte sélectionné avec une ventilation sur les solutions. Le rapport contient des informations sur la capacité de l’emballage et les ressources utilisées par paquet. Pour les comptes racine, l’utilisation des paquets du Ministère sera incluse.

paramètre:

  • PID= < Compte UID>

Il s’agit de votre compte Global Unique Identifier(Configure > Integrations > the Unique Identifier (UID) colonne).

Exemples:

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

état.aspx - renvoie les informations sur l'état et l'état des appareils
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx

Cela permettra simplement de retourner l’état de: Haut / Bas / Reporté et le statut d’Active / Postponed / NoTasks pour les appareils demandés.

Paramètres:

  • PID= < Compte UID>

Il s’agit de votre compte Global Unique Identifier(Configure > Integrations > the Unique Identifier (UID) colonne).

  • Site= < Site1 > .. Site= < SiteN > OR Site=* – Liste des sites

Il s’agit d’une liste d’iD site. Aussi appelé «Dispositifs» dans Dotcom-Monitor. Les iD individuels de l’appareil peuvent être trouvés lorsqu’ils sont connectés à votre compte sur l’écran du gestionnaire d’appareil en cliquant sur modifier le menu d’action à côté de l’appareil sélectionné. Lorsque l’écran suivant se charge, l’iD de l’appareil sera dans l’URL en tant que telle :

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

id=123456

Vous pouvez également obtenir l’iD du site à l’aide de l’interface XML. S’il vous plaît voir l’utilisation de config.aspx. Vous pouvez créer plusieurs sites en une seule demande. Utiliser * pour sélectionner tous les sites.

Exemples:

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

réponses.aspx - renvoie l'information sur les réponses
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx

Cette URL de base est utilisée pour passer un certain nombre de paramètres dans la demande, comme décrit ci-dessous dans la liste des paramètres.

Assurez-vous de supprimer tous les espaces entre les paramètres ou le flux XML ignorera ces paramètres.

Paramètres:

  • PID= < Compte UID>

Il s’agit de votre compte Global Unique Identifier(Configure > Integrations > the Unique Identifier (UID) colonne).

  • Site= < Site1 > .. Site= < SiteN > OR Site=* – Liste des sites

Il s’agit d’une liste d’iD site. Aussi appelé «Dispositifs» dans Dotcom-Monitor. Les iD individuels de l’appareil peuvent être trouvés lorsqu’ils sont connectés à votre compte sur l’écran du gestionnaire d’appareil en cliquant sur modifier le menu d’action à côté de l’appareil sélectionné. Lorsque l’écran suivant se charge, l’iD de l’appareil sera dans l’URL en tant que telle :

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

id=123456

Vous pouvez également obtenir l’iD du site à l’aide de l’interface XML. S’il vous plaît voir l’utilisation de config.aspx-dessus. Vous pouvez créer plusieurs sites en une seule demande. Utiliser * pour sélectionner tous les sites.

  • Tâche = < Tâche1 > .. Task= < TaskN > OR Task=* – Liste des tâches

Il s’agit d’un ID de tâches, similaire dans la structure du site.

Les ID de tâches individuels peuvent être trouvés lorsqu’ils sont connectés à votre compte sur l’écran du gestionnaire d’appareil en cliquant sur modifier le menu d’action à côté de la tâche sélectionnée. lorsque l’écran suivant se charge, l’iD de l’appareil sera dans l’URL en tant que telle :

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

id=123456

Vous pouvez également obtenir l’ID de tâche à l’aide de l’interface XML. S’il vous plaît voir l’utilisation de config.aspx-dessus. Vous pouvez effectuer plusieurs tâches en une seule demande. Utiliser * pour sélectionner toutes les tâches.

Il existe plusieurs paramètres optionnels qui peuvent être annexés à l’URL à l’aide de la , en particulier lorsque vous votez pour les réponses avec l’URL de base de http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx:

  • Type=Dans l’ensemble

Cela fournira des données sommaires, telles que les temps de disponibilité/temps d’arrêt, le nombre de succès et le nombre d’échecs, les données sur le rendement et l’écart type.

  • Type=Heure

Ce paramètre regroupera les réponses en périodes d’une heure et affichera des informations statistiques pour chaque heure.

  • Type=Jour

Inclure le résumé par jours pour une période déterminée.

  • Type=Semaine

Inclure le résumé par semaine pour la période spécifiée.

  • Type=Quartier

Ce paramètre décompose une période en une période de 3 mois (trimestre) et chaque ” < / Résumé > … < L’élément > /Résumé ” représente les données statistiques calculées sur une période de 3 mois.

  • Type=Mois

Mois= résumé par mois pour une période déterminée.

  • Type=Année

Année=résumé par année pour une période déterminée.

  • Type=Détail

Il fournit des données brutes pour une période demandée. Les données brutes ne sont disponibles que pour les 6 derniers mois.

  • Startofweek= < Lundi>

Permet à l’utilisateur de déplacer le jour de début d’une semaine d’affaires. Par exemple, vous pouvez définir le jour pour commencer à un dimanche, comme aux États-Unis (Startofweek=Sunday), ou le lundi comme dans l’UE (Startofweek=Lundi)

  • À partir de = < DateAndTime>

Cela précise la date de début et l’heure de la déclaration.

Pour le format date et heure des États-Unis, utilisez des barres obliques « MM/DD/YYYY H:M:S AM (PM)
Pour le format date et heure de l’UE,utilisez des tirets «YYYY-MM-DD H:M:S»

  • À = < DateAndTime>

Cela précise une date et une heure de fin pour la déclaration.
Pour le format date et heure des États-Unis, utilisez des barres obliques « MM/DD/YYYY H:M:S AM (PM)»
Pour le format date et heure de l’UE,utilisez des tirets «YYYY-MM-DD H:M:S»

Format américain:

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

Format de l’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
  • Type = Hourofday

Ce paramètre donne des réponses contenant 24 pièces numérotées, où chaque ” / Résumé < > … < /Summary > “ élément correspond à une heure exacte dans une journée. Les valeurs statistiques (comme le temps de réponse moyen, le temps de réponse STDDev, le pourcentage de temps d’arrêt, etc.) reflètent les moyennes calculées sur une période déterminée (par exemple, une période d’une semaine). Ce paramètre est pratique pour l’analyse de la charge horaire.

Ce type ne fonctionne que pour les périodes de déclaration plus longues ou égales à 1 jour.

  • Type = StatusChange

Les informations statistiques sont calculées pour chaque bloc, ce qui correspond à la durée après tout changement de statut. Ce paramètre fera ” < /Summary > … < /Résumé > ” les éléments affichent les périodes de la même manière que dans la section «Périodes de disponibilité/temps d’arrêt» de tout rapport en ligne.

  • Type = DayOfWeek

Ce paramètre fournit une réponse contenant sept (7) pièces numérotées, où chaque ” < / Résumé > … < /Résumé > “ élément correspond à un jour exact dans une semaine. Les valeurs statistiques (comme le temps de réponse moyen, le temps de réponse STDDev, le pourcentage de temps d’arrêt, etc.) reflètent les moyennes calculées sur une période déterminée (par exemple, une période de semaine) pour une journée. Ce paramètre est pratique pour l’analyse de la charge quotidienne.

  • Filtre= < FilterID>

Cela permet de filtrer vos données en conformité avec les règles du filtre.

Les iD de filtre individuels peuvent être trouvés lorsqu’ils sont connectés à votre compte sur l’écran du gestionnaire d’périphérique dans le menu de navigation sous Configure, Filtres. Lorsque vous cliquez sur un filtre, vous verrez l’ID dans l’URL de la page de modification :

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

id=123456

  • Scheduler= < SchedulerID>

Cela permet d’exclure les données pendant une période de temps spécifique.

Les cartes d’enregistrement individuelles peuvent être trouvées lorsqu’elles sont connectées à votre compte sur l’écran du gestionnaire d’périphériques dans le menu de navigation sous Configure, Annexes. lorsque vous cliquez sur un filtre, vous verrez l’ID dans l’URL de la page de modification :

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

id=123456

  • Statut=S

Afficher uniquement les réponses réussies.

  • Statut=F

Afficher uniquement les réponses d’échec.

  • Lieu= [agent1] … Emplacement=[agent2]

Filtrez les réponses en surveillant les emplacements des agents.

Si vous souhaitez que le flux XML affiche les résultats uniquement à partir de certains agents de surveillance, ajoutez le paramètre de chaîne «Location» à l’URL de la demande de la manière suivante :

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=XXXXXXXXXXXSite=XXXXXType=Detail Location= [agent1] Location= [agent2] … Location= [agent5] … 

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

Liste des valeurs des chaînes des agents :

Amérique

  • San Francisco
  • IPv6 San Francisco
  • Seattle
  • Dallas
  • Denver
  • Minneapolis
  • Miami
  • Montréal
  • Washington DC
  • New York
  • AWS États-Unis-Est
  • Buenos Aires
Europe

  • Londres
  • Paris
  • Amsterdam
  • Copenhague
  • Francfort
  • Varsovie
  • Tel-Aviv
Asie, Australie, Afrique

  • Mumbai
  • Hong Kong
  • Beijing
  • Shanghai
  • Tokyo
  • Sydney
  • Brisbane
  • Johannesburg
  • Options=Commentaires

Incluez des commentaires personnalisés associés à un appareil.

  • Options=RequestDetails

Pour inclure les détails du niveau d’élément (inclus dans un graphique cascade), vous pouvez définir le drapeau Options à RequestDetails.

Inclure «Extended XML details».

  • Options=AllDownPercentages

Inclure tous les pourcentages du résumé.

  • Options=AllTimes

Inclure tous les temps de résumé, y compris les temps de disponibilité, les temps d’arrêt, les temps non définis, les temps de disponibilité pondérés et les temps d’arrêt pondérés.

  • Options=LatestResponses

Incluez la réponse la plus récente de chaque emplacement de surveillance attribué aux périphériques sélectionnés.

  • Montant= < nombre>

N’incluez < que le nombre défini de dernières réponses pour les appareils > sélectionnés.

  • Détails=Contenu

Incluez le contenu des détails de hit.

  • Détails=HtmlBody

Inclure Hitdetail HtmlBody

  • Détails=CommonDescription

Inclure Hitdetail CommonDescription

  • Détails=BrowserAction

Inclut les synchronisations de navigation telles que le début/fin de navigation, la redirection, l’extraction, la recherche de domaine, le démarrage de la demande, le déchargement de l’événement, le démarrage de rendu

Exemples:

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 - renvoie les sites et les tâches d'information sur la configuration

Cette URL de base est utilisée pour passer un certain nombre de paramètres dans la demande, comme décrit ci-dessous dans la liste des paramètres.

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

Cette URL vous permet de récupérer les ID du site et les ID de tâches.

Paramètres:

  • PID= < Compte UID>

Il s’agit de votre compte Global Unique Identifier(Configure > Integrations > the Unique Identifier (UID) colonne).

  • Nom du site= < Site1 > .. Site= < SiteN > OR Site=* – Liste des sites

Il s’agit d’une liste d’iD site. Aussi appelé «Dispositifs» dans Dotcom-Monitor. Les iD individuels de l’appareil peuvent être trouvés lorsqu’ils sont connectés à votre compte sur l’écran du gestionnaire d’appareil en cliquant sur modifier le menu d’action à côté de l’appareil sélectionné. lorsque l’écran suivant se charge, l’iD de l’appareil sera dans l’URL en tant que telle :

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

id=123456

Vous pouvez également obtenir l’iD du site à l’aide de l’interface XML. S’il vous plaît voir l’utilisation de config.aspx-dessus. Vous pouvez créer plusieurs sites en une seule demande. Utiliser * pour sélectionner tous les sites.

  • Tâche = < Tâche1 > .. Task= < TaskN > OR Task=* – Liste des tâches

Il s’agit d’un ID de tâches, similaire dans la structure du site.

Les ID de tâches individuels peuvent être trouvés lorsqu’ils sont connectés à votre compte sur l’écran du gestionnaire d’appareil en cliquant sur modifier le menu d’action à côté de la tâche sélectionnée. lorsque l’écran suivant se charge, l’iD de l’appareil sera dans l’URL en tant que telle :

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

id=123456

Vous pouvez également obtenir l’ID de tâche à l’aide de l’interface XML. S’il vous plaît voir l’utilisation de config.aspx-dessus. Vous pouvez effectuer plusieurs tâches en une seule demande. Utiliser * pour sélectionner toutes les tâches.

Vous pouvez également utiliser un masque pour le paramètre «SiteName» pour filtrer les résultats de la demande par un certain modèle de départ: SiteName=em*

  • Type=Tâche

Inclut les informations de base de la tâche.

  • Type=Champ

Inclut des informations détaillées sur les tâches.

Exemples:

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

Champs de réponse XML

Dans cette section, vous pouvez trouver des descriptions sur certains champs du flux Dotcom-Monitor XML :

<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>
  • Durée – temps global qui a été pris pour terminer la tâche (essentiellement – la somme des temps ci-dessous)
  • DNSTime – est le temps nécessaire pour résoudre un nom d’hôte (par exemple www.google.com) dans une adresse IP numérique (par exemple 216.239.59.99).
  • SSLTime – est le temps nécessaire pour terminer le processus de poignée de main SSL.
  • ConnectionTime – est le temps nécessaire pour créer une connexion TCP au serveur web (ou proxy). Les connexions Keep-Alive sont souvent utilisées pour éviter les frais généraux de se connecter à plusieurs reprises au serveur web.
  • RequestTime – est le temps nécessaire pour envoyer le message de demande HTTP au serveur et dépendra de la quantité de données qui est envoyée au serveur. Par exemple, de longs temps d’envoi résulteront du téléchargement de fichiers à l’aide d’un MESSAGE HTTP.
  • FirstPacketTime – (Time To First Byte) temps écoulé pour commencer à recevoir des données à partir du serveur Web distant. En d’autres termes, le temps entre la demande et la réponse d’abord byte reçu.
  • DownloadTime – est le temps nécessaire pour lire le message de réponse à partir du serveur. Cette valeur dépendra de la taille du contenu retourné, de la bande passante réseau et de l’utilisation de la compression HTTP. En d’autres termes, le temps entre la réponse d’abord et le dernier octets.

 

Département UID

Si vous avez des départements configurés dans votre compte, vous pouvez configurer XML Feed pour fournir des données sur un département particulier uniquement. Des UID individuels sont attribués pour chaque Département. Pour accéder à un UID département, passez votre compte Dotcom-Monitor à l’utilisateur du Département et copiez l’UID de Configure > Integrations > Unique Identifier (UID). Utilisez l’UID département au lieu de compte UID dans votre demande de flux XML.