13 октября 2026
ID 331367
Коннектор, тип sftp
Коннекторы с типом sftp используются для получения данных по протоколу Secure File Transfer Protocol при работе с агентами Windows и Linux.
Коннектор sftp получает события из файлов на удаленном SFTP-сервере. Коннектор периодически просматривает указанные файлы по имени или маске и передает в нормализатор новые данные. Для работы коннектор требует SSH-соединения с SFTP-сервером.
Коннектор рассчитан на файлы журналов, строки в которые добавляются в конец файла. При очистке файла, уменьшении его размера или изменении файла без изменения его размера коннектор перечитает весь файл с начала и передаст события в нормализатор повторно.
Интервал опроса директории и чтения файлов: 2 секунды
Размер буфера: 1 МБ
Доступные параметры коннектора с типом sftp описаны в таблицах ниже.
Вкладка Основные параметры
Параметр | Описание |
|---|---|
Название | Уникальное имя ресурса. Максимальная длина имени составляет до 128 символов в кодировке Unicode. Обязательный параметр. |
Тенант | Название тенанта, которому принадлежит ресурс. Обязательный параметр. |
Тип | Тип коннектора – sftp. Обязательный параметр. |
Теги | Теги для поиска ресурса. Необязательный параметр. |
URL | URL-адрес файла журнала или маски файлов, начинающийся со схемы KUMA получает информацию только из файлов, хранящихся в последней директории, указанной в пути. Например, вы указываете следующий путь:
В таком случае KUMA получит информацию только из файлов из директории 2. Если в директории 2 хранятся вложенные директории, файлы из них прочитаны не будут. Если URL-адрес не содержит номер порта SFTP-сервера, автоматически указывается номер порта Обязательный параметр. |
Открытые ключи SSH-сервера | Открытые ключи, используемые для проверки подлинности SFTP-сервера при установке SSH-соединения. Вы можете указать несколько ключей разных типов, коннектор автоматически выберет подходящий ключ. Формат: < Пример ключа: ssh-ed25519 ABCD... На сервере открытые ключи лежат по следующему пути:
Вы также можете получить открытые ключи, выполнив команду:
Примеры команд:
Обязательный параметр. |
Секрет | Секрет, в котором хранятся учетные данные для подключения к SFTP-серверу. Поддерживаются секреты с типом credentials и ssh private key. Секрет должен содержать либо имя пользователя и пароль, либо имя пользователя и закрытый SSH-ключ. Если для подключения к SFTP-серверу учетные данные не требуются, при заполнении имени пользователя и пароля оставьте поля пустыми. Вы можете выбрать существующий секрет или создать новый секрет. Для создания секрета выберите значение Создать. Если вы хотите изменить параметры существующего секрета, нажмите рядом с ним на значок карандаша Обязательный параметр. |
Описание | Описание ресурса. Максимальная длина описания составляет до 4000 символов в кодировке Unicode. |
.Вкладка Дополнительные параметры
Параметр | Описание |
|---|---|
Отладка | Переключатель, включающий логирование ресурса. По умолчанию переключатель выключен. |
Кодировка символов | Кодировка файлов, полученных с SFTP-сервера. По умолчанию используется кодировка UTF-8. Необязательный параметр. |
