Dotcom-Monitor позволяет отправлять данные со статистикой мониторинга в режиме реального времени или пользовательской информацией в сторонние программы, веб-приложения или панели мониторинга в режиме реального времени. Эти данные отчета в режиме реального времени могут включать такую информацию, как:

  • Статистика использования учетной записи Dotcom-Monitor (использованные и доступные ресурсы на одно решение).
  • Состояние и состояние одного или набора устройств мониторинга.
  • Сведения об ответе, полученные для одного или определенного набора устройств. Запрос информации об ответе может быть сильно настроен на необходимый уровень деталей с использованием ряда параметров запроса.
  • Мониторинг устройств и данных конфигурации задач.

Для публикации отчетов в режиме реального времени Dotcom-Monitor использует базу службы отчетности XML.

Служба отчетности XML (XRS) является бесплатной услугой n по требованию, которая предоставляет данные через запросы HTTP. Канал XML предоставляет информацию о контролируемых устройствах для веб-приложений и веб-сайтов в пользовательском формате. Примеры использования включают: провайдер, предоставляющий своим клиентам независимое время простоя, производительность и доминутный статус своих услуг через веб-сайт; или Центр обработки данных, интегрируя данные мониторинга с их внутренними приложениями.

Отправив правильно отформатированный запрос HTTP (S) GET
в xmlreporter.dotcom-monitor.com
с действительными параметрами, вы получите документ XML с запрошенными данными (см. спецификации по параметрам запроса в соответствующем разделе статьи). Вы можете работать с данными из документа XML по мере необходимости. Возможности включают импорт данных в другую систему, базу данных S’L, панель мониторинга или публикацию их в Microsoft Excel.

Напротив общих панелей мониторинга Dotcom-Monitor и других типов встроенных отчетов, используя XML Feed, вы можете тянуть только параметры, с помощью которые вы хотите работать или видеть на панели мониторинга в других типах сторонних приложений, хлиняемых источниками данных XML. Например, можно создать визуализацию веб-производительности конкретных устройств из вашей учетной записи Dotcom-Monitor с максимально доступным уровнем деталей. Гибкая структура XRS позволяет тянуть только наиболее важные для проекта метрики. Для настройки запроса доступно большое количество параметров запроса XML Feed – вы можете выбрать, хотите ли вы получить краткую сводку на устройствах мониторинга из вашей учетной записи или вы хотите иметь общие данные на каждом устройстве мониторинга. Давайте подробнее рассмотрим, насколько подробными могут быть ваши данные. Вы можете настроить запрос для получения:

  • Краткие данные, такие как время простоя/время простоя, количество успехов и количество сбоев, данные о производительности и стандартное отклонение.
  • Высоко детализированный отчет с необработанными данными за запрошенный период (до последних 6 месяцев).
  • Данные ответов агрегируются в часовые периоды.
  • Данные ответов агрегированы в 24-часовые периоды в течение определенного периода.
  • Резюме за неделю за указанный период.
  • Статистические данные, рассчитанные в течение 3-месячного периода.
  • Резюме за месяцем за указанный период.
  • Резюме за годом за указанный период.

Также, используя параметры запроса, можно указать дату начала и окончания и время представления отчетов. Для выполнения анализа почасовой и дневной нагрузки (среднее время отклика, время отклика STDDev, процент простоя и т.д.) можно вытащить отчет со средними данными, рассчитанными за определенный период (например, недельный период).

Если вы когда-либо тянуть онлайн отчеты для вашего устройства мониторинга в Dotcom-Monitor, вы, вероятно, может оказаться удобным для использования его Uptime / Downtime диаграммы. С помощью XRS-фреймворка вы также можете получить отчет XML со статистикой устройств, разбитой на периоды простоя и простоя.

Вы также можете применить фильтры Dotcom-Monitor (Настраивайте > фильтры) к данным в отчетах. Используя Расписание (Настраивайте > расписание), созданное в вашей учетной записи Dotcom-Monitor, вы можете публиковать только результаты, полученные в течение периода, указанного в определенном планировщике.

Кроме того, вы можете вытащить только успешные или только ответы на сбои по вашему выбору, фильтровать статистику отчета путем мониторинга мест в отчете XML Feed и т.д. Описание всех доступных параметров можно посмотреть в соответствующем разделе данной статьи.

Настройка запросов HTTP на XML Feed

Запрос XML Feed — это URL-адрес с несколькими параметрами GET, разделенный символом «Я».

Запрос XML состоит из следующих элементов:
 [base_url_address]  +  [unique_account_uid]  +  [Site_id]  Вопросы   [parameter1] [parameter2] и вопросы, которые будут й 

Пример запросов:
 https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid-4229AF4F0FB545AEA75EAF2013E51BB7     [/su_highlight]  https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid-78799A2394884BA880A4DCAC62AAE90D  (сайт)57628  (Тип) Подробное местоположение, Нью-США 

Учетная запись UID

Для создания запроса XML необходимо использовать уникальный идентификатор учетной записи (UID) в качестве параметра запроса  [unique_account_uid] . Этот идентификатор можно найти при вошли в вашу учетную запись в меню навигации в соответствии с Уникальным > > идентификатором интеграции настроек (UID) для типа интеграции XML Feed.

Ограничения на количество запросов XML Feed

Максимальное количество запросов в службу отчетов XML составляет 1 раз в 10 секунд.

Если вы отправляете более одного запроса в течение 10 секунд, XRS возвращает документ XML со следующим разрешено время запроса следующим образом:

  • <ошибка > Вы достигли максимально допустимого предела запросов на IP [192 .168.107.97] < /ошибку>
  • <nextAllowedTime > вторник, 18 февраля 2014 г. 19:50:26 < /nextAllowedTime>
  • <nextAllowedTimeGMT > вторник, 18 февраля 2014 г. 16:50:26 < /nextAllowedTimeGMT>

Доступные компоненты запроса

Учетная запись.aspx - возвращает использование пакета счетов
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/Account.aspx

Это вернет историю использования выбранной учетной записи с разбивкой по решениям. Отчет содержит информацию о емкости пакета и использованных ресурсах на пакет. Для корневых учетных записей будут включены пакеты Департамента.

параметр:

  • Учетная запись < PID’ UID>

Это ваша учетная запись Глобальный уникальный идентификатор > (Настройка интеграции > Уникальный идентификатор (UID) столбец).

Примеры:

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

статус.aspx - возвращает информацию о состоянии и статусе устройств
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx

Это просто вернет состояние: Up/Down/Postponed и статус Active/Postponed/NoTasks для запрошенных устройств.

Параметры:

  • Учетная запись < PID’ UID>

Это ваша учетная запись Глобальный уникальный идентификатор > (Настройка интеграции > Уникальный идентификатор (UID) столбец).

  • Сайт’ < > Сайт1. (Сайт) < SiteN > OR Site – Список сайтов

Это список СВУ сайта. Также называется “Устройства” в Dotcom-Монитор. Индивидуальные ID-устройства можно найти при вошли в вашу учетную запись на экране менеджера устройства, нажав на правку в меню действий рядом с выбранным устройством. Когда следующий экран загружается, идентификатор устройства будет в URL как таковой:

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

id-123456

Вы также можете получить идентификатор сайта с помощью интерфейса XML. Пожалуйста, посмотрите использование config.aspx. Вы можете выть несколько сайтов за один запрос. Используйте й, чтобы выбрать все сайты.

Примеры:

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

ответы.aspx - возвращает информацию о ответах
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx

Этот базовый URL используется для пропуска ряда параметров в запросе, как описано ниже в списке параметров.

Не забудьте удалить пробелы между параметрами или XML канал будет игнорировать эти параметры.

Параметры:

  • Учетная запись < PID’ UID>

Это ваша учетная запись Глобальный уникальный идентификатор > (Настройка интеграции > Уникальный идентификатор (UID) столбец).

  • Сайт’ < > Сайт1. (Сайт) < SiteN > OR Site – Список сайтов

Это список СВУ сайта. Также называется “Устройства” в Dotcom-Монитор. Индивидуальные ID-устройства можно найти при вошли в вашу учетную запись на экране менеджера устройства, нажав на правку в меню действий рядом с выбранным устройством. Когда следующий экран загружается, идентификатор устройства будет в URL как таковой:

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

id-123456

Вы также можете получить идентификатор сайта с помощью интерфейса XML. Пожалуйста, посмотрите использование config.aspx выше. Вы можете выть несколько сайтов за один запрос. Используйте й, чтобы выбрать все сайты.

  • Задача < > 1. «Task» < TaskN > OR Task » – Список задач

Это идентификатор задач, похожий по структуре на сайт.

Индивидуальные СВУ задач можно найти при записи в свою учетную запись на экране менеджера устройств, нажав на правку в меню действий рядом с выбранной задачей. при загрузке следующего экрана идентификатор устройства будет в URL как таковой:

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

id-123456

Вы также можете получить идентификатор задачи с помощью интерфейса XML. Пожалуйста, посмотрите использование config.aspx выше. Можно выполнить несколько задач в одном запросе. Используйте й, чтобы выбрать все задачи.

Есть несколько дополнительных параметров, которые могут быть прикодированы к URL-адресу с помощью q, особенно при опросе для ответов с базовым URL-адресом http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx:

  • Тип»Общий

Это позволит предоставить сводные данные, такие как время простоя/простоя, количество успехов и количество сбоев, данные о производительности и стандартное отклонение.

  • Тип-час

Этот параметр будет агрегировать ответы на часовые периоды и отображать статистическую информацию за каждый час.

  • Тип-день

Включите резюме по дням за определенный период.

  • Тип-неделя

Включите сводку за неделю за указанный период.

  • Тип-квартал

Этот параметр разбивает период на 3-месячный (квартал) период и каждый ” < /Summary > … < /Summary > ” элемент представляет статистические данные, рассчитанные за 3-месячный период.

  • Тип-месяц

Сводка за месяцем за указанным периодом.

  • Тип года

Год к году за указанным периодом.

  • Тип-деталь

Он предоставляет необработанные данные за запрошенный период. Необработанные данные доступны только за последние 6 месяцев.

  • Начало недели» < понедельник>

Позволяет пользователю перенести стартовый день деловой недели. Например, можно установить день, чтобы начать с воскресенья, как в США (Startofweek-воскресенье), или понедельник, как в ЕС (Startofweek-понедельник)

  • От < даты и времени>

Это определяет дату начала и время представления отчетов.

Для формата даты и времени в США используйте слэшы “MM/DD/YYYY H:M:S AM (PM)
Для формата даты и времениЕС используйте тире “YYYY-MM-DD H:M:S”

  • Дата и < время>

При этом указывается дата окончания и время представления отчетности.
Для формата даты и времени в США используйте слэшы “MM/DD/YYYY H:M:S AM (PM)”
Для формата даты и времениЕС используйте тире “YYYY-MM-DD H:M:S”

Формат США:

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

Формат ЕС:

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
  • Тип – Часовой день

Этот параметр дает ответы, содержащие 24 проумереные части, где каждый ” < / Резюме > … < /Summary > “ элемент соответствует одному точному часу в день. Статистические значения (например, среднее время отклика, время отклика STDDev, процент простоя и т.д.) отражают средние значения, рассчитанные за определенный период (например, недельный период). Этот параметр удобен для анализа почасовой нагрузки.

Этот тип работает только для отчетных периодов дольше или равна 1 день.

  • Тип – Изменение статуса

Статистическая информация рассчитывается для каждого блока, что соответствует продолжительности времени после изменения статуса. Этот параметр сделает ” < / Резюме > … < >/Резюме “ элементы отображают периоды так же, как и в разделе “Периоды uptime/Downtime” любого онлайн-отчета.

  • Тип – DayOfWeek

Этот параметр обеспечивает ответ, содержащий семь (7) проумереных частей, где каждый ” < /Summary > … < /Summary > ” элемент совпадает один точный день в неделю. Статистические значения (например, среднее время отклика, время отклика STDDev, процент простоя и т.д.) отражают средние значения, рассчитанные за определенный период (например, недельный период) за день. Этот параметр удобен для анализа дневной нагрузки.

  • Фильтровая < фильтрова>

Это обеспечивает возможность фильтрации данных в соответствии с правилами фильтра.

Индивидуальные ID-элементы фильтра можно найти при вошли в вашу учетную запись на экране менеджера устройства в меню навигации под Configure, Filters. При нажатии на фильтр вы увидите идентификатор в URL страницы редактирования:

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

id-123456

  • Расписание: < Расписание>

Это дает возможность исключить данные в течение определенного периода времени.

Индивидуальные ID-настройки расписания можно найти при вошли в вашу учетную запись на экране менеджера устройств в меню навигации под Configure, Расписание. при нажатии на фильтр вы увидите идентификатор в URL страницы редактирования:

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

id-123456

  • Статус-S

Просмотр только успешных ответов.

  • Статус-F

Просмотр только ответов на сбои.

  • Местоположение( [agent1] а) … (Местоположение)[agent2]

Фильтр ответов путем мониторинга местоположения агента.

Если вы хотите, чтобы XML Feed показал результаты только от определенных агентов мониторинга, добавьте параметр строки «Местоположение» в URL запроса следующим образом:

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=XXXXXXXXXXX&Site=XXXXX&Type=Detail  [agent1] (Местоположение) [agent2] … [agent5](Местоположение) … 

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

Список значений строк агентов:

Америка

  • Сан-Франциско
  • IPv6 Сан-Франциско
  • Сиэтл
  • Dallas
  • Денвер
  • Minneapolis
  • Майами
  • Монреаль
  • Вашингтон
  • Нью-йорк
  • AWS США-Восток
  • Буэнос-Айрес
Europe

  • Лондон
  • Париже
  • Амстердам
  • Копенгаген
  • Франкфурт
  • Варшава
  • Тель-Авив
Азия, Австралия, Африка

  • Мумбай
  • Гонконг
  • Пекин
  • Шанхай
  • Токио
  • Sydney
  • Брисбен
  • Йоханнесбург
  • Варианты и комментарии

Включите пользовательские комментарии, связанные с устройством.

  • Варианты »ЗапросДтейла

Чтобы включить детали уровня элемента (как включено в диаграмму водопада), можно установить флаг Options для запросаDetails.

Включите “Расширенные детали XML”.

  • Варианты »AllDownPercentages

Включите все проценты резюме.

  • Варианты »AllTimes

Включите все время резюме, включая время простоя, простои, неопределенное время, взвешенное время простоя и взвешенное время простоя.

  • Варианты:ПоследниеОтветы

Включите самый последний ответ из каждого места мониторинга, назначенного выбранным устройствам.

  • Номер < суммы>

Включите только набор < последних > ответов для выбранных устройств.

  • Подробная информация и содержание

Включите содержание деталей Hit.

  • Подробности:HtmlBody

Включить Hitdetail HtmlBody

  • Подробная информация (Общийвзрач)

Включить Hitdetail CommonDescription

  • Подробная информация-BrowserAction

Включает в себя навигационные тайминги, такие как навигационный старт / конец, перенаправление, извлечение, просмотр домена, начало запроса, событие разгрузки, начало рендера

Примеры:

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

[/]
конфигурация.aspx - возвращает сайты и сведения о конфигурации задач

Этот базовый URL используется для пропуска ряда параметров в запросе, как описано ниже в списке параметров.

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

Этот URL-адрес позволяет получить ID-адреса сайта и ID-адреса задач.

Параметры:

  • Учетная запись < PID’ UID>

Это ваша учетная запись Глобальный уникальный идентификатор > (Настройка интеграции > Уникальный идентификатор (UID) столбец).

  • СайтИмя < > сайта1. (Сайт) < SiteN > OR Site – Список сайтов

Это список СВУ сайта. Также называется “Устройства” в Dotcom-Монитор. Индивидуальные ID-устройства можно найти при вошли в вашу учетную запись на экране менеджера устройства, нажав на правку в меню действий рядом с выбранным устройством. при загрузке следующего экрана идентификатор устройства будет в URL как таковой:

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

id-123456

Вы также можете получить идентификатор сайта с помощью интерфейса XML. Пожалуйста, посмотрите использование config.aspx выше. Вы можете выть несколько сайтов за один запрос. Используйте й, чтобы выбрать все сайты.

  • Задача < > 1. «Task» < TaskN > OR Task » – Список задач

Это идентификатор задач, похожий по структуре на сайт.

Индивидуальные СВУ задач можно найти при записи в свою учетную запись на экране менеджера устройств, нажав на правку в меню действий рядом с выбранной задачей. при загрузке следующего экрана идентификатор устройства будет в URL как таковой:

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

id-123456

Вы также можете получить идентификатор задачи с помощью интерфейса XML. Пожалуйста, посмотрите использование config.aspx выше. Можно выполнить несколько задач в одном запросе. Используйте й, чтобы выбрать все задачи.

Вы также можете использовать маску для параметра “SiteName” для фильтрации результатов запроса по некоторым стартовым шаблонам: SiteName

  • Тип-задача

Включает базовую информацию о задаче.

  • Тип-поле

Включает подробную информацию о задаче.

Примеры:

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

В этом разделе можно найти описания на некоторых полях из канала 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>
  • Продолжительность – общее время, которое было заснято для выполнения задачи (в основном – сумма раз ниже)
  • DNSTime – это время, необходимое для разрешения имени хоста (например, www.google.com) на числовой IP-адрес (например, 216.239.59.99).
  • SSLTime – это время, необходимое для завершения процесса рукопожатия SSL.
  • ConnectionTime – это время, необходимое для создания подключения TCP к веб-серверу (или прокси). Keep-Alive соединения часто используются, чтобы избежать накладных расходов неоднократно подключения к веб-серверу.
  • RequestTime – это время, необходимое для отправки сообщения запроса HTTP на сервер и будет зависеть от объема данных, отправляемых на сервер. Например, длительное время отправки будет результатом загрузки файлов с помощью HTTP POST.
  • FirstPacketTime – (Time To First Byte) время прошло, чтобы начать получать данные с удаленного веб-сервера. Другими словами, время между запросом и ответом сначала было получено.
  • DownloadTime – это время, затя взятое для чтения ответа с сервера. Это значение будет зависеть от размера возвращенного содержимого, пропускной способности сети и от того, использовалось ли сжатие HTTP. Другими словами, время между ответом первого и последнего байтов.

 

Департамент UID

Если в вашей учетной записи настроены отделы, можно настроить XML Feed для предоставления данных только в определенном отделе. Для каждого Департамента назначаются индивидуальные пользовательские интерфейсы. Чтобы получить доступ к UID Департамента, переключите учетную запись Dotcom-Monitor на пользователя Отдела и скопируйте UID из уникального > идентификатора Configure > Integrations (UID). Используйте UID Департамента вместо UID учетной записи в запросе XML Feed.