Verwenden des XML Reporting Service (XRS)-Tools

Siehe auch:

Mit Dotcom-Monitor können Sie Daten mit Echtzeit-Überwachungsstatistiken oder benutzerdefinierten Informationen an Software, Webanwendungen oder Echtzeit-Dashboards von Drittanbietern senden. Diese Echtzeit-Berichtsdaten können Informationen wie:

Statistiken zur Dotcom-Monitor-Kontoauslastung (verwendete und verfügbare Ressourcen pro Lösung).
Ein Zustand und Status eines oder mehrerer Überwachungsgeräte.
Antwortdetails, die für ein oder einen bestimmten Satz von Geräten empfangen wurden. Die Anforderung der Antwortinformationen kann mithilfe einer Reihe von Anforderungsparametern an die erforderliche Detailebene angepasst werden.
Überwachen von Geräte- und Aufgabenkonfigurationsdaten.

Um bedarfsgebundene Echtzeitberichte zu veröffentlichen, verwendet Dotcom-Monitor das XML Reporting Service Framework.

Der XML Reporting Service (XRS) ist ein kostenloser On-Demand-Dienst, der Daten über HTTP-Anforderungen bereitstellt. Der XML-Feed liefert überwachte Geräteinformationen für Webanwendungen und Websites in einem benutzerdefinierten Format. Anwendungsbeispiele sind: ein ISP, der seinen Kunden über eine Website unabhängige Betriebszeit, Leistung und den Status seiner Dienste im Minutentakt zur Verfügung stellt; oder ein Rechenzentrum, das Überwachungsdaten in ihre internen Anwendungen integriert.

Wenn Sie eine ordnungsgemäß formatierte HTTP(S)-GET-Anfrage mit gültigen Parametern an
xmlreporter.dotcom-monitor.com
senden, erhalten Sie ein XML-Dokument mit den angeforderten Daten. Weitere Informationen finden Sie in den Spezifikationen zu den Anforderungsparametern im Artikel Beschreibung der Anforderungsparameter zum Abrufen von Echtzeit-XML-Berichten .

Sie können mit den Daten aus dem XML-Dokument nach Bedarf arbeiten. Zu den Möglichkeiten gehören das Importieren der Daten in ein anderes System, eine SQL-Datenbank, ein Dashboard oder das Veröffentlichen in Microsoft Excel.

Konfigurieren von HTTP-Anforderungen an XML-Feed

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] + [account_uid] + [Site_id] + [parameter1]&[parameter2]…

Beispielanforderungen:
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=Detail&location=NY, USA

Konto UID

Um eine XML-Anfrage zu erstellen, benötigen Sie zunächst die eindeutige Kennung (Konto-UID) Ihres Kontos, die Sie als [account_uid] in den Anforderungsparametern.

So erstellen Sie eine Konto-UID für den XML-Feed:

Melden Sie sich bei Ihrem Dotcom-Monitor-Stammkonto an.
Gehen Sie zu Integrationen verwalten > und klicken Sie auf Neue Integration.
Wählen Sie im Fenster Add Integration ( Integration hinzufügen ) die Option XML Feed ( XML-Feed) aus.
Klicken Sie auf Integration erstellen.
Verwenden Sie die UID, die für den XML-Feed-Integrationstyp hinzugefügt wurde, als Konto-UID in den Anforderungen an mlreporter.dotcom-monitor.com
.

So geben Sie die Daten der Abteilung in einen XML-Feed aus

Wenn Sie Abteilungen in Ihrem Konto erstellt haben, können Sie einen XML-Feed konfigurieren, um Berichte zu einer bestimmten Abteilung oder mehreren bestimmten Abteilungen zu liefern. Es gibt zwei Möglichkeiten, eine XML-Anforderung an eine Abteilung zu erstellen.

Benutzer mit einem auf ein bestimmtes Dotcom-Monitor-Abteilungskonto beschränkten Zugriff können XML-Berichte
nur für die zugewiesene Abteilung abrufen. Sie können wie gewohnt eine Konto-UID für Ihre Abteilung erstellen, wenn Sie im Abteilungskonto angemeldet sind. Verwenden Sie einfach diese UID für die Abteilung als Ihre Konto-UID bei allen Anfragen an
xmlreporter.dotcom-monitor.com
.

Benutzer mit Zugriff auf ein Dotcom-Monitor-Stammkonto
können Daten zu einer bestimmten Abteilung oder mehreren bestimmten Abteilungen aus dem Konto abrufen, indem sie die Konto-UID mit aktiviertem Zugriff auf die Daten der Abteilung in Verbindung mit den Abteilungskonto-IDs in den Anforderungen an
xmlreporter.dotcom-monitor.com verwenden:

https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?PID=<Account UID with access to department's data>&Department=<Department Account ID>

Einzelne Abteilungskonto-IDs werden jeder Abteilung zugewiesen und finden Sie, wenn Sie bei einem Root-Konto angemeldet sind, unter Kontoeinstellungen > Abteilungen.

So erstellen Sie eine Konto-UID für den XML-Feed mit Zugriff auf die Daten der Abteilung:

Melden Sie sich bei Ihrem Dotcom-Monitor-Stammkonto an.
Gehen Sie zu Kommunalintegrationen > und klicken Sie auf Neue Integration.
Wählen Sie im Fenster ” Integration hinzufügen ” die Option ” XML-Feed” aus, und wählen Sie ” Zugriff auf die Daten der Abteilung zulassen” aus.
Klicken Sie auf Integration erstellen.
Verwenden Sie die UID für den Integrationstyp XML-Feed (mit Zugriff auf die Daten der Abteilung) als Konto-UID in den Anforderungen.

Beispiel

Diese Anforderung gibt den XML-Code mit Details zu allen Sites und Geräten zurück, aufgeschlüsselt nach Abteilungen mit den angegebenen IDs:

https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?PID=F8F97FD1B7440685F747096B6FFB80&Department=59069&Department=97895&SiteName=*

Einschränkungen bei der Anzahl der XML-Feedanforderungen

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

XML Response Fields

In diesem Abschnitt finden Sie Beschreibungen zu einigen Feldern aus dem Dotcom-Monitor XML Feed:

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

Dauer – Gesamtzeit, die zum Abschließen der Aufgabe in Anspruch genommen wurde (im Grunde – die 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 aus dem 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.

Im Gegensatz zu den gemeinsam nutzenden Dashboards von Dotcom-Monitor und anderen Arten integrierter Berichte können Sie mit dem XML-Feed nur Parameter abrufen, mit denen Sie in anderen Typen von Drittanbieteranwendungen, die XML-Datenquellen unterstützen, auf Ihrem Dashboard arbeiten oder auf Ihrem Dashboard anzeigen möchten. Sie können z. B. eine Visualisierung der Webleistung bestimmter Geräte aus Ihrem Dotcom-Monitor-Konto mit der maximal verfügbaren Detailgenauigkeit erstellen. Mit dem flexiblen XRS-Framework können Sie nur Metriken abrufen, die für Ihr Projekt am wichtigsten sind. Eine große Anzahl von XML-Feed-Anforderungsparametern steht zur Verfügung, um Ihre Anfrage anzupassen – Sie können wählen, ob Sie eine kurze Zusammenfassung der Überwachungsgeräte von Ihrem Konto erhalten möchten oder sie möchten, dass die Gesamtdaten auf jedem Überwachungsgerät vorhanden sind. Schauen wir uns genauer an, wie detailliert Ihre Daten sein können. Sie können Ihre Anfrage für den Empfang konfigurieren:

Zusammenfassungsdaten, z. B. Betriebszeit/Ausfallzeiten, Anzahl der Erfolge und Anzahl der Fehler, Leistungsdaten und Standardabweichung.
Ausführlicher Bericht mit Rohdaten für einen gewünschten Zeitraum (bis zu den letzten 6 Monaten).
Reaktionsdaten, die zu stundenlangen Zeiträumen aggregiert wurden.
Antwortdaten, die für einen bestimmten Zeitraum in 24h-langen Zeiträumen aggregiert wurden.
Zusammenfassung nach Woche für den angegebenen Zeitraum.
Statistische Daten, die über einen Zeitraum von 3 Monaten berechnet werden.
Zusammenfassung nach Monat für einen bestimmten Zeitraum.
Zusammenfassung nach Jahr für einen bestimmten Zeitraum.

Außerdem können Sie mithilfe der Anforderungsparameter das Start- und Enddatum und die Uhrzeit für die Berichterstellung angeben. Um eine Analyse der stündlichen und täglichen Last (Durchschnittliche Reaktionszeit, Reaktionszeit STDDev, Ausfallzeitprozentsatz usw.) auszuführen, können Sie einen Bericht mit Durchschnittswerten abrufen, die über einen bestimmten Zeitraum (z. B. einen Wochenzeitraum) berechnet werden.

Wenn Sie jemals Online-Berichte für Ihr Überwachungsgerät in Dotcom-Monitor gezogen haben, ist es wahrscheinlich bequem, das Uptime/Downtime-Diagramm zu verwenden. Mit dem XRS-Framework können Sie auch einen XML-Bericht mit Gerätestatistiken erhalten, die nach Uptime- und Downtime-Zeiträumen aufgeschlüsselt sind.

Sie können auch Dotcom-Monitor-Filter > (Filter konfigurieren) auf die Daten in Ihren Berichten anwenden. Mithilfe der in > Ihrem Dotcom-Monitor-Konto erstellten Zeitpläne (Zeitplan konfigurieren) können Sie nur Ergebnisse veröffentlichen, die während eines in einem bestimmten Planer angegebenen Zeitraums empfangen wurden.

Darüber hinaus können Sie nur erfolgreiche oder nur Fehlerantworten nach Ihrer Wahl abrufen, die Berichtsstatistiken filtern, indem Sie Speicherorte in Ihrem XML-Feedbericht überwachen usw. Siehe die Beschreibungen aller verfügbaren Parameter in den entsprechenden Abschnitten dieses Artikels.