Запускайте проверки из вашего мониторинга

У Pingera нет цели заменить вашу систему мониторинга. Мы позволяем нашим пользователям получить взгляд на инфраструктуру и сервисы извне. Сегодня в нашей платформе добавились Проверки по запросу. Новые API методы позволяют запускать гео-распределенные проверки по запросу, без нужды создавать регулярные проверки и ждать результат.

Как это работает

В личном кабинете на экране создания или редактирования проверки добавилась кнопка - “Запустить сейчас”.

Нажимая на эту кнопку вы можете мгновенно протестировать новую проверку. Это работает для любых проверок, включая синтетические тесты и SSL.

API

В API добавились новые методы, которые вы можете использовать в скриптах для интеграции с вашей системой мониторинга.

Новые методы:

POST /v1/checks/execute - запустит новую проверку, в теле нужно передать параметры.
POST /v1/checks/{check_id}/execute - запустит существующую регулярную проверку.

Так как некоторые проверки занимают время на выполнение, мы не возвращаем результат проверки сразу. Поэтому в ответ вы получите job_id.

{
	"job_id": "psu2jq4pqmyl",
	"message": "Custom check execution queued successfully",
	"status": "queued"
}

Посмотреть результаты можно используя методы:

GET /v1/checks/jobs
GET /v1/checks/jobs/{job_id}

В ответ вы получите результат проверки в том же формате, что и в /v1/checks/{check_id}/results.

Больше информации в документации API - Проверки по запросу.

Пример интеграции

Мы выложили скрипт для демонстрации в pingera/blog-data/intro-on-demand-checks.

Результат выполнения скрипта:

--- Pingera API Endpoint Demo ---
Using API Token from environment variable: PINGERA_API_TOKEN

1. Sending POST request to execute check...
   URL: https://api.pingera.ru/v1/checks/execute
   Body: {
  "name": "Pingera web check",
  "type": "web",
  "url": "https://app.pingera.ru",
  "timeout": 10
}

--- Initial Response ---
{
  "job_id": "nifxjyphmxb0",
  "message": "Custom check execution queued successfully",
  "status": "queued"
}

Extracted Job ID: nifxjyphmxb0

2. Periodically probing job status for job ID: nifxjyphmxb0
   Polling every 3 seconds, max attempts: 20
  [1] Job ID: nifxjyphmxb0 - Status: RUNNING
  [2] Job ID: nifxjyphmxb0 - Status: COMPLETED

--- Job Completed! Final Result ---
{
  "check_id": null,
  "check_parameters": {
    "name": "Pingera web check",
    "timeout": 10,
    "type": "web",
    "url": "https://app.pingera.ru"
  },
  "completed_at": "2025-06-03T15:28:14.810013",
  "created_at": "2025-06-03T15:28:14.677238",
  "error_message": null,
  "id": "nifxjyphmxb0",
  "job_type": "custom_check",
  "result": {
    "check_id": null,
    "check_metadata": {
      "headers": {
        "Cache-Control": "public, max-age=0",
        "Connection": "keep-alive",
        "Content-Encoding": "gzip",
        "Content-Type": "text/html; charset=UTF-8",
        "Date": "Tue, 03 Jun 2025 15:28:14 GMT",
        "ETag": "W/\"7bb-19731468290\"",
        "Last-Modified": "Mon, 02 Jun 2025 15:33:14 GMT",
        "Strict-Transport-Security": "max-age=31536000; includeSubDomains",
        "Transfer-Encoding": "chunked",
        "Vary": "Accept-Encoding",
        "X-Powered-By": "Express"
      },
      "status_code": 200
    },
    "check_server_id": "8q01od8rtl93",
    "job_id": "nifxjyphmxb0",
    "response_time": 47,
    "status": "ok"
  },
  "started_at": "2025-06-03T15:28:14.684825",
  "status": "completed"
}

--- Key Check Result Details ---
  Status: ok
  Response Time: 47 ms
  HTTP Status Code: 200

--- Demo Finished ---

Тарификация

До этого наши тарифы ограничивали только количество регулярных проверок, которые пользователь может создать. С введением Проверок по запросу мы вводим понятие Кредитов.

Каждый тариф предоставляет определённое количество Кредитов на расчётный период (30 дней). Эти кредиты расходуются при каждом запуске любой Проверки:

1 Кредит: за запуск Стандартной проверки (Веб, API, TCP).
2 Кредита: за запуск Углублённой проверки (SSL/TLS, Синтетические).

Ежемесячный лимит Кредитов мониторинга расходуется как на регулярные автоматические проверки, так и на проверки по запросу (on-demand). Если общий расход Кредитов превысит лимит тарифа, регулярные проверки временно приостанавливаются до начала нового расчётного периода.

Вы можете прочитать больше на сайте в разделе Тарифы и цены и посмотреть количество доступных кредитов в личном кабинете на app.pingera.ru -> Настройки -> Подписка и лимиты.

В документации мы добавили пример расчета потребления Кредитов.

Запускайте проверки из вашего мониторинга - новые on-demand проверки

Как это работает

API

Пример интеграции

Тарификация