Получение подробной статистики по указанной задаче
Адрес для отправки запросов
Запросы должны отправляться методом GET или POST к следующему адресу:
https://ping-admin.com/?a=api&sa=task_stat&[список параметров, описание которых ниже]
Список параметров запроса
- api_key
-
Обязательный параметр: да.
Значение: ваш уникальный ключ API, который можно найти в личном кабинете в разделе «Настройки профиля».
Пример использования:
https://ping-admin.com/?a=api&sa=task_stat&api_key=6e59663b2ce62ac378be24bc30f48b95946&[другие параметры] - id
-
Обязательный параметр: да.
Значение: ID задачи, о которой необходимо получить информацию.
Пример использования:
https://ping-admin.com/?a=api&sa=task_stat&id=2&[другие параметры] - dt_from
-
Обязательный параметр: нет.
Значение по умолчанию: 01.01.1970 00:00:00.
Значение: Дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС, начиная с которых нужно выводить информацию о сотоянии задачи (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Пример использования:
https://ping-admin.com/?a=api&sa=task_stat&dt_from=2012-01-31+23:45:30&[другие параметры] - dt_to
-
Обязательный параметр: нет.
Значение по умолчанию: текущая дата.
Значение: Дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС, начиная до которых нужно выводить информацию о сотоянии задачи (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Пример использования:
https://ping-admin.com/?a=api&sa=task_stat&dt_to=2022-12-31+23:45:30&[другие параметры] - limit
-
Обязательный параметр: нет.
Значение по умолчанию: 10.
Значение: количество записей об изменении состояния задачи от 1 до 100.
Пример использования:
https://ping-admin.com/?a=api&sa=task_stat&limit=11&[другие параметры] - tm
-
Обязательный параметр: нет.
Значение: ID точки мониторинга, только информацию о которой нужно выводить (актуально только при алгоритме проверки «Из каждой выбранной точки мониторинга независимо».
Пример использования:
https://ping-admin.com/?a=api&sa=task_stat&tm=ru1&[другие параметры] - enc
-
Обязательный параметр: нет.
Значение: если указано «utf8», то в ответе будет заголовок «Content-type: application/json; charset=utf8» и кодировка ответа будет UTF-8.
Пример использования:
https://ping-admin.com/?enc=utf8&[остальные парамтеры]
Ответ на отправленный запрос
[{"tasks_logs":[{"comment":"","data":"2010-04-29 11:15:07","descr":"","status":"1","tm":""}],"uptime":"87.63","uptime_nw":4781}]
Список параметров ответа
- tasks_logs
-
Тип: массив.
Значение: список изменений статуса задачи.- data
-
Тип: дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Значение: дата и время события. - status
-
Тип: целое число.
Значение: 1 — проверяемый сервис заработал; 0 — проверяемый сервис перестал работать, или он не работает, и поменялась ошибка, из-за которой он не работает. - descr
-
Тип: строка.
Значение: описание ошибки, если status=0. - comment
-
Тип: строка.
Значение: комментарий пользователя, оставленный им в личном кабинете. - tm
-
Тип: строка.
Значение: Текстовое название точки мониторинга, которая выполняла проверки, если алгоритм проверки был не «Авто». - tm_id
-
Тип: строка.
Значение: ID точки мониторинга, от которой получены данные, если алгоритм проверки был не «Авто».
- uptime
-
Тип: дробное число.
Значение: Uptime задачи за указанное время. - uptime_w
-
Тип: целое число.
Значение: количество секунд, которое проверяемый сервис работал за указанное время. - uptime_nw
-
Тип: целое число.
Значение: количество секунд, которое проверяемый сервис не работал за указанное время.