Webhook уведомления

Интеграция Renta через вебхуки позволяет связать мониторинг ваших пайплайнов с внешними системами управления инцидентами, кастомными приложениями или платформами автоматизации, такими как Zapier, Pipedream или Make. С помощью вебхуков вы можете создавать сложные сценарии реагирования на любые события в вашем воркспейсе Renta.

Комбинированные уведомления: Renta позволяет назначать несколько каналов для одного правила. Вы можете одновременно отправлять алерты в Slack, Email и через Webhooks, обеспечивая максимальную надежность мониторинга.

Добавление эндпоинтов

Зарегистрируйте внешний URL для получения данных о событиях от Renta.

Перейдите в Notification channelsStep 1

Зайдите в раздел Alerts в боковом меню и выберите вкладку Notification channels.

Добавьте webhookStep 2

Прокрутите вниз до раздела Webhooks и нажмите кнопку Add webhook.

Настройте параметры эндпоинтаStep 3

Введите Display name (например, "Engineering On-call"), Endpoint URL (адрес, на который будут отправляться данные) и укажите данные для Authentication, если ваш сервер требует авторизации. Нажмите Add webhook для сохранения.

Проверьте статусStep 4

Новый вебхук появится в списке со статусом Active.

Совет: Используйте специализированные инструменты вроде Pipedream или Webhook.site, чтобы протестировать структуру JSON-нагрузки перед интеграцией с вашими боевыми системами.

Активация правил уведомлений

После регистрации эндпоинта его необходимо подписать на конкретные события.

Настройка правил

Определите, какие события должны триггерить отправку вебхука.

Перейдите к разделу AlertsStep 1

Откройте вкладку Alerts. Найдите правило Pipeline failed и переключите его в положение On.

Назначьте каналы вебхуковStep 2

В выпадающем списке Send to выберите созданные каналы вебхуков. Вы можете отправлять одно и то же событие сразу в несколько вебхуков и другие типы каналов.

Кейс использования: Вы можете автоматизировать создание тикетов, отправляя события Pipeline failed на вебхук, который создает задачу в Jira или инцидент в PagerDuty.

Дедупликация ошибок

Чтобы не перегружать ваши внешние системы однотипными запросами, Renta применяет дедупликацию. Для повторяющихся проблем уникальное событие отправляется один раз в 24 часа, если статус не изменится на Resolved.

Структура данных webhook

Когда происходит событие, Renta отправляет POST запрос на ваш настроенный эндпоинт с JSON нагрузкой. Структура данных зависит от типа события.

Событие IntegrationFaulted

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

{
  "event_type": "IntegrationFaulted",
  "error": "Connection timeout after 30 seconds",
  "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "run_id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "987fcdeb-51a2-43d7-9012-34567890abcd",
  "source_type": "facebook_ads",
  "destination_type": "bigquery",
  "integration_name": "Facebook Ads to BigQuery"
}

Название поля	Тип	Описание
event_type	String	Всегда `IntegrationFaulted` для этого события.
error	String	Читаемое сообщение об ошибке, описывающее проблему.
id	UUID	Уникальный идентификатор интеграции, которая завершилась с ошибкой.
run_id	UUID	Уникальный идентификатор запуска пайплайна.
workspace_id	UUID	Уникальный идентификатор воркспейса, в котором произошло событие.
source_type	String	Тип источника данных (например, `facebook_ads` или `google_ads`).
destination_type	String	Тип назначения (например, `bigquery` или `snowflake`).
integration_name	String	Отображаемое имя интеграции.

Событие SourceConnectionFailed

Это событие возникает, когда Renta не может установить соединение с источником данных.

{
  "event_type": "SourceConnectionFailed",
  "error": "Invalid API credentials",
  "source_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source_name": "LinkedIn Ads Production",
  "source_type": "linkedin_ads",
  "workspace_id": "987fcdeb-51a2-43d7-9012-34567890abcd"
}

Стандартные поля, общие для всех типов источников:

Название поля	Тип	Описание
event_type	String	Всегда `SourceConnectionFailed` для этого события.
error	String	Читаемое сообщение об ошибке, описывающее проблему подключения.
source_id	UUID	Уникальный идентификатор источника, который не смог подключиться.
source_name	String	Отображаемое имя источника.
source_type	String	Тип источника данных (например, `linkedin_ads` или `facebook_ads`).
workspace_id	UUID	Уникальный идентификатор воркспейса, в котором произошло событие.

Специфичные поля для Facebook Ads

Для источников типа facebook_ads нагрузка содержит следующие дополнительные поля:

Название поля	Тип	Описание
name	String	Имя аккаунта Facebook Ads.
email	String	Email адрес, связанный с аккаунтом Facebook Ads.

Лучшие практики

Используйте HTTPS. Всегда используйте защищенные эндпоинты HTTPS, чтобы гарантировать шифрование метаданных ваших пайплайнов при передаче.
Настройте Basic Auth. Для защиты эндпоинта от несанкционированных запросов настройте HTTP Basic Authentication в Renta и проверяйте учетные данные на вашем принимающем сервере.
Асинхронная обработка. Убедитесь, что ваш сервер быстро возвращает статус 200 OK и обрабатывает данные события в фоновом режиме, чтобы избежать таймаутов соединения.

Часто задаваемые вопросы

Ready to get started?

Build your data pipeline today or get a personalized demo. Start free!

Need help?

Get expert support to ensure your project succeeds. We're here to help!

Feature requests?

Help shape our product! Share your ideas for new features and integrations.