Содержание
Точки назначения
Точки назначения задают сетевые параметры для передачи нормализованных событий. Точки назначения используются в коллекторах и корреляторах для описания того, куда передавать обработанные события. В основном, в роли точек назначения выступают коррелятор и хранилище.
Параметры точек назначения указываются на двух вкладках: Основные параметры и Дополнительные параметры. Набор доступных параметров зависит от выбранного типа точки назначения:
- nats-jetstream – используется для коммуникации через NATS.
- tcp – используется для связи по протоколу TCP.
- http – используется для связи по протоколу HTTP.
- diode – используется для передачи событий с помощью диода данных.
- kafka – используется для коммуникаций с помощью kafka.
- file – используется для записи в файл.
- storage – используется для передачи данных в хранилище.
- correlator – используется для передачи данных в коррелятор.
Точка назначения, тип nats-jetstream
Тип nats-jetstream используется для коммуникации через NATS.
Вкладка Основные параметры
Параметр |
Описание |
---|---|
Название |
Обязательный параметр. Уникальное имя ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode. |
Тенант |
Обязательный параметр. Название тенанта, которому принадлежит ресурс. |
Переключатель Состояние |
Используется, если события нужно отправлять в точку назначения. По умолчанию отправка событий включена. |
Тип |
Обязательный параметр. Тип точки назначения, nats-jetstream. |
URL |
Обязательный параметр. URL, с которым необходимо установить связь. |
Топик |
Обязательный параметр. Тема сообщений NATS. Должно содержать символы в кодировке Unicode. |
Разделитель |
Используется для указания символа, определяющего границу между событиями. По умолчанию используется |
Авторизация |
Тип авторизации при подключении к указанному URL Доступны следующие значения:
|
Описание |
Описание ресурса: до 4000 символов в кодировке Unicode. |
Вкладка Дополнительные параметры
Параметр |
Описание |
---|---|
Сжатие |
Можно использовать сжатие Snappy. По умолчанию сжатие Выключено. |
Размер буфера |
Используется для установки размера буфера. Значение по умолчанию: 1 КБ; максимальное: 64 МБ. |
Размер дискового буфера |
Размер дискового буфера в байтах. Значение по умолчанию: 10 ГБ. |
Идентификатор кластера |
Идентификатор кластера NATS. |
Выходной формат |
Формат отправки событий во внешний источник. Доступные значения:
|
Режим TLS |
Использование шифрования TLS. Доступные значения:
Создание сертификата, подписанного центром сертификации При использовании TLS невозможно указать IP-адрес в качестве URL. |
Разделитель |
В раскрывающемся списке можно выбрать символ, который будет определять границу между событиями. По умолчанию используется |
Интервал очистки буфера |
Время (в секундах) между отправкой данных в точку назначения. Значение по умолчанию: |
Количество обработчиков |
Поле используется для установки количества служб, обрабатывающих очередь. Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA. |
Отладка |
Переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. Значение по умолчанию: Выключено. |
Дисковый буфер |
Раскрывающийся список, с помощью которого можно включить или выключить использование дискового буфера. По умолчанию дисковый буфер включен. Дисковый буфер используется, если коллектор не может направить в точку назначения нормализованные события. Объём выделенного дискового пространства ограничен значением параметра Размер дискового буфера. Если выделенное под дисковый буфер дисковое пространство исчерпано, события ротируются по следующему принципу: новые события замещают самые старые события, записанные в буфер. |
Фильтр |
В разделе Фильтр можно задать условия определения событий, которые будут обрабатываться ресурсом. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр. |
Тип tcp
Тип tcp используется для связи по протоколу TCP.
Вкладка Основные параметры
Параметр |
Описание |
---|---|
Название |
Обязательный параметр. Уникальное имя ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode. |
Тенант |
Обязательный параметр. Название тенанта, которому принадлежит ресурс. |
Переключатель Состояние |
Используется, если события нужно отправлять в точку назначения. По умолчанию отправка событий включена. |
Тип |
Обязательный параметр. Тип точки назначения, tcp. |
URL |
Обязательный параметр. URL, с которым необходимо установить связь. Доступные форматы: Также поддерживаются адреса IPv6. При их использовании необходимо также указывать интерфейс в формате Например: |
Описание |
Описание ресурса: до 4000 символов в кодировке Unicode. |
Вкладка Дополнительные параметры
Параметр |
Описание |
---|---|
Сжатие |
Можно использовать сжатие Snappy. По умолчанию сжатие Выключено. |
Размер буфера |
Используется для установки размера буфера. Значение по умолчанию: 1 КБ; максимальное: 64 МБ. |
Время ожидания |
Время ожидания ответа (в секундах) другого сервиса или компонента. Значение по умолчанию: |
Размер дискового буфера |
Размер дискового буфера в байтах. Значение по умолчанию: 10 ГБ. |
Выходной формат |
Формат отправки событий во внешний источник. Доступные значения:
|
Режим TLS |
Использование шифрования TLS с использованием сертификатов в формате pem x509. Доступные значения:
При использовании TLS невозможно указать IP-адрес в качестве URL. |
Политика выбора URL |
В раскрывающемся списке можно выбрать способ определения, на какой URL следует отправлять события, если URL было указано несколько. Доступные значения:
|
Разделитель |
В раскрывающемся списке можно выбрать символ, который будет определять границу между событиями. По умолчанию используется |
Интервал очистки буфера |
Время (в секундах) между отправкой данных в точку назначения. Значение по умолчанию: |
Количество обработчиков |
Поле используется для установки количества служб, обрабатывающих очередь. Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA. |
Отладка |
Переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. Значение по умолчанию: Выключено. |
Дисковый буфер |
Раскрывающийся список, в котором можно включить или выключить использование дискового буфера. По умолчанию дисковый буфер включен. Дисковый буфер используется, если коллектор не может направить в точку назначения нормализованные события. Объём выделенного дискового пространства ограничен значением параметра Размер дискового буфера. Если выделенное под дисковый буфер дисковое пространство исчерпано, события ротируются по следующему принципу: новые события замещают самые старые события, записанные в буфер. |
Фильтр |
В разделе можно задать условия определения событий, которые будут обрабатываться ресурсом. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр. |
Тип http
Тип http используется для связи по протоколу HTTP.
Вкладка Основные параметры
Параметр |
Описание |
---|---|
Название |
Обязательный параметр. Уникальное имя ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode. |
Тенант |
Обязательный параметр. Название тенанта, которому принадлежит ресурс. |
Переключатель Состояние |
Используется, если события нужно отправлять в точку назначения. По умолчанию отправка событий включена. |
Тип |
Обязательный параметр. Тип точки назначения, http. |
URL |
Обязательный параметр. URL, с которым необходимо установить связь. Доступные форматы: Также поддерживаются адреса IPv6, однако при их использовании необходимо также указывать интерфейс: |
Авторизация |
Тип авторизации при подключении к указанному URL Доступны следующие значения:
|
Описание |
Описание ресурса: до 4000 символов в кодировке Unicode. |
Вкладка Дополнительные параметры
Параметр |
Описание |
---|---|
Сжатие |
Можно использовать сжатие Snappy. По умолчанию сжатие Выключено. |
Размер буфера |
Используется для установки размера буфера. Значение по умолчанию: 1 КБ; максимальное: 64 МБ. |
Время ожидания |
Время ожидания (в секундах) ответа другого сервиса или компонента. Значение по умолчанию: |
Размер дискового буфера |
Размер дискового буфера в байтах. Значение по умолчанию: 10 ГБ. |
Выходной формат |
Формат отправки событий во внешний источник. Доступные значения:
|
Режим TLS |
Использование шифрования TLS. Доступные значения:
Создание сертификата, подписанного центром сертификации При использовании TLS невозможно указать IP-адрес в качестве URL. |
Политика выбора URL |
В раскрывающемся списке можно выбрать способ определения, на какой URL следует отправлять события, если URL было указано несколько. Доступные значения:
|
Разделитель |
В раскрывающемся списке можно выбрать символ, который будет определять границу между событиями. По умолчанию используется \n. |
Путь |
Путь, который необходимо добавить для URL-запроса. Например, если указать путь |
Интервал очистки буфера |
Время (в секундах) между отправкой данных в точку назначения. Значение по умолчанию: |
Количество обработчиков |
Количество служб, обрабатывающих очередь. Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA. |
Путь проверки работоспособности |
URL для отправки запросов для получения данных о работоспособности системы, с которой устанавливает связь ресурс точки назначения. |
Ожидание проверки работоспособности |
Частота проверки работоспособности в секундах. |
Путь проверки работоспособности |
URL для отправки запросов на получение данных о работоспособности системы, с которой устанавливает связь ресурс точки назначения. |
Проверка работоспособности |
Переключатель проверки работоспособности. |
Отладка |
Переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. Значение по умолчанию: Выключено. |
Дисковый буфер |
Раскрывающийся список, в котором можно включить или выключить использование дискового буфера. По умолчанию дисковый буфер включен. Дисковый буфер используется, если коллектор не может направить в точку назначения нормализованные события. Объём выделенного дискового пространства ограничен значением параметра Размер дискового буфера. Если выделенное под дисковый буфер дисковое пространство исчерпано, события ротируются по следующему принципу: новые события замещают самые старые события, записанные в буфер. |
Фильтр |
В разделе Фильтр можно задать условия определения событий, которые будут обрабатываться ресурсом. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр. |
Тип diode
Тип diode используется для передачи событий с помощью диода данных.
Вкладка Основные параметры
Параметр |
Описание |
---|---|
Название |
Обязательный параметр. Уникальное имя ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode. |
Тенант |
Обязательный параметр. Название тенанта, которому принадлежит ресурс. |
Переключатель Состояние |
Используется, если события нужно отправлять в точку назначения. По умолчанию отправка событий включена. |
Тип |
Обязательный параметр. Тип точки назначения, diode. |
Директория, из которой диод данных получает события |
Обязательный параметр. Директория, откуда диод данных перемещает события. Путь может содержать до 255 символов в кодировке Unicode. Ограничения при использовании префиксов к путям на серверах Windows Ограничения при использовании префиксов к путям на серверах Linux |
Временная директория |
Директория, в которой события готовятся для передачи диоду данных. События собираются в файл по истечении времени ожидания (по умолчанию 10 секунд) или при переполнении буфера. Подготовленный файл перемещается в директорию, указанную в поле Директория, из которой диод данных получает события. В качестве названия файла с событиями используется хеш-сумма (SHA-256) содержимого файла. Временная директория не должна совпадать с директорией, из которой диод данных получает события. |
Описание |
Описание ресурса: до 4000 символов в кодировке Unicode. |
Вкладка Дополнительные параметры
Параметр |
Описание |
---|---|
Сжатие |
Можно использовать сжатие Snappy. По умолчанию сжатие Выключено. Этот параметр должен совпадать для коннектора и точки назначения, используемых для передачи событий из изолированного сегмента сети с помощью диода данных. |
Размер буфера |
Используется для установки размера буфера. Значение по умолчанию: 1 КБ; максимальное: 64 МБ. |
Разделитель |
В раскрывающемся списке можно выбрать символ, который будет определять границу между событиями. По умолчанию используется Этот параметр должен совпадать для коннектора и точки назначения, используемых для передачи событий из изолированного сегмента сети с помощью диода данных. |
Интервал очистки буфера |
Время (в секундах) между отправкой данных в точку назначения. Значение по умолчанию: |
Количество обработчиков |
Поле используется для установки количества служб, обрабатывающих очередь. Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA. |
Отладка |
Переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. Значение по умолчанию: Выключено. |
Фильтр |
В разделе Фильтр можно задать условия определения событий, которые будут обрабатываться ресурсом. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр. |
Тип kafka
Тип kafka используется для коммуникаций с помощью kafka.
Вкладка Основные параметры
Параметр |
Описание |
---|---|
Название |
Обязательный параметр. Уникальное имя ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode. |
Тенант |
Обязательный параметр. Название тенанта, которому принадлежит ресурс. |
Переключатель Состояние |
Используется, если события нужно отправлять в точку назначения. По умолчанию отправка событий включена. |
Тип |
Обязательный параметр. Тип точки назначения, kafka. |
URL |
Обязательный параметр. URL, с которым необходимо установить связь. Доступные форматы: С помощью кнопки URL можно добавить несколько адресов. |
Топик |
Обязательный параметр. Тема сообщений Kafka. Должен содержать от 1 до 255 следующих символов: a–z, A–Z, 0–9, ".", "_", "-". |
Разделитель |
Используется для указания символа, определяющего границу между событиями. По умолчанию используется |
Авторизация |
Тип авторизации при подключении к указанному URL Доступны следующие значения:
|
Описание |
Описание ресурса: до 4000 символов в кодировке Unicode. |
Вкладка Дополнительные параметры
Параметр |
Описание |
---|---|
Размер буфера |
Используется для установки размера буфера. Значение по умолчанию: 1 КБ; максимальное: 64 МБ. |
Время ожидания |
Время ожидания (в секундах) ответа другого сервиса или компонента. Значение по умолчанию: |
Размер дискового буфера |
Размер дискового буфера в байтах. Значение по умолчанию: 10 ГБ. |
Выходной формат |
Формат отправки событий во внешний источник. Доступные значения:
|
Режим TLS |
Использование шифрования TLS. Доступные значения:
Создание сертификата, подписанного центром сертификации При использовании TLS невозможно указать IP-адрес в качестве URL. |
Разделитель |
В раскрывающемся списке можно выбрать символ, который будет определять границу между событиями. По умолчанию используется |
Интервал очистки буфера |
Время (в секундах) между отправкой данных в точку назначения. Значение по умолчанию: |
Количество обработчиков |
Поле используется для установки количества служб, обрабатывающих очередь. Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA. |
Отладка |
Переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. Значение по умолчанию: Выключено. |
Дисковый буфер |
Раскрывающийся список, с помощью которого можно включить или выключить использование дискового буфера. По умолчанию дисковый буфер включен. Дисковый буфер используется, если коллектор не может направить в точку назначения нормализованные события. Объём выделенного дискового пространства ограничен значением параметра Размер дискового буфера. Если выделенное под дисковый буфер дисковое пространство исчерпано, события ротируются по следующему принципу: новые события замещают самые старые события, записанные в буфер. |
Фильтр |
В разделе можно задать условия определения событий, которые будут обрабатываться ресурсом. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр. |
Тип file
Тип file используется для записи в файл.
При удалении точки назначения типа file, используемой в каком-либо сервисе, этот сервис необходимо перезапустить.
Вкладка Основные параметры
Параметр |
Описание |
---|---|
Название |
Обязательный параметр. Уникальное имя ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode. |
Тенант |
Обязательный параметр. Название тенанта, которому принадлежит ресурс. |
Переключатель Состояние |
Используется, если события нужно отправлять в точку назначения. По умолчанию отправка событий включена. |
Тип |
Обязательный параметр. Тип точки назначения, file. |
URL |
Обязательный параметр. Путь к файлу, в который необходимо записать события. |
Описание |
Описание ресурса: до 4000 символов в кодировке Unicode. |
Вкладка Дополнительные параметры
Параметр |
Описание |
---|---|
Размер буфера |
Используется для установки размера буфера. Значение по умолчанию: 1 КБ; максимальное: 64 МБ. |
Размер дискового буфера |
Размер дискового буфера в байтах. Значение по умолчанию: 10 ГБ. |
Разделитель |
В раскрывающемся списке можно выбрать символ, который будет определять границу между событиями. По умолчанию используется \n. |
Интервал очистки буфера |
Время (в секундах) между отправкой данных в точку назначения. Значение по умолчанию: |
Количество обработчиков |
Поле используется для установки количества служб, обрабатывающих очередь. Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA. |
Выходной формат |
Формат отправки событий во внешний источник. Доступные значения:
|
Отладка |
Переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. Значение по умолчанию: Выключено. |
Дисковый буфер |
Раскрывающийся список, с помощью которого можно включить или выключить использование дискового буфера. По умолчанию дисковый буфер включен. Дисковый буфер используется, если коллектор не может направить в точку назначения нормализованные события. Объём выделенного дискового пространства ограничен значением параметра Размер дискового буфера. Если выделенное под дисковый буфер дисковое пространство исчерпано, события ротируются по следующему принципу: новые события замещают самые старые события, записанные в буфер. |
Фильтр |
В разделе Фильтр можно задать условия определения событий, которые будут обрабатываться ресурсом. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр. |
Тип storage
Тип storage используется для передачи данных в хранилище.
Вкладка Основные параметры
Параметр |
Описание |
---|---|
Название |
Обязательный параметр. Уникальное имя ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode. |
Тенант |
Обязательный параметр. Название тенанта, которому принадлежит ресурс. |
Переключатель Состояние |
Используется, если события нужно отправлять в точку назначения. По умолчанию отправка событий включена. |
Тип |
Обязательный параметр. Тип точки назначения, storage. |
URL |
Обязательный параметр. URL, с которым необходимо установить связь. Доступные форматы: С помощью кнопки URL можно добавить несколько адресов. В поле URL поддерживается поиск сервисов по FQDN, IP-адресу и названию. Особенности поиска по указанным в поле значениям:
|
Описание |
Описание ресурса: до 4000 символов в кодировке Unicode. |
Вкладка Дополнительные параметры
Параметр |
Описание |
---|---|
Прокси-сервер |
Раскрывающийся список для выбора прокси-сервера. |
Размер буфера |
Используется для установки размера буфера. Значение по умолчанию: 1 КБ; максимальное: 64 МБ. |
Размер дискового буфера |
Размер дискового буфера в байтах. Значение по умолчанию: 10 ГБ. |
Политика выбора URL |
Раскрывающийся список, в котором можно выбрать способ определения, на какой URL следует отправлять события, если URL было указано несколько:
|
Интервал очистки буфера |
Время (в секундах) между отправкой данных в точку назначения. Значение по умолчанию: |
Количество обработчиков |
Поле используется для установки количества служб, обрабатывающих очередь. Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA. |
Ожидание проверки работоспособности |
Частота проверки работоспособности в секундах. |
Отладка |
Переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. Значение по умолчанию: Выключено. |
Дисковый буфер |
Раскрывающийся список, с помощью которого можно включить или выключить использование дискового буфера. По умолчанию дисковый буфер включен. Дисковый буфер используется, если коллектор не может направить в точку назначения нормализованные события. Объём выделенного дискового пространства ограничен значением параметра Размер дискового буфера. Если выделенное под дисковый буфер дисковое пространство исчерпано, события ротируются по следующему принципу: новые события замещают самые старые события, записанные в буфер. |
Фильтр |
В разделе можно задать условия определения событий, которые будут обрабатываться ресурсом. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр. |
Тип correlator
Тип correlator используется для передачи данных в коррелятор.
Вкладка Основные параметры
Параметр |
Описание |
---|---|
Название |
Обязательный параметр. Уникальное имя ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode. |
Тенант |
Обязательный параметр. Название тенанта, которому принадлежит ресурс. |
Переключатель Состояние |
Используется, если события нужно отправлять в точку назначения. По умолчанию отправка событий включена. |
Тип |
Обязательный параметр. Тип точки назначения, correlator. |
URL |
Обязательный параметр. URL, с которым необходимо установить связь. Доступные форматы: С помощью кнопки URL можно добавить несколько адресов. В поле URL поддерживается поиск сервисов по FQDN, IP-адресу и названию. Особенности поиска по указанным в поле значениям:
|
Описание |
Описание ресурса: до 4000 символов в кодировке Unicode. |
Вкладка Дополнительные параметры
Параметр |
Описание |
---|---|
Прокси-сервер |
Раскрывающийся список для выбора прокси-сервера. |
Размер буфера |
Используется для установки размера буфера. Значение по умолчанию: 1 КБ; максимальное: 64 МБ. |
Размер дискового буфера |
Размер дискового буфера в байтах. Значение по умолчанию: 10 ГБ. |
Политика выбора URL |
Раскрывающийся список, в котором можно выбрать способ определения, на какой URL следует отправлять события, если URL было указано несколько:
|
Интервал очистки буфера |
Время (в секундах) между отправкой данных в точку назначения. Значение по умолчанию: |
Количество обработчиков |
Поле используется для установки количества служб, обрабатывающих очередь. Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA. |
Ожидание проверки работоспособности |
Частота проверки работоспособности в секундах. |
Отладка |
Переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. Значение по умолчанию: Выключено. |
Дисковый буфер |
Раскрывающийся список, с помощью которого можно включить или выключить использование дискового буфера. По умолчанию дисковый буфер включен. Дисковый буфер используется, если коллектор не может направить в точку назначения нормализованные события. Объём выделенного дискового пространства ограничен значением параметра Размер дискового буфера. Если выделенное под дисковый буфер дисковое пространство исчерпано, события ротируются по следующему принципу: новые события замещают самые старые события, записанные в буфер. |
Фильтр |
В разделе Фильтр можно задать условия определения событий, которые будут обрабатываться ресурсом. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр. |
Предустановленные точки назначения
В поставку KUMA включены перечисленные в таблице ниже точки назначения.
Предустановленные точки назначения
Название точки назначения |
Описание |
[OOTB] Correlator |
Отправляет события в коррелятор. |
[OOTB] Storage |
Отправляет события в хранилище. |