Быстрый старт сервиса «Event Bridge»

Перед началом работы

1. Зарегистрируйтесь в личном кабинете Cloud.ru.

   Если вы уже зарегистрированы, войдите под своей учетной записью.

2. Убедитесь, что вам назначена сервисная роль cbus.admin или роль администратора проекта. При необходимости настройте права или запросите их у администратора.

Создайте правило

1. В личном кабинете перейдите в раздел Мониторинг → Шина событий.

2. Перейдите на вкладку Правила и нажмите Создать правило.

3. Заполните информацию о правиле:

   1. Укажите название правила.

   2. Добавьте описание.

   3. Выберите событие из справочника. Для этого события будет создано новое правило.

4. Нажмите Сохранить.

5. (Опционально) Задайте фильтры — условия, которые проверяются внутри события:

   1. На форме редактирования правила перейдите на вкладку Фильтры и нажмите Добавить фильтр.

   2. Укажите JSON-путь к параметру, по которому будет происходить фильтрация.

   3. Выберите тип фильтра — оператор сравнения для фильтрации:

      Оператор сравнения	Описание
      =	Значение параметра равно указанному.
      !=	Значение параметра не равно указанному.
      in	Значение параметра должно совпадать с любым значением из списка.
      not in	Значение параметра не должно совпадать со значениями из списка.
      like	Значение параметра соответствует заданному шаблону.
      not like	Значение параметра не соответствует заданному шаблону.
      >	Значение параметра больше указанного.
      <	Значение параметра меньше указанного.
      key not exists	Параметр отсутствует.

   4. Укажите значение для фильтрации.

      Для операторов in и not in можно указать несколько значений. Для этого нажмите Добавить, укажите значение и нажмите .

   Пример фильтрации

6. Добавьте получателей:

   1. На форме редактирования правила перейдите на вкладку Получатели и нажмите Добавить получателя.

   2. Заполните информацию о получателях в зависимости от типа отправки события:

      ---

      Через HTTP

      Через gRPC

      Через Managed Kafka

      1. Укажите URL метода получателя.

      2. Выберите метод из списка.

      3. (Опционально) Активируйте политику повторного вызова — возможность повторной отправки события в случае неудачи.

         Задайте:

         • количество повторов;

         • интервал отправки события в секундах.

         Примеры настройки политики

      4. (Опционально) Настройте параметры аутентификации:

         1. Выберите метод аутентификации mTLS из списка.

         2. Выберите TLS-сертификат из списка созданных в Certificate Manager. Если подходящего сертификата нет, создайте его.

      5. (Опционально) Добавьте заголовки, которые будут отправляться вместе с запросом:

         1. Включите добавление заголовков HTTP-запроса.

         2. Укажите заголовки в формате JSON-строк, например:

            {
              "Content-Type":"application/payload",
              "X-Api-Key":"12345"
            }
            
            

      6. Настройте шаблон тела HTTP-запроса:

         1. Выберите шаблон:

            • без шаблона — чтобы отправлять данные события как есть;

            • текстовый — чтобы отправлять данные события в виде текста;

            • JSON — чтобы отправлять данные события в формате JSON.

         2. (Опционально) Дополните шаблон, если необходимо.

   3. Нажмите Сохранить.

7. Чтобы применить заданные настройки к правилу, нажмите Сохранить.

Что дальше

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

1. Посмотреть историю событий, которые прошли через созданное правило шины.

2. Проверить список недоставленных событий.