POST method example
POST method example Example of monitoring a webform with POST method.

For example you have such simple form:
form action="some-site.com/some-script.cgi" method=post
input type=text name=login value=''
input type=password name=password value=''
input type=submit name='Submit' value='Login'
/form
User fill this form with value login: Peter and password: 1234 and click submit. If everything is Ok, script prints "LoginOk" on the result page.
For making a monitoring task to control this script, create task with next fields:

URL: some-site.com/some-script.cgi
Http Method: choose POST
In "POST parameters" field you should add three strings:
login=Peter
password=1234
Submit=Login
In "Content check" field: LoginOk
Results: HostTracker with every check will fill this form and assume that it is OK if the set keyword LoginOk is returned.

  • CM.Glossary.WebsiteMonitoring
  • CM.Glossary.HTTPMethods
more glossary
"

I rely on HostTracker to monitor my servers so I can sleep at night

"
- S.
Escalations. Typical scenarios

As many people know, HostTracker is a sites efficiency monitoring system. One of its main functions is to notify the user of any problems promptly. The efficiency of the notifications and the acceptable level of “detalization” are important. If you send alerts at each “sneeze”, the person will not find the important information in this flow...

I was woken up by an SMS at three a.m.
My site dropped for three minutes, and it raised back itself.
But I could not go back to sleep.
True-life story

As many people know, HostTracker is a sites efficiency monitoring system. One of its main functions is to notify the user of any problems promptly. The efficiency of the notifications and the acceptable level of “detalization” are important. If you send alerts at each “sneeze”, the person will not find the important information in this flow.

We have provided several mechanisms that will help the right people to get the necessary notifications:

  • Separation of the notifications into several groups according to their criticality;
  • No notifications at short-term failures;
  • Report the problem to the manager promptly;
  • Report a prolonged failure to the administration;
  • Use the free alerts first – email, gtalk, and then the paid ones – SMS or phone call;
  • At the contact level – set the working time when this contact should receive the alerts.

 

There are three types of notifications:

 

  • The website has “dropped”;
  • The website is still “down”;
  • The website “rose

 

The “dropped” and “rose” are clear. The notifications “site is still down” are sent at each test fail, but only at the confirmed drops. The fails confirmation algorithm was described in the article “False alerts exclusion”

 

For each site-contact pair you may enable or disable the appropriate notification type. The setting can be located in the contact properties as well as in the general “matrix” at the “Notifications subscribtion” page.

Escalation and the notifications detalization level.

Suppose, two people are responsible for the site:

  • Administrator
  • Manager

 

Let's try to implement the following scenario:

 

  • In the event of a “drop” we want to send an email message to the administrator immediately;
  • If the site does not rise within 15 minutes, we send an SMS to the administrator;
  • If the site is “down” for more than an hour, then we send an SMS to the manager.

 

Adding the contacts for the users. While adding, draw attention to the “Notification Delay” window.

 

We appear to have three contacts with the following delays:

  • Administrator (email) – no delay;
  • Administrator (SMS) – 15 minutes delay;
  • Manager (SMS) – 1 hour delay.

 

According to this configuration the administrator will get all the failures notifications to the email, but SMS notifications will be sent only if the site is “down” for more then 15 minutes. The manager will receive only SMS about major failures lasting more than an hour. Setting up the contact working schedule

 

Suppose that one administrator can not cope, and we hired one more administrator. The first one works during the first half of the week, the second one works during the second half. Accordingly the notifications should be sent to the administrator “on duty” To set this scenario the window “Set the contact working hours” is used in the contact settings.

In this case the first administrator will receive the SMS notifications from Monday to Thursday inclusive. Additionally, you may divide the notification for different employees according to the time of day, for example appointing day and night administrators.

Conclusions: with the help of relatively simple mechanisms we may cover most notifications fine-tune user scenarios.

more blog
 
Sign In
Sign Up
Prices & packages
Our monitoring network
Home > Blog
Использование REST и SOAP API Host-Tracker (Русский)

API-сервис разработан для тех разработчиков, которые желают интегрировать в свои приложения функциональные возможности, предлагаемые в Host-Tracker. Это можно осуществить с помощью простых Http-запросов (REST API) или же при помощи более сложных запросов, основанных на протоколе SOAP (SOAP API). Детальная настройка заданий по REST API и SOAP API.

Доступность сайта в сети — важнейшее условие его посещения пользователем. Пользователь, заходя на страницы веб-сайта, выполняет некоторые действия, которые в конечном итоге превращаются в материальную выгоду для владельца сайта — делает покупки, пользуется платными сервисами и прочее. Если веб-ресурс не был доступен какой-то период времени, то это оборачивается потерей репутации, прибылей, посетителей. Поэтому стабильность работы сайта следует отслеживать, мониторить его доступность в сети. Компания Host-Tracker предложила для этого ряд удобных сервисов, которые можно настраивать также, используя API сервиса Host-Tracker.

Поддержка REST и SOAP API

Host-Tracker предлагает возможность использовать сервис мониторинга как веб-службу, что очень удобно при необходимости создания десктопных, мобильных приложений, при осуществлении мониторинга большого числа веб-сайтов. Например, управлять мониторингом сайтов, количество которых переваливает за 1000, весьма проблематично. API-сервис разработан для тех разработчиков, которые желают интегрировать в свои приложения функциональные возможности, предлагаемые в Host-Tracker. Это можно осуществить с помощью простых Http-запросов (REST API) или же при помощи более сложных запросов, основанных на протоколе SOAP (SOAP API).

Настройка заданий

Настройка заданий по REST API может производиться в разных форматах. Заголовок Http-запроса Content-Type может быть определен как: application/json, text/xml, application/x-www-form-urlencoded (данные в виде «имя-значение»). В случае с SOAP API используется вызов удаленных процедур, что определены в технической документации сервиса. Примером таких функций могут стать: CreateHttpGetTask, CreateHttpHeadTask и множество других.

В рамках REST API с помощью POST запросов можно создавать задания: http-проверки, ping-проверки, а также проверки портов. Запросы, использующие метод PUT, позволят редактировать ранее созданное задание. С помощью GET-метода можно получить данные, принятые для настройки заданий или о самих заданиях, а при помощи DELETE-запроса предоставляется возможность удаления ранее настроенного задания. Так, запрос с методом GET к ресурсу api/web/v1/tasks/intervals в качестве ответа вернет данные о доступных в сервисе интервалах, которые определены следующими числами: 1, 5, 15, 30, 60. Для того чтобы получить те же значения, но через SOAP API, разработчику достаточно воспользоваться вызовом удаленной функции GetTaskIntervals. Использование метода POST совместно с ресурсом api/web/v1/tasks/http позволит создать задание Http-проверки.

Пример авторизации по REST API

Приведем простой пример авторизации в сервисе Host-Tracker, использующий простой Http-запрос. Чтобы выполнить авторизацию, необходимо послать POST-запрос для ресурса api/web/v1/users/token. В зависимости от выбранного формата поле заголовка Content-Type должно содержать одно из трех выше указанных значений. Например, если формат запроса и ожидаемого ответа должен быть в xml виде, тогда в поле заголовка должно значиться text/xml. Значение логина записывается в элементе <login>, а значение пароля — в <password>. Оба эти элемента являются дочерними узлами корневого элемента <LoginData>.

Рис.1.(Изображение, представляющее POST запрос авторизации в формате XML)

Авторизация в формате json также очень проста. Для ее реализации нужно лишь изменить значение ключевого заголовка Content-Type, а в теле документа передавать данные в формате json.

Рис.2.(Изображение, демонстрирующее POST запрос в формате JSON)

Детальная настройка заданий по REST API и SOAP API.

more
Share:
Send to Twitter Send to Facebook Send to LinkedIn Share on Google+
Blogs:
HostTracker blog HostTracker page on Facebook