Der XML Reporting Service (XRS) ist ein On-Demand-Dienst, der Daten über HTTP-Anforderungen bereitstellt. Wenn Sie eine ordnungsgemäß formatierte HTTP GET-Anforderung an xmlreporter.dotcom-monitor.com mit gültigen Parametern senden, erhalten Sie ein XML-Dokument mit den angeforderten Daten. Sie können mit den Daten aus dem XML-Dokument arbeiten, wie Sie benötigen. Zu den Möglichkeiten gehört das Importieren der Daten in ein anderes System oder Dashboard.

Die maximale Anzahl von Anforderungen an den XML-Berichtsdienst beträgt alle 10 Sekunden 1.

Wenn Sie mehr als eine Anforderung innerhalb von 10 Sekunden senden, gibt der Dienst ein XML-Dokument mit der nächsten zulässigen Anforderungszeit wie folgt zurück:

  • <Fehler > Sie haben das maximal zulässige Anforderungenlimit pro IP [192 .168.107.97] < /error erreicht>
  • <nextAllowedTime > Dienstag, 18. Februar 2014 19:50:26 < /nextAllowedTime>
  • <nextAllowedTimeGMT > Dienstag, 18. Februar 2014 16:50:26 < /nextAllowedTimeGMT>

Die XML FEED-Anforderung ist eine URL mit einer Anzahl von GET-Parametern, die durch ein “&”-Symbol getrennt sind.

Eine XML-Anforderung besteht aus den folgenden Elementen:

 [base_url_address]  +  [unique_account_uid]  +  [Site_id]  +   [parameter1] & [parameter2] … 

Beispielanforderungen:

 https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid=4229AF4F0FB545AEA75EAF2013E51BB7  &Site=12345  &Typ=Gesamt   https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid=78789A2394764BA880A4DCAC62AAE90D  &Site=57628  &Type=Detail&location=NY, USA 

Konto UID

Zum Erstellen einer XML-Anforderung benötigen Sie Ihr Konto Unique Identifire (UID), um es als Anforderungsparameter zu verwenden.  [unique_account_uid] . Diese ID kann gefunden werden, wenn Sie sich im Navigationsmenü unter Account > Integrations > Unique Identifier (UID) für den XML-Feed-Intergartionstyp bei Ihrem Konto angemeldet haben.

Abteilung UID

Wenn In Ihrem Konto Abteilungen konfiguriert sind, können Sie XML Feed so konfigurieren, dass nur Daten für eine bestimmte Abteilung angegeben werden. Für jede Abteilung werden einzelne UIDs zugewiesen. Um auf eine Department UID zuzugreifen, wechseln Sie Ihr Dotcom-Monitor-Konto zum Dienstdienstdienstbenutzer, und kopieren Sie die UID aus Account > Integrations > Unique Identifier (UID). Verwenden der Abteilungs-UID anstelle von Konto-UID  [unique_account_uid]  in Ihrer XML-Feed-Anforderung.

Verfügbare Anforderungskomponenten

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

Dadurch wird einfach der Status von: Up/Down/Postponed und der Status von Active/Postponed/NoTasks für die angeforderten Geräte zurückgegeben.

Parameter:

  • PID= < Konto UID>

Dies ist Ihr Konto Global Unique Identifier(Account > Integrations > the Unique Identifier (UID) Spalte).

  • Site= < Site1 > &.. &Site= < SiteN > ODER Site=* – Sites Liste

Dies ist eine Liste der Site-IDs. Wird im Dotcom-Monitor auch als “Geräte” bezeichnet. Einzelne Geräte-IDs können gefunden werden, wenn Sie sich auf dem Geräte-Manager-Bildschirm bei Ihrem Konto anmelden, indem Sie im Aktionsmenü neben dem ausgewählten Gerät auf Bearbeiten klicken. Wenn der nächste Bildschirm geladen wird, befindet sich die Geräte-ID in der URL als solche:

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

id=123456

Sie können die Standort-ID auch über die XML-Schnittstelle abrufen. Bitte beachten Sie die Verwendung von config.aspx. Sie können mehrere Standorte in einer Anforderung ausgeben. Verwenden Sie *, um alle Standorte auszuwählen.

Beispiele:

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

Diese Basis-URL wird verwendet, um eine Reihe von Parametern in der Anforderung zu übergeben, wie unten in der Liste der Parameter beschrieben.

Achten Sie darauf, alle Leerzeichen zwischen den Parametern zu entfernen, oder der XML-Feed ignoriert diese Parameter.

Parameter:

  • PID= < Konto UID>

Dies ist Ihr Konto Global Unique Identifier(Account > Integrations > the Unique Identifier (UID) Spalte).

  • Site= < Site1 > &.. &Site= < SiteN > ODER Site=* – Sites Liste

Dies ist eine Liste der Site-IDs. Wird im Dotcom-Monitor auch als “Geräte” bezeichnet. Einzelne Geräte-IDs können gefunden werden, wenn Sie sich auf dem Geräte-Manager-Bildschirm bei Ihrem Konto anmelden, indem Sie im Aktionsmenü neben dem ausgewählten Gerät auf Bearbeiten klicken. Wenn der nächste Bildschirm geladen wird, befindet sich die Geräte-ID in der URL als solche:

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

id=123456

Sie können die Standort-ID auch über die XML-Schnittstelle abrufen. Bitte beachten Sie die Verwendung von config.aspx oben. Sie können mehrere Standorte in einer Anforderung ausgeben. Verwenden Sie *, um alle Standorte auszuwählen.

  • Task= < Aufgabe1 > &.. &Task= < TaskN > ODER Task=* – Aufgabenliste

Dies ist eine ID von Aufgaben, ähnlich der Struktur von Site.

Einzelne Aufgaben-IDs können gefunden werden, wenn Sie sich auf dem Bildschirm Geräte-Manager in Ihrem Konto anmelden, indem Sie im Aktionsmenü neben der ausgewählten Aufgabe auf Bearbeiten klicken. Wenn der nächste Bildschirm geladen wird, befindet sich die Geräte-ID in der URL als solche:

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

id=123456

Sie können die Task-ID auch über die XML-Schnittstelle abrufen. Bitte beachten Sie die Verwendung von config.aspx oben. Sie können mehrere Aufgaben in einer Anforderung ausgeben. Verwenden Sie *, um alle Aufgaben auszuwählen.

Es gibt mehrere optionale Parameter, die mit & an die URL angehängt werden können, insbesondere beim Abrufen nach Antworten mit der Basis-URL http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx:

  • Type=Gesamt

Dadurch werden zusammenfassende Daten wie Betriebszeit/Ausfallzeiten, Anzahl der Erfolge und Anzahl der Fehler, Leistungsdaten und Standardabweichungen angezeigt.

  • Typ=Stunde

Dieser Parameter aggregiert Antworten in stundenlangen Zeiträumen und zeigt statistische Informationen für jede Stunde an.

  • Typ=Tag

Zusammenfassung nach Tagen für einen angegebenen Zeitraum einschließen.

  • Typ=Woche

Zusammenfassung nach Woche für den angegebenen Zeitraum einschließen.

  • Typ=Quartal

Dieser Parameter unterbricht einen Zeitraum in einen 3-Monats-Periode (Quartal) und jede ” < /Zusammenfassung > … < Das Element > “Zusammenfassung” stellt statistische Daten dar, die über einen Zeitraum von 3 Monaten berechnet wurden.

  • Typ=Monat

Monat= Zusammenfassung nach Monat für einen bestimmten Zeitraum.

  • Typ=Jahr

Jahr=Zusammenfassung nach Jahr für einen bestimmten Zeitraum.

  • Type=Detail

Sie stellt Rohdaten für einen angeforderten Zeitraum bereit. Rohdaten sind nur für die letzten 6 Monate verfügbar.

  • Startofweek= < Montag>

Ermöglicht es dem Benutzer, den Starttag einer Geschäftswoche zu verschieben. Sie können z. B. den Tag so einstellen, dass er auf einen Sonntag beginnt, z. B. in den USA (Startofweek=Sonntag) oder am Montag wie in der EU (Startofweek=Montag).

  • Von= < DatumAndzeit>

Dadurch werden das Startdatum und die Uhrzeit für die Berichterstattung angegeben.

Verwenden Sie für das US-Datums- und Uhrzeitformat Schrägstriche “MM/DD/YYYY H:M”
Verwenden Sie für das EU-Datums- und -UhrzeitformatBindestriche “YYYY-MM-DD H:M”

  • To= < DateAndTime>

Dadurch werden ein Enddatum und eine Endzeit für die Berichterstattung angegeben.
Verwenden Sie für das US-Datums- und Uhrzeitformat Schrägstriche “MM/DD/YYYY H:M”
Verwenden Sie für das EU-Datums- und -UhrzeitformatBindestriche “YYYY-MM-DD H:M”

US-Format:

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

EU-Format:

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
  • Typ = Hourofday

Dieser Parameter gibt Antworten mit 24 nummerierten Teilen, wobei jede ” < /Summary > … < /Summary > “ Element entspricht einer genauen Stunde an einem Tag. Statistische Werte (z. B. durchschnittliche Reaktionszeit, Reaktionszeit STDDev, Ausfallzeitprozentsatz usw.) spiegeln Durchschnittswerte wider, die über einen bestimmten Zeitraum (z. B. einen Wochenzeitraum) berechnet wurden. Dieser Parameter ist für die Analyse der stündlichen Last praktisch.

Dieser Typ funktioniert nur für Berichtszeiträume, die länger oder gleich 1 Tag sind.

  • Typ = StatusChange

Für jeden Block werden statistische Informationen berechnet, die der Zeitdauer nach jeder Statusänderung entsprechen. Dieser Parameter macht ” < /Summary > … < /Summary > “ Elemente zeigen Perioden auf die gleiche Weise an wie im Abschnitt “Uptime/Downtime Periods” eines Onlineberichts.

  • Typ = DayOfWeek

Dieser Parameter enthält eine Antwort, die sieben (7) nummerierte Teile enthält, wobei jedes ” < /Summary > … < /Summary > “ Element entspricht einem genauen Tag in einer Woche. Statistische Werte (z. B. durchschnittliche Reaktionszeit, Reaktionszeit STDDev, Ausfallzeitprozentsatz usw.) spiegeln Durchschnittswerte wider, die über einen bestimmten Zeitraum (z. B. einen Wochenzeitraum) für einen Tag berechnet wurden. Dieser Parameter ist praktisch für die Analyse der täglichen Last.

  • Filter= < FilterID>

Dies bietet die Möglichkeit, Ihre Daten in Übereinstimmung mit den Regeln des Filters zu filtern.

Einzelne Filter-IDs können gefunden werden, wenn Sie sich im Geräte-Manager-Bildschirm im Navigationsmenü unter Konfigurieren, Filter, in Ihrem Konto angemeldet haben. Wenn Sie auf einen Filter klicken, sehen Sie die ID in der URL der Bearbeitungsseite:

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

id=123456

  • Scheduler= < SchedulerID>

Dies bietet die Möglichkeit, Daten für einen bestimmten Zeitraum auszuschließen.

Einzelne Zeitplan-IDs können gefunden werden, wenn Sie sich im Geräte-Manager-Bildschirm im Navigationsmenü unter Konfigurieren, Zeitpläne in Ihrem Konto anmelden. Wenn Sie auf einen Filter klicken, sehen Sie die ID in der URL der Bearbeitungsseite:

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

id=123456

  • Status=S

Zeigen Sie nur erfolgreiche Antworten an.

  • Status=F

Zeigen Sie nur Fehlerantworten an.

  • Location= [agent1] &… &Standort=[agent2]

Filtern Sie Antworten nach Überwachen von Agentenstandorten.

Wenn der XML-Feed nur Ergebnisse von bestimmten Überwachungs-Agents anzeigen soll, fügen Sie der Anforderungs-URL wie folgt den Zeichenfolgenparameter “&Location” hinzu:

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

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

Liste der Zeichenfolgenwerte der Agents:

Amerika

  • San Francisco
  • IPv6 San Franciso
  • Seattle
  • Dallas
  • Denver
  • Minneapolis
  • Miami
  • Montreal
  • Washington DC
  • New York
  • AWS US-Ost
  • Buenos Aires
Europa

  • London
  • Paris
  • Amsterdam
  • Kopenhagen
  • Frankfurt
  • Warschau
  • Tel-Aviv
Asien, Australien, Afrika

  • Mumbai
  • Hongkong
  • Peking
  • Shanghai
  • Tokyo
  • Sydney
  • Brisbane
  • Johannesburg
  • Optionen=Kommentare

Fügen Sie benutzerdefinierte Kommentare ein, die einem Gerät zugeordnet sind.

  • Optionen=RequestDetails

Um Details auf Elementebene einzuschließen (wie in einem Wasserfalldiagramm enthalten), können Sie das Options-Flag auf RequestDetails festlegen.

Schließen Sie “Erweiterte XML-Details” ein.

  • Optionen=AllDownPercentages

Schließen Sie alle Prozentsätze der Zusammenfassung ein.

  • Optionen=AllTimes

Berücksichtigen Sie alle Zeiten der Zusammenfassung, einschließlich der Betriebszeit, Ausfallzeit, undefinierten Zeit, gewichteter Betriebszeit und gewichteter Ausfallzeiten.

  • Optionen=NeuesteAntworten

Schließen Sie die neueste Antwort von jedem Überwachungsstandort ein, der den ausgewählten Geräten zugewiesen ist.

  • Betrag= < Zahl>

Nur die < > festgelegte Anzahl der letzten Antworten für die ausgewählten Geräte einschließen.

  • Details=Inhalt

Fügen Sie Hit Detail Inhalt ein.

  • Details=HtmlBody

Hitdetail HtmlBody einschließen

  • Details=GemeinsameBeschreibung

Hitdetail CommonDescription einschließen

  • Details=BrowserAction

Umfasst Navigationszeiten wie Navigation Start / End, Redirect, Fetch, Domain Lookup, Request Start, Unload Event, Render Start

Beispiele:

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

Diese Basis-URL wird verwendet, um eine Reihe von Parametern in der Anforderung zu übergeben, wie unten in der Liste der Parameter beschrieben.

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

Mit dieser URL können Sie die Site-IDs und Aufgaben-IDs abrufen.

Parameter:

  • PID= < Konto UID>

Dies ist Ihr Konto Global Unique Identifier(Account > Integrations > the Unique Identifier (UID) Spalte).

  • SiteName= < Site1 > &.. &Site= < SiteN > ODER Site=* – Sites Liste

Dies ist eine Liste der Site-IDs. Wird im Dotcom-Monitor auch als “Geräte” bezeichnet. Einzelne Geräte-IDs können gefunden werden, wenn Sie sich auf dem Geräte-Manager-Bildschirm bei Ihrem Konto anmelden, indem Sie im Aktionsmenü neben dem ausgewählten Gerät auf Bearbeiten klicken. Wenn der nächste Bildschirm geladen wird, befindet sich die Geräte-ID in der URL als solche:

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

id=123456

Sie können die Standort-ID auch über die XML-Schnittstelle abrufen. Bitte beachten Sie die Verwendung von config.aspx oben. Sie können mehrere Standorte in einer Anforderung ausgeben. Verwenden Sie *, um alle Standorte auszuwählen.

  • Task= < Aufgabe1 > &.. &Task= < TaskN > ODER Task=* – Aufgabenliste

Dies ist eine ID von Aufgaben, ähnlich der Struktur von Site.

Einzelne Aufgaben-IDs können gefunden werden, wenn Sie sich auf dem Bildschirm Geräte-Manager in Ihrem Konto anmelden, indem Sie im Aktionsmenü neben der ausgewählten Aufgabe auf Bearbeiten klicken. Wenn der nächste Bildschirm geladen wird, befindet sich die Geräte-ID in der URL als solche:

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

id=123456

Sie können die Task-ID auch über die XML-Schnittstelle abrufen. Bitte beachten Sie die Verwendung von config.aspx oben. Sie können mehrere Aufgaben in einer Anforderung ausgeben. Verwenden Sie *, um alle Aufgaben auszuwählen.

Sie können auch eine Maske für den Parameter “SiteName” verwenden, um Anforderungsergebnisse nach einem Startmuster zu filtern: SiteName=em*

  • Type=Aufgabe

Enthält grundlegende Aufgabeninformationen.

  • Type=Feld

Enthält detaillierte Aufgabeninformationen.

Beispiele:

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

Beispiel:

<Antwort> 
<ID > 3424533543 < /ID> 
<Name > Demo-Anforderung < /Name> 
<URL > http://demo.webportal.com/APIv1/json?userid=test;userweight=22; ACT=DASW < /URL>
<Monitoring-Datum-Zeit > 26.03.2014 12:38:38 < /Monitoring-Datum-Zeit> 
<Dauer > 114 < /Dauer>
<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> 
</Antwort>
  • Dauer – Gesamtzeit zum Abschließen der Aufgabe (Grundsätzlich – Summe der nachstehenden Zeiten)
  • DnsTime – ist die Zeit, die zum Auflösen eines Hostnamens (z. B. www.google.com) in eine numerische IP-Adresse erforderlich ist (z. B. 216.239.59.99).
  • SSLTime – ist die Zeit, die zum Abschließen des SSL-Handshake-Prozesses erforderlich ist.
  • ConnectionTime – ist die Zeit, die zum Erstellen einer TCP-Verbindung zum Webserver (oder Proxy) erforderlich ist. Keep-Alive-Verbindungen werden häufig verwendet, um den Aufwand für wiederholte Verbindungen mit dem Webserver zu vermeiden.
  • RequestTime – ist die Zeit, die zum Senden der HTTP-Anforderungsnachricht an den Server erforderlich ist, und hängt von der Datenmenge ab, die an den Server gesendet wird. Beispielsweise ergeben sich lange Sendezeiten durch das Hochladen von Dateien mithilfe eines HTTP-POST
  • FirstPacketTime – (Time To First Byte) Verstrichene Zeit, um mit dem Empfang von Daten vom Remote-Webserver zu beginnen. Mit anderen Worten, die Zeit zwischen Anforderung und Antwort ersten Byte empfangen.
  • DownloadTime – ist die Zeit, die zum Lesen der Antwortnachricht vom Server verwendet wird. Dieser Wert hängt von der Größe des zurückgegebenen Inhalts, der Netzwerkbandbreite und der Verwendung der HTTP-Komprimierung ab. Mit anderen Worten, die Zeit zwischen der Antwort ersten und letzten Bytes.