Описание параметров сервисов#

Настройки сервиса Configurator#

Данный раздел описывает параметры сервиса Configurator

Сервис Configurator настраивается только с помощью его локального конфигурационного файла './example-docker/luna_configurator/configs/'.

Группа параметров LUNA_CONFIGURATOR_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Configurator.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_configurator.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_configurator?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_configurator" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_configurator"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_CONFIGURATOR_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_CONFIGURATOR_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

Настройки сервиса API#

Данный раздел описывает параметры сервиса API.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса API к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_api/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_api/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_API_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_FACES_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Faces.

origin#

Параметр задает протокол, IP адрес и порт сервиса Faces.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Faces, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Faces.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5030.

api_version#

Параметр задает версию API сервиса Faces. Доступная версия API — "3".

Формат задания настройки — integer.

Значение по умолчанию — 3.

Группа параметров LUNA_FACES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Faces.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Faces. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_VIDEO_AGENT_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Video Agent.

origin#

Параметр задает протокол, IP адрес и порт сервиса Video Agent.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Video Agent, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Video Agent.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5240.

api_version#

Параметр задает версию API сервиса Video Agent. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_VIDEO_AGENT_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Video Agent.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Video Agent. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО лиц.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-samples.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему БО лиц.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему БО лиц. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО тел.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-bodies-samples.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему БО тел.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему БО тел. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_IMAGES_ADDRESS#

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

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-image-origin.

Группа параметров LUNA_IMAGE_STORE_IMAGES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему исходных изображений.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему исходных изображений. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_OBJECTS_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения объектов.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-objects.

Группа параметров LUNA_IMAGE_STORE_OBJECTS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему объектов.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему объектов. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_SENDER_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Sender.

origin#

Параметр задает протокол, IP адрес и порт сервиса Sender.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Sender, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Sender.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5080.

api_version#

См. подробную информацию в разделе "Отключаемые сервисы".

В руководстве по установке приведен раздел "Использование необязательных сервисов", описывающий настройку использования необязательных сервисов перед запуском LUNA PLATFORM.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

Группа параметров LUNA_EVENTS_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Events.

origin#

Параметр задает протокол, IP адрес и порт сервиса Events.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Events, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Events.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5040.

api_version#

Параметр задает версию API сервиса Events. Доступная версия API — "2".

Формат задания настройки — integer.

Значение по умолчанию — 2.

Группа параметров LUNA_EVENTS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Events.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Events. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_HANDLERS_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Handlers.

origin#

Параметр задает протокол, IP адрес и порт сервиса Handlers.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Handlers, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Handlers.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5090.

api_version#

Параметр задает версию API сервиса Handlers. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_HANDLERS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Handlers.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Handlers. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_PYTHON_MATCHER_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Python Matcher.

origin#

Параметр задает протокол, IP адрес и порт сервиса Python Matcher.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Python Matcher, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Python Matcher.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5100.

api_version#

Параметр задает версию API сервиса Python Matcher. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_PYTHON_MATCHER_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Python Matcher.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Python Matcher. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_MATCHER_PROXY_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Python Matcher Proxy.

origin#

Параметр задает протокол, IP адрес и порт сервиса Python Matcher Proxy.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Python Matcher Proxy, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Python Matcher Proxy.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5110.

api_version#

Параметр задает версию API сервиса Python Matcher Proxy. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_PYTHON_MATCHER_PROXY_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Python Matcher Proxy.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Python Matcher Proxy. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_TASKS_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Tasks.

origin#

Параметр задает протокол, IP адрес и порт сервиса Tasks.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Tasks, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Tasks.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5050.

api_version#

Параметр задает версию API сервиса Tasks. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_TASKS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Tasks.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Tasks. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_LICENSES_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Licenses.

origin#

Параметр задает протокол, IP адрес и порт сервиса Licenses.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Licenses, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Licenses.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5120.

api_version#

Параметр задает версию API сервиса Licenses. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_ACCOUNTS_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Accounts.

origin#

Параметр задает протокол, IP адрес и порт сервиса Accounts.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Accounts, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Accounts.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5170.

api_version#

Параметр задает версию API сервиса Accounts. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_ACCOUNTS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Accounts.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Accounts. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_REMOTE_SDK_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Remote SDK.

origin#

Параметр задает протокол, IP адрес и порт сервиса Remote SDK.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Remote SDK, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Remote SDK.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5220.

api_version#

Параметр задает версию API сервиса Remote SDK. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_REMOTE_SDK_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Remote SDK.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Remote SDK. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_LAMBDA_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Lambda.

origin#

Параметр задает протокол, IP адрес и порт сервиса Lambda.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Lambda, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Lambda.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5210.

api_version#

Параметр задает версию API сервиса Lambda. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_LAMBDA_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Lambda.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Lambda. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров EXTERNAL_LUNA_API_ADDRESS#

Данная группа параметров задает адрес сервиса API, который будет отображаться в параметре "external_url" в теле ответа на создание различных объектов. В результате можно будет получить абсолютную ссылку до созданного объекта.

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

{
    "list_id": "3b94d026-2434-4a52-b1e7-da4a97fc0398",
    "url": "/6/lists/3b94d026-2434-4a52-b1e7-da4a97fc0398",
    "external_url": "http://127.0.0.1:5000/6/lists/3b94d026-2434-4a52-b1e7-da4a97fc0398"
}

Здесь:

"url" — относительная ссылка до списка
"external_url" — абсолютная ссылка до списка, состоящая из параметров "origin", "api_version" и "url"

Это позволяет использовать ссылки из ответов сервиса API в своих целях, не зная точного адреса сервиса. Также это позволяет передавать ссылки в удобном формате, по которому можно сразу получить их содержимое.

origin#

Параметр задает протокол, IP адрес и порт сервиса API, отображаемый в параметре "external_url" в теле ответа на создание различных объектов.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5000.

api_version#

Параметр задает версию API сервиса API, отображаемую в параметре "external_url" в теле ответа на создание различных объектов.

Формат задания настройки — integer.

Значение по умолчанию — 6.

Группа параметров LUNA_API_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

luna_api_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

luna_api_plugins_settings#

Параметр задает настройки для плагинов.

На данный момент доступны настройки только для плагина "luna-streams.py". См. подробную информацию в разделе "Проксирование запросов в LUNA Streams через LUNA API" руководства администратора FaceStream.

Важно! Плагины должны быть включены в настройке "luna_api_active_plugins".

Формат задания настройки — object.

Значение по умолчанию не задано.

Настройки плагина luna-streams

Для плагина "luna-streams.py" доступны следующие настройки:

"luna-streams-address" > "origin" — протокол, IP адрес и порт сервиса LUNA Streams
"luna-streams-address" > "api_version" — версия API сервиса LUNA Streams
"luna-streams-timeouts" > "connect" — таймаут для установки соединения при отправке HTTP-запроса к сервису LUNA Streams
"luna-streams-timeouts" > "request" — общий таймаут для выполнения всего HTTP-запроса
"luna-streams-timeouts" > "sock_connect" — таймаут для установки соединения на уровне сокетов
"luna-streams-timeouts" > "sock_read" — таймаут на чтение данных с сокета после успешного соединения

Пример задания настройки "luna_api_plugins_settings" для плагина "luna-streams.py":

{
    "luna-streams": {
        "luna-streams-address": {
            "origin": "http://127.0.0.1:5160/1",
            "api_version": 1
        },
        "luna-streams-timeouts": {
            "request": 60,
            "connect": 20,
            "sock_connect": 10,
            "sock_read": 60
        }
    }
}

Если настройка "luna_api_plugins_settings" не задана или не заданы какие-то из вышеописанных настроек для плагина, будут применены значения по умолчанию. Значения по умолчанию указаны в примере выше.

allow_luna_account_auth_header#

Параметр включает возможность авторизации по заголовку "Luna-Account-Id" (LunaAccountIdAuth), в котором указывается сгенерированный после создания аккаунта "account_id".

Такая авторизация была принята за основу до версии 5.30.0 и считается устаревшей.

В спецификации OpenAPI заголовок "Luna-Account-Id" помечен словом Deprecated.

См. подробную информацию об авторизации в разделе "Аккаунты, токены и способы авторизации".

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 0.

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

default_face_descriptor_version#

Параметр задает используемую версию биометрического шаблона лица.

Формат задания настройки — string.

Значение по умолчанию — 59.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

Настройки сервиса Admin#

Данный раздел описывает параметры сервиса Admin.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Admin к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_admin/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_admin/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_ADMIN_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_VIDEO_AGENT_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Video Agent.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Video Agent. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО лиц.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-samples.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО тел.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-bodies-samples.

Группа параметров LUNA_IMAGE_STORE_IMAGES_ADDRESS#

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

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-image-origin.

Группа параметров LUNA_IMAGE_STORE_TASK_RESULT_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения результатов задач.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

api_version#

Параметр задает версию API сервиса Lambda. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_ADMIN_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Admin.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Admin. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

См. подробную информацию в разделе "Отключаемые сервисы".

В руководстве по установке приведен раздел "Использование необязательных сервисов", описывающий настройку использования необязательных сервисов перед запуском LUNA PLATFORM.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_video_agent#

Параметр задает возможность использования сервиса Video Agent.

Включение/отключение данного сервиса может повлиять на работу других сервисов.

См. подробную информацию в разделе "Отключаемые сервисы".

В руководстве по установке приведен раздел "Использование необязательных сервисов", описывающий настройку использования необязательных сервисов перед запуском LUNA PLATFORM.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

Группа параметров LUNA_ADMIN_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

luna_admin_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Настройки сервиса Faces#

Данный раздел описывает параметры сервиса Faces.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Faces к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_faces/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_faces/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_FACES_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Faces.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_faces.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_faces?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_faces" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_faces"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_ATTRIBUTES_DB#

user#

Параметр задает имя пользователя БД Redis.

Формат задания настройки — string.

Значение по умолчанию не задано.

password#

Параметр задает пароль БД Redis.

Формат задания настройки — string.

Значение по умолчанию не указывается.

host#

Параметр задает IP-адрес БД Redis.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает номер порта, на котором Redis ожидает входящие сетевые соединения и прослушивает их для выполнения команд от клиентов.

Формат задания настройки — integer.

Значение по умолчанию — 6379.

sentinel > master_name#

Параметр задает имя мастера базы данных Redis, который контролируется и управляется системой Sentinel.

Формат задания настройки — string.

Значение по умолчанию — luna_attributes.

sentinel > sentinels#

Параметр задает список адресов и портов серверов Sentinel, которые будут использоваться клиентами для обнаружения и мониторинга БД Redis.

Формат задания настройки — list > string.

Значение по умолчанию — [].

sentinel > user#

Параметр задает имя пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

sentinel > password#

Параметр задает пароль пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

Группа параметров ATTRIBUTES_STORAGE_POLICY#

В данной группе параметров задаются настройки для сервиса Faces, связанные с хранением временных атрибутов.

default_ttl#

Параметр задает время существования временных атрибутов по умолчанию.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 300.

max_ttl#

Параметр задает максимальное время существования временных атрибутов.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 86400.

Группа параметров LUNA_LICENSES_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Licenses.

origin#

Параметр задает протокол, IP адрес и порт сервиса Licenses.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Licenses, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Licenses.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5120.

api_version#

Параметр задает версию API сервиса Licenses. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_FACES_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_FACES_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Группа параметров DESCRIPTOR_ENCRYPTION#

Данная группа параметров задает настройки шифрования биометрических шаблонов для повышения безопасности и предотвращения несанкционированного использования.

См. подробную информацию в разделе "Шифрование биометрических шаблонов".

enabled#

Параметр включает шифрование биометрических шаблонов.

Формат задания настройки — boolean.

Значение по умолчанию — false.

algorithm#

Параметр задает название используемого алгоритма шифрования.

Формат задания настройки — string.

Значение по умолчанию — aes256-gcm.

params > source#

Параметр задает название источника ключа шифрования. Поддерживаются два типа источников: raw и vaultKV.

Формат задания настройки — string.

Значение по умолчанию — raw.

params > key#

Параметр задает ключ шифрования или учетные данные для его получения из указанного источника.

Формат задания настройки — string.

Значение по умолчанию не задано.

Прочие#

database_number#

Параметр задает номер базы данных Faces в контексте настройки репликации.

Репликация базы данных — это процесс создания и поддержания копий данных из одной базы данных в другой.

Значение "0" означает, что текущая база данных Faces не участвует в репликации. Иными словами, она не является источником данных для какой-либо другой базы данных, и данные в ней не реплицируются на другие базы данных.

См. подробную информацию о репликации данных в разделе "Replication" руководства разработчика сервиса Faces.

Формат задания настройки — integer ("0", "1" или "2").

Значение по умолчанию — 0.

default_face_descriptor_version#

Параметр задает используемую версию биометрического шаблона лица.

Формат задания настройки — string.

Значение по умолчанию — 59.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

use_material_views#

Параметр позволяет использовать материализованные представления, что позволяет ускорить запрос к ресурсу "/lists/linkkeys" сервиса Faces.

Материализованные представления — это объекты в базе данных, которые содержат результаты выполнения запроса к одной или нескольким таблицам. В отличие от обычных (виртуальных) представлений, материализованные представления хранят данные фактически в таблице, что позволяет ускорить выполнение запросов, особенно при сложных агрегирующих или вычислительных операциях.

См. принцип использования данного параметра в разделе "Materialized" руководства разработчика сервиса Faces.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 0.

luna_faces_db_ping_max_count#

Параметр задает максимальное количество проверок соединения с базой данных для каждого запроса.

Если БД недоступна, то возвращается ошибка. Если выставлено значение <= 0, то проверки не выполняются.

Формат задания настройки — integer.

Значение по умолчанию — 0.

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

luna_faces_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Настройки сервиса Image Store#

Данный раздел описывает параметры сервиса Image Store.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Image Store к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_image_store/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_image_store/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_IMAGE_STORE_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_IMAGE_STORE_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

S3#

Данная группа параметров содержит параметры для взаимодействия с S3-хранилищем.

Для использования данных параметров требуется включить использование S3-хранилища в параметре "storage_type".

Для использования S3 нужно обязательно указать следующие параметры:

host#

Параметр задает URL-адрес, по которому будет установлено соединение с S3-хранилищем.

Формат задания настройки — string.

Значение по умолчанию — http://localhost:7480.

region#

Параметр задает регион, который будет использоваться при взаимодействии с S3-хранилищем.

Регион может влиять на доступность и производительность различных ресурсов в AWS S3.

Формат задания настройки — string.

Значение по умолчанию не указано.

aws_public_access_key#

Параметр задает публичный ключ доступа, который используется для аутентификации при доступе к S3-хранилищу. Этот ключ предоставляется AWS и используется для идентификации клиента.

Формат задания настройки — string.

Значение по умолчанию не указано.

aws_secret_access_key#

Параметр задает секретный ключа доступа, который совместно с публичным ключом обеспечивает аутентификацию при доступе к S3-хранилищу.

Формат задания настройки — string.

Значение по умолчанию не указано.

authorization_signature#

Параметр определяет метод, используемый для создания подписи аутентификации при выполнении операций с S3.

Можно указать два значения:

"s3v4" — использование алгоритма подписи AWS S3 Version 4
"s3v2" — использование алгоритма подписи AWS S3 Version 2

Формат задания настройки — string.

Значение по умолчанию — s3v4.

request_timeout#

Параметр задает максимальное время, в течение которого запрос к S3-хранилищу должен быть выполнен. Если запрос не завершится в пределах этого времени, он будет отменен.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

connect_timeout#

Параметр задает максимальное время ожидания для установления соединения с S3-хранилищем. Если соединение не устанавливается в пределах этого времени, то оно будет считаться неудачным.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

verify_ssl#

Параметр определяет, следует ли выполнять проверку SSL-сертификата при установлении защищенного (HTTPS) соединения с S3-хранилищем. Если значение равно true, то SSL-сертификат будет проверен. Если значение равно false, то проверка будет отключена, что может вести к проблемам с безопасностью.

Формат задания настройки — boolean.

Значение по умолчанию — true.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

storage_type#

Параметр задает тип хранилища Image Store. Доступно два типа:

"S3" — использование облачного хранилища S3
"LOCAL" — использование локального хранилища (SSD или HDD)

При использовании S3 необходимо дополнительно задать настройки из группы параметров "S3".

При использовании локального хранилища необходимо дополнительно путь до директории с изображениями в настройке "local_storage".

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

local_storage#

Параметр задает путь и имя директории для хранения изображений. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить использование локального хранилище в параметре "storage_type".

Формат задания настройки — string.

Значение по умолчанию — ./local_storage.

default_image_extension#

Параметр задает формат изображения биометрического образца, получаемого после нормализации исходного изображения. Доступно два значения:

"jpg" — сохранять биометрический образец в формате JPG
"png" — сохранять биометрический образец в формате PNG

Обратите внимание, что формат передаваемого исходного изображения не зависит от формата биометрического образца, полученного после обработки. Если значение данной настройки равно "jpg", то для исходного изображения формата PNG все равно будет сохранен биометрический образец в формате JPG.

Формат задания настройки — string.

Значение по умолчанию — jpg.

luna_image_store_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Настройки сервиса Tasks#

Данный раздел описывает параметры сервиса Tasks.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Tasks к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_tasks/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_tasks/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_TASKS_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Tasks.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_tasks.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_tasks?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_tasks" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_tasks"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_TASKS_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО лиц.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-samples.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО тел.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-bodies-samples.

Группа параметров LUNA_IMAGE_STORE_IMAGES_ADDRESS#

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

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-image-origin.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему БО лиц.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему БО лиц. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему БО тел.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему БО тел. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_IMAGES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему исходных изображений.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему исходных изображений. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_TASK_RESULT_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения результатов задач.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — task-result.

Группа параметров LUNA_IMAGE_STORE_TASK_RESULT_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему результатов задач.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему результатов задач. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_OBJECTS_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения объектов.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-objects.

Группа параметров LUNA_TASKS_LOAD_EXTERNAL_ARCHIVE_TIMEOUTS#

Данная группа параметров задает таймауты выполнения HTTP-запросов к внешним ресурсам для загрузки архивов. Каждый параметр определяет максимальное количество времени, которое ожидается для выполнения определенной операции в рамках HTTP-запроса.

connect#

Параметр задает таймаут для установки соединения с внешним ресурсом. Если соединение не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает таймаут для ожидания ответа на HTTP-запрос, который отправляется для получения архива с внешнего ресурса.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 100.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 100.

Группа параметров LUNA_FACES_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Faces.

origin#

Параметр задает протокол, IP адрес и порт сервиса Faces.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Faces, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Faces.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5030.

api_version#

Параметр задает версию API сервиса Faces. Доступная версия API — "3".

Формат задания настройки — integer.

Значение по умолчанию — 3.

Группа параметров LUNA_FACES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Faces.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Faces. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_PYTHON_MATCHER_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Python Matcher.

origin#

Параметр задает протокол, IP адрес и порт сервиса Python Matcher.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Python Matcher, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Python Matcher.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5100.

api_version#

Параметр задает версию API сервиса Python Matcher. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_MATCHER_PROXY_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Python Matcher Proxy.

origin#

Параметр задает протокол, IP адрес и порт сервиса Python Matcher Proxy.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Python Matcher Proxy, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Python Matcher Proxy.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5110.

api_version#

Параметр задает версию API сервиса Python Matcher Proxy. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_TASKS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Tasks.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Tasks. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_EVENTS_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Events.

origin#

Параметр задает протокол, IP адрес и порт сервиса Events.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Events, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Events.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5040.

api_version#

Параметр задает версию API сервиса Events. Доступная версия API — "2".

Формат задания настройки — integer.

Значение по умолчанию — 2.

Группа параметров LUNA_EVENTS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Events.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Events. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_HANDLERS_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Handlers.

origin#

Параметр задает протокол, IP адрес и порт сервиса Handlers.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Handlers, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Handlers.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5090.

api_version#

Параметр задает версию API сервиса Handlers. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_HANDLERS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Handlers.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Handlers. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров PLATFORM_LIMITS#

Данная группа параметров определяет ограничения, связанные с операциями сравнения лиц, событий или атрибутов. Эти параметры управляют количеством объектов, которые могут быть включены в операцию сравнения, а также ограничивают количество результатов, возвращаемых в ответе.

Эти параметры полезны для балансировки производительности и использования ресурсов.

Параметры из подгруппы "match" определяют ограничения, связанные с операциями сравнения.

Параметры из подгруппы "cross_match" определяют ограничения, связанные с операциями перекрестного сравнения (см. описание задачи "Cross-matching").

Для сервиса Tasks подгруппа "match" не используется. Настройки ограничения сравнения операций обычного сравнения задаются в группе параметров "PLATFORM_LIMITS" сервиса Python Matcher.

cross_match > short_array_filter_limit#

Параметр задает максимальное количество объектов (максимальный размер массива), указанных во всех фильтрах, кроме фильтров "face_ids", "event_ids" и "attribute_ids" в задаче Cross-matching.

Например, максимальный размер массива для фильтров "sources", "tags", "cities" и др. В спецификации OpenAPI такие фильтры помечены примером [ 1 .. 1000 ] items.

Формат задания настройки — integer.

Значение по умолчанию — 1000.

cross_match > array_filter_limit#

Параметр задает максимальное количество объектов (максимальный размер массива), указанных в фильтрах "face_ids", "event_ids" и "attribute_ids" в задаче Cross-matching.

В спецификации OpenAPI такие фильтры помечены примером [ 1 .. 20000 ] items.

Формат задания настройки — integer.

Значение по умолчанию — 20000.

cross_match > result_candidate_limit#

Параметр задает максимальное количество результатов сравнения (максимальный размер массива) для списка кандидатов, возвращаемых в ответе запроса на получение результата задачи Cross-matching.

В теле запроса на сравнение также можно ограничить количество возвращаемых кандидатов в ответе с помощью параметра "limit", однако параметр "result_candidate_limit" имеет более высокий приоритет. Это означает, что при значении "result_candidate_limit" = 4 и "limit" = 6, будет возвращена ошибка с кодом "31007".

Формат задания настройки — integer.

Значение по умолчанию — 20000.

cross_match > general_limit#

Параметр задает общее ограничение на количество перекрестных сравнений. Он применяется к произведению количества кандидатов и эталонов, которые участвуют в операции сравнения с учетом фильтров. Если произведение превышает значение "general_limit", запрос завершится ошибкой.

Например, если значение "general_limit" равно "20", количество кандидатов-лиц в массиве "face_ids" равно "7", количество эталонов-лиц в массиве "face_ids" равно "5" и все остальные фильтры не сокращают реальное количество кандидатов-лиц, то запрос на перекрестное сравнение не будет выполнен, т.к. общее количество перекрестных сравнений будет равно "35" (5 x 7). Если же какой-то фильтр сокращает общее количество кандидатов-лиц на "3", то запрос будет выполнен успешно, т.к. общее количество перекрестных сравнений будет равно "20" (5 x (7 - 3)).

Формат задания настройки — integer.

Значение по умолчанию — 100000000.

Группа параметров EXTERNAL_LUNA_API_ADDRESS#

Данная группа параметров предназначена для корректной обработки ссылок на объекты, созданные с помощью ресурсов "/images" и "/objects" в сервисе API. В данной секции задается адрес и версия API сервиса API.

Если параметре "content" > "source" > "reference" ресурса "/tasks/estimator" указывается URL-адрес и версия сервиса API до объекта типа "object" (ZIP-архив), совпадающие с адресом и версией API из секции "EXTERNAL_LUNA_API_ADDRESS" сервиса Tasks, то данный объект будет загружаться с помощью сервиса Image Store напрямую, а не отправлять запрос в сервис API с последующим перенаправлением в сервис Image Store.

Пример формата: http://10.15.3.144:5000/6/images/141d2706-8baf-433b-82eb-8c7fada847da, где значение http://10.15.3.144:5000 должно совпадать со значением из настройки "origin", а значение 6 должно совпадать со значением настройки api_version секции "EXTERNAL_LUNA_API_ADDRESS".

Для избежания ошибок необходимо настроить данную секцию в настройках Handlers перед использованием URL-адресов до объектов типа "objects" или "images" в качестве источника входных данных.

origin#

Параметр задает протокол, IP адрес и порт сервиса API.

См. описание логики работы в разделе "Группа параметров EXTERNAL_LUNA_API_ADDRESS".

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5000.

api_version#

Параметр задает версию API сервиса API.

См. описание логики работы в разделе "Группа параметров EXTERNAL_LUNA_API_ADDRESS".

Формат задания настройки — integer.

Значение по умолчанию — 6.

Группа параметров LUNA_TASKS_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров TASKS_REDIS_DB_ADDRESS#

user#

Параметр задает имя пользователя БД Redis.

Формат задания настройки — string.

Значение по умолчанию не задано.

password#

Параметр задает пароль БД Redis.

Формат задания настройки — string.

Значение по умолчанию не указывается.

host#

Параметр задает IP-адрес БД Redis.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает номер порта, на котором Redis ожидает входящие сетевые соединения и прослушивает их для выполнения команд от клиентов.

Формат задания настройки — integer.

Значение по умолчанию — 6379.

sentinel > master_name#

Параметр задает имя мастера базы данных Redis, который контролируется и управляется системой Sentinel.

Формат задания настройки — string.

Значение по умолчанию — luna_tasks.

sentinel > sentinels#

Параметр задает список адресов и портов серверов Sentinel, которые будут использоваться клиентами для обнаружения и мониторинга БД Redis.

Формат задания настройки — list > string.

Значение по умолчанию — [].

sentinel > user#

Параметр задает имя пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

sentinel > password#

См. подробную информацию в разделе "Отключаемые сервисы".

В руководстве по установке приведен раздел "Использование необязательных сервисов", описывающий настройку использования необязательных сервисов перед запуском LUNA PLATFORM.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

max_error_count_per_task#

Параметр задает максимальное количество ошибок для каждой сохраняемой задачи.

Формат задания настройки — integer.

Значение по умолчанию — 100000.

tasks_to_faces_requests_concurrency#

Параметр задает максимальное количество одновременных запросов (параллельных операций) из "рабочего(чих) процесса(ов)" Tasks в сервис Faces в один момент времени.

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

Формат задания настройки — integer.

Значение по умолчанию — 5.

tasks_to_image_store_requests_concurrency#

Параметр задает максимальное количество одновременных запросов (параллельных операций) из "рабочего(чих) процесса(ов)" Tasks в сервис Image-Store в один момент времени.

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

Формат задания настройки — integer.

Значение по умолчанию — 100.

tasks_to_handlers_requests_concurrency#

Параметр задает максимальное количество одновременных запросов (параллельных операций) из "рабочего(чих) процесса(ов)" Tasks в сервис Handlers в один момент времени.

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

Формат задания настройки — integer.

Значение по умолчанию — 8.

luna_tasks_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Настройки сервиса Events#

Данный раздел описывает параметры сервиса Events.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Events к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_events/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_events/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_EVENTS_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_EVENTS_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Events.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_events.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_events?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_events" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_events"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_EVENTS_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Группа параметров DESCRIPTOR_ENCRYPTION#

Данная группа параметров задает настройки шифрования биометрических шаблонов для повышения безопасности и предотвращения несанкционированного использования.

См. подробную информацию в разделе "Шифрование биометрических шаблонов".

enabled#

Параметр включает шифрование биометрических шаблонов.

Формат задания настройки — boolean.

Значение по умолчанию — false.

algorithm#

Параметр задает название используемого алгоритма шифрования.

Формат задания настройки — string.

Значение по умолчанию — aes256-gcm.

params > source#

Параметр задает название источника ключа шифрования. Поддерживаются два типа источников: raw и vaultKV.

Формат задания настройки — string.

Значение по умолчанию — raw.

params > key#

Параметр задает ключ шифрования или учетные данные для его получения из указанного источника.

Формат задания настройки — string.

Значение по умолчанию не задано.

Прочие#

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

default_face_descriptor_version#

Параметр задает используемую версию биометрического шаблона лица.

Формат задания настройки — string.

Значение по умолчанию — 59.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

default_human_descriptor_version#

Параметр задает используемую версию биометрического шаблона тела.

См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

Формат задания настройки — string.

Значение по умолчанию — 116.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

save_events_timeout#

Параметр задает время ожидания для сохранения событий в базе данных Events.

Значения "0" или отрицательные означают, что сервис будет сохранять события без каких-либо ограничений по времени ожидания.

Использование данного параметра предотвращает избыточное использование вычислительных ресурсов.

Формат задания настройки — float (секунды).

Значение по умолчанию — 2.

luna_events_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Настройки сервиса Sender#

Данный раздел описывает параметры сервиса Sender.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Sender к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_sender/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_sender/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_SENDER_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров REDIS_DB_ADDRESS#

user#

Параметр задает имя пользователя БД Redis.

Формат задания настройки — string.

Значение по умолчанию не задано.

password#

Параметр задает пароль БД Redis.

Формат задания настройки — string.

Значение по умолчанию не указывается.

host#

Параметр задает IP-адрес БД Redis.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает номер порта, на котором Redis ожидает входящие сетевые соединения и прослушивает их для выполнения команд от клиентов.

Формат задания настройки — integer.

Значение по умолчанию — 6379.

channel#

Параметр задает канал Redis-канал, на который сервис подписывается сервис.

Формат задания настройки — integer.

Значение по умолчанию — luna-sender.

sentinel > master_name#

Параметр задает имя мастера базы данных Redis, который контролируется и управляется системой Sentinel.

Формат задания настройки — string.

Значение по умолчанию — luna_sender_master.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

sentinel > sentinels#

Параметр задает список адресов и портов серверов Sentinel, которые будут использоваться клиентами для обнаружения и мониторинга БД Redis.

Формат задания настройки — list > string.

Значение по умолчанию — [].

sentinel > user#

Параметр задает имя пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

sentinel > password#

Параметр задает пароль пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_SENDER_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Прочие#

luna_sender_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Настройки сервиса Licenses#

Данный раздел описывает параметры сервиса Licenses.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Licenses к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_licenses/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_licenses/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_LICENSES_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LICENSE_VENDOR#

Данная группа параметров задает настройки лицензирования.

См. подробную информацию по активации лицензии в руководстве по установке и в руководстве по активации LUNA PLATFORM.

См. подробную информацию о лицензии в разделе "Информация о лицензии".

vendor#

Параметр определяет, какой вендор лицензий будет использоваться. Доступно два варианта:

"hasp"
"guardant"

Формат задания настройки — string.

Значение по умолчанию — hasp.

server_address#

Параметр задает IP-адрес, по которому сервис Licenses будет искать сервер для управления лицензиями.

Адрес должен указываться без протокола и порта.

Значение "127.0.0.1" означает, что сервер находится на локальном компьютере. Если вы используете внешний сервер для лицензирования, вам следует изменить это значение на адрес вашего сервера.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

license_id#

Примечание. Параметр используется только для вендора "guardant" дополнительно с параметрами "server_address" и "vendor". Если используется вендор "hasp", то необходимо отключить данный параметр.

Параметр задает идентификатор лицензии в формате 0x<your_license_id>. Идентификатор лицензии можно найти в пользовательском интерфейсе Guardant по адресу http://<your_host_address>:3189/ на вкладке "Ключи".

Формат задания настройки — string.

Значение по умолчанию не указано.

Группа параметров LUNA_LICENSES_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

luna_licenses_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Настройки сервиса Python Matcher#

Данный раздел описывает параметры сервиса Python Matcher.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Python Matcher к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_python_matcher/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_python_matcher/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_PYTHON_MATCHER_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_FACES_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Faces.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_faces.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_faces?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_faces" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_faces"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_ATTRIBUTES_DB#

user#

Параметр задает имя пользователя БД Redis.

Формат задания настройки — string.

Значение по умолчанию не задано.

password#

Параметр задает пароль БД Redis.

Формат задания настройки — string.

Значение по умолчанию не указывается.

host#

Параметр задает IP-адрес БД Redis.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает номер порта, на котором Redis ожидает входящие сетевые соединения и прослушивает их для выполнения команд от клиентов.

Формат задания настройки — integer.

Значение по умолчанию — 6379.

sentinel > master_name#

Параметр задает имя мастера базы данных Redis, который контролируется и управляется системой Sentinel.

Формат задания настройки — string.

Значение по умолчанию — luna_attributes.

sentinel > sentinels#

Параметр задает список адресов и портов серверов Sentinel, которые будут использоваться клиентами для обнаружения и мониторинга БД Redis.

Формат задания настройки — list > string.

Значение по умолчанию — [].

sentinel > user#

Параметр задает имя пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

sentinel > password#

См. подробную информацию в разделе "Отключаемые сервисы".

В руководстве по установке приведен раздел "Использование необязательных сервисов", описывающий настройку использования необязательных сервисов перед запуском LUNA PLATFORM.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

Группа параметров LUNA_EVENTS_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Events.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_events.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_events?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_events" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_events"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_PYTHON_MATCHER_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Python Matcher.

origin#

Параметр задает протокол, IP адрес и порт сервиса Python Matcher.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Python Matcher, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Python Matcher.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5100.

api_version#

Параметр задает версию API сервиса Python Matcher. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_PYTHON_MATCHER_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров PLATFORM_LIMITS#

Данная группа параметров определяет ограничения, связанные с операциями сравнения лиц, событий или атрибутов. Эти параметры управляют количеством объектов, которые могут быть включены в операцию сравнения, а также ограничивают количество результатов, возвращаемых в ответе.

Эти параметры полезны для балансировки производительности и использования ресурсов.

Параметры из подгруппы "match" определяют ограничения, связанные с операциями сравнения.

Параметры из подгруппы "cross_match" определяют ограничения, связанные с операциями перекрестного сравнения (см. описание задачи "Cross-matching").

match > array_filter_limit#

Параметр задает максимальное количество объектов (максимальный размер массива), указанных в фильтрах "face_ids", "event_ids" и "attribute_ids".

Формат задания настройки — integer.

Значение по умолчанию — 1000.

match > reference_limit#

Параметр задает максимальное количество эталонов (максимальный размер массива), которых можно указать в запросе на сравнение.

Необходимо подбирать значение данного параметра в соответствии со своими бизнес-кейсами, т.к. он значительно потребляет ресурсы системы. Так, например, не следует использовать значение по умолчанию "30", если необходимо работать только с тремя эталонами. См. дополнительные советы по оптимизации ресурсов в разделе "Оптимизация ресурсов".

Формат задания настройки — integer.

Значение по умолчанию — 30.

match > candidate_limit#

Параметр задает максимальное количество кандидатов (максимальный размер массива), которых можно указать в запросе на сравнение.

Необходимо подбирать значение данного параметра в соответствии со своими бизнес-кейсами, т.к. он значительно потребляет ресурсы системы. Так, например, не следует использовать значение по умолчанию "30", если необходимо работать только с тремя кандидатами. См. дополнительные советы по оптимизации ресурсов в разделе "Оптимизация ресурсов".

Формат задания настройки — integer.

Значение по умолчанию — 30.

match > result_candidate_limit#

Параметр задает максимальное количество результатов сравнения (максимальный размер массива) для списка кандидатов, возвращаемых в ответе запроса на сравнение.

В теле запроса на сравнение также можно ограничить количество возвращаемых кандидатов в ответе с помощью параметра "limit", однако параметр "result_candidate_limit" имеет более высокий приоритет. Это означает, что при значении "result_candidate_limit" = 4 и "limit" = 6, будет возвращена ошибка с кодом "31007".

Формат задания настройки — integer.

Значение по умолчанию — 100.

cross_match > short_array_filter_limit#

Параметр задает максимальное количество объектов (максимальный размер массива), указанных во всех фильтрах, кроме фильтров "face_ids", "event_ids" и "attribute_ids" в задаче Cross-matching.

Например, максимальный размер массива для фильтров "sources", "tags", "cities" и др. В спецификации OpenAPI такие фильтры помечены примером [ 1 .. 1000 ] items.

Формат задания настройки — integer.

Значение по умолчанию — 1000.

cross_match > array_filter_limit#

Параметр задает максимальное количество объектов (максимальный размер массива), указанных в фильтрах "face_ids", "event_ids" и "attribute_ids" в задаче Cross-matching.

В спецификации OpenAPI такие фильтры помечены примером [ 1 .. 20000 ] items.

Формат задания настройки — integer.

Значение по умолчанию — 20000.

cross_match > result_candidate_limit#

Параметр задает максимальное количество результатов сравнения (максимальный размер массива) для списка кандидатов, возвращаемых в ответе запроса на получение результата задачи Cross-matching.

В теле запроса на сравнение также можно ограничить количество возвращаемых кандидатов в ответе с помощью параметра "limit", однако параметр "result_candidate_limit" имеет более высокий приоритет. Это означает, что при значении "result_candidate_limit" = 4 и "limit" = 6, будет возвращена ошибка с кодом "31007".

Формат задания настройки — integer.

Значение по умолчанию — 20000.

cross_match > general_limit#

Параметр задает общее ограничение на количество перекрестных сравнений. Он применяется к произведению количества кандидатов и эталонов, которые участвуют в операции сравнения с учетом фильтров. Если произведение превышает значение "general_limit", запрос завершится ошибкой.

Например, если значение "general_limit" равно "20", количество кандидатов-лиц в массиве "face_ids" равно "7", количество эталонов-лиц в массиве "face_ids" равно "5" и все остальные фильтры не сокращают реальное количество кандидатов-лиц, то запрос на перекрестное сравнение не будет выполнен, т.к. общее количество перекрестных сравнений будет равно "35" (5 x 7). Если же какой-то фильтр сокращает общее количество кандидатов-лиц на "3", то запрос будет выполнен успешно, т.к. общее количество перекрестных сравнений будет равно "20" (5 x (7 - 3)).

Формат задания настройки — integer.

Значение по умолчанию — 100000000.

Группа параметров DESCRIPTORS_CACHE#

Данная группа параметров задает настройки кеширования списков при выполнении сравнения по спискам.

Использование кеширования увеличивает производительность сравнения.

См. подробную информацию в разделе "Кеширование списков".

cache_enabled#

Параметр включает кеширование списков.

Формат задания настройки — boolean.

Значение по умолчанию — true.

updating_cache_interval#

Параметр задает интервал обновления кеша. Все новые биометрические шаблоны будут добавлены за одну итерацию через указанное время.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 2.

matching_settings > thread_count#

Параметр задает количество потоков (threads), которые будут использоваться для сравнения данных по кешу.

Если установлено значение "0", то будет выбран автоматический метод выбора количества потоков.

Формат задания настройки — integer (неотрицательное значение).

Значение по умолчанию — 0.

matching_settings > tasks_count#

Параметр задает количество "рабочих процессов", обрабатывающих очередь на отправку запросов на сравнение в Cached Matcher.

Формат задания настройки — integer.

Значение по умолчанию — 10.

matching_settings > batch_size#

Параметр задает максимальное количество запросов на сравнение в Cached Matcher в пределах одного пакета.

Формат задания настройки — integer.

Значение по умолчанию — 20.

rpc_settings > timeouts > connect_timeout#

Параметр задает максимальное время ожидания для установления соединения с Cached Matcher. Если соединение не устанавливается в пределах этого времени, то оно будет считаться неудачным.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

rpc_settings > timeouts > request_timeout#

Параметр задает максимальное время, в течение которого запрос к Cached Matcher должен быть выполнен. Если запрос не завершится в пределах этого времени, он будет отменен.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

rpc_settings > timeouts > response_timeout#

Параметр задает максимальное время ожидания ответа от Cached Matcher. Если ответ не поступит в пределах этого времени, операция будет считаться неудачной.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

rpc_settings > pool_size#

Параметр задает количество подключений между сервисами Python Matcher и Cached Matcher.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 100.

cached_data > faces_lists > exclude#

Параметр задает списки, которые не будут кешированы.

Для отключения настройки нужно задать значение "[]".

Формат задания настройки — string.

Значение по умолчанию — [].

cached_data > faces_lists > include#

Параметр задает списки, которые будут кешированы.

Формат задания настройки — string.

Значение по умолчанию не задано, что означает, что будут обработаны все существующие списки.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Группа параметров DESCRIPTOR_ENCRYPTION#

Данная группа параметров задает настройки шифрования биометрических шаблонов для повышения безопасности и предотвращения несанкционированного использования.

См. подробную информацию в разделе "Шифрование биометрических шаблонов".

enabled#

Параметр включает шифрование биометрических шаблонов.

Формат задания настройки — boolean.

Значение по умолчанию — false.

algorithm#

Параметр задает название используемого алгоритма шифрования.

Формат задания настройки — string.

Значение по умолчанию — aes256-gcm.

params > source#

Параметр задает название источника ключа шифрования. Поддерживаются два типа источников: raw и vaultKV.

Формат задания настройки — string.

Значение по умолчанию — raw.

params > key#

Параметр задает ключ шифрования или учетные данные для его получения из указанного источника.

Формат задания настройки — string.

Значение по умолчанию не задано.

Прочие#

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

luna_python_matcher_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

default_face_descriptor_version#

Параметр задает используемую версию биометрического шаблона лица.

Формат задания настройки — string.

Значение по умолчанию — 59.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

default_human_descriptor_version#

Параметр задает используемую версию биометрического шаблона тела.

См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

Формат задания настройки — string.

Значение по умолчанию — 116.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

Настройки сервиса Python Matcher Proxy#

Данный раздел описывает параметры сервиса Python Matcher Proxy.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Python Matcher Proxy к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_python_matcher/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_python_matcher/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_PYTHON_MATCHER_PROXY_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров PLATFORM_LIMITS#

Данная группа параметров определяет ограничения, связанные с операциями сравнения лиц, событий или атрибутов. Эти параметры управляют количеством объектов, которые могут быть включены в операцию сравнения, а также ограничивают количество результатов, возвращаемых в ответе.

Эти параметры полезны для балансировки производительности и использования ресурсов.

Параметры из подгруппы "match" определяют ограничения, связанные с операциями сравнения.

Параметры из подгруппы "cross_match" определяют ограничения, связанные с операциями перекрестного сравнения (см. описание задачи "Cross-matching").

match > array_filter_limit#

Параметр задает максимальное количество объектов (максимальный размер массива), указанных в фильтрах "face_ids", "event_ids" и "attribute_ids".

Формат задания настройки — integer.

Значение по умолчанию — 1000.

match > reference_limit#

Параметр задает максимальное количество эталонов (максимальный размер массива), которых можно указать в запросе на сравнение.

Необходимо подбирать значение данного параметра в соответствии со своими бизнес-кейсами, т.к. он значительно потребляет ресурсы системы. Так, например, не следует использовать значение по умолчанию "30", если необходимо работать только с тремя эталонами. См. дополнительные советы по оптимизации ресурсов в разделе "Оптимизация ресурсов".

Формат задания настройки — integer.

Значение по умолчанию — 30.

match > candidate_limit#

Параметр задает максимальное количество кандидатов (максимальный размер массива), которых можно указать в запросе на сравнение.

Необходимо подбирать значение данного параметра в соответствии со своими бизнес-кейсами, т.к. он значительно потребляет ресурсы системы. Так, например, не следует использовать значение по умолчанию "30", если необходимо работать только с тремя кандидатами. См. дополнительные советы по оптимизации ресурсов в разделе "Оптимизация ресурсов".

Формат задания настройки — integer.

Значение по умолчанию — 30.

match > result_candidate_limit#

Параметр задает максимальное количество результатов сравнения (максимальный размер массива) для списка кандидатов, возвращаемых в ответе запроса на сравнение.

В теле запроса на сравнение также можно ограничить количество возвращаемых кандидатов в ответе с помощью параметра "limit", однако параметр "result_candidate_limit" имеет более высокий приоритет. Это означает, что при значении "result_candidate_limit" = 4 и "limit" = 6, будет возвращена ошибка с кодом "31007".

Формат задания настройки — integer.

Значение по умолчанию — 100.

cross_match > short_array_filter_limit#

Параметр задает максимальное количество объектов (максимальный размер массива), указанных во всех фильтрах, кроме фильтров "face_ids", "event_ids" и "attribute_ids" в задаче Cross-matching.

Например, максимальный размер массива для фильтров "sources", "tags", "cities" и др. В спецификации OpenAPI такие фильтры помечены примером [ 1 .. 1000 ] items.

Формат задания настройки — integer.

Значение по умолчанию — 1000.

cross_match > array_filter_limit#

Параметр задает максимальное количество объектов (максимальный размер массива), указанных в фильтрах "face_ids", "event_ids" и "attribute_ids" в задаче Cross-matching.

В спецификации OpenAPI такие фильтры помечены примером [ 1 .. 20000 ] items.

Формат задания настройки — integer.

Значение по умолчанию — 20000.

cross_match > result_candidate_limit#

Параметр задает максимальное количество результатов сравнения (максимальный размер массива) для списка кандидатов, возвращаемых в ответе запроса на получение результата задачи Cross-matching.

В теле запроса на сравнение также можно ограничить количество возвращаемых кандидатов в ответе с помощью параметра "limit", однако параметр "result_candidate_limit" имеет более высокий приоритет. Это означает, что при значении "result_candidate_limit" = 4 и "limit" = 6, будет возвращена ошибка с кодом "31007".

Формат задания настройки — integer.

Значение по умолчанию — 20000.

cross_match > general_limit#

Параметр задает общее ограничение на количество перекрестных сравнений. Он применяется к произведению количества кандидатов и эталонов, которые участвуют в операции сравнения с учетом фильтров. Если произведение превышает значение "general_limit", запрос завершится ошибкой.

Например, если значение "general_limit" равно "20", количество кандидатов-лиц в массиве "face_ids" равно "7", количество эталонов-лиц в массиве "face_ids" равно "5" и все остальные фильтры не сокращают реальное количество кандидатов-лиц, то запрос на перекрестное сравнение не будет выполнен, т.к. общее количество перекрестных сравнений будет равно "35" (5 x 7). Если же какой-то фильтр сокращает общее количество кандидатов-лиц на "3", то запрос будет выполнен успешно, т.к. общее количество перекрестных сравнений будет равно "20" (5 x (7 - 3)).

Формат задания настройки — integer.

Значение по умолчанию — 100000000.

Группа параметров LUNA_PYTHON_MATCHER_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Python-Matcher.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_python_matcher.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_python_matcher?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_python_matcher" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_python_matcher"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_PROXY_TO_PYTHON_MATCHER_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Python Matcher Proxy.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Python Matcher Proxy. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 300.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 300.

Группа параметров LUNA_PYTHON_MATCHER_PROXY_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

luna_python_matcher_proxy_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_FACES_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Faces.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_faces.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_faces?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_faces" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_faces"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_EVENTS_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Events.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_events.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_events?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_events" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_events"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_ATTRIBUTES_DB#

user#

Параметр задает имя пользователя БД Redis.

Формат задания настройки — string.

Значение по умолчанию не задано.

password#

Параметр задает пароль БД Redis.

Формат задания настройки — string.

Значение по умолчанию не указывается.

host#

Параметр задает IP-адрес БД Redis.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает номер порта, на котором Redis ожидает входящие сетевые соединения и прослушивает их для выполнения команд от клиентов.

Формат задания настройки — integer.

Значение по умолчанию — 6379.

sentinel > master_name#

Параметр задает имя мастера базы данных Redis, который контролируется и управляется системой Sentinel.

Формат задания настройки — string.

Значение по умолчанию — luna_attributes.

sentinel > sentinels#

Параметр задает список адресов и портов серверов Sentinel, которые будут использоваться клиентами для обнаружения и мониторинга БД Redis.

Формат задания настройки — list > string.

Значение по умолчанию — [].

sentinel > user#

Параметр задает имя пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

sentinel > password#

См. подробную информацию в разделе "Отключаемые сервисы".

В руководстве по установке приведен раздел "Использование необязательных сервисов", описывающий настройку использования необязательных сервисов перед запуском LUNA PLATFORM.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

default_face_descriptor_version#

Параметр задает используемую версию биометрического шаблона лица.

Формат задания настройки — string.

Значение по умолчанию — 59.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

default_human_descriptor_version#

Параметр задает используемую версию биометрического шаблона тела.

См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

Формат задания настройки — string.

Значение по умолчанию — 116.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

Настройки сервиса Handlers#

Данный раздел описывает параметры сервиса Handlers.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Handlers к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_handlers/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_handlers/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_HANDLERS_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Handlers.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_handlers.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_handlers?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_handlers" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_handlers"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_HANDLERS_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_REMOTE_SDK_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Remote SDK.

origin#

Параметр задает протокол, IP адрес и порт сервиса Remote SDK.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Remote SDK, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Remote SDK.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5220.

api_version#

Параметр задает версию API сервиса Remote SDK. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_REMOTE_SDK_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Remote SDK.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Remote SDK. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_FACES_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Faces.

origin#

Параметр задает протокол, IP адрес и порт сервиса Faces.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Faces, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Faces.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5030.

api_version#

Параметр задает версию API сервиса Faces. Доступная версия API — "3".

Формат задания настройки — integer.

Значение по умолчанию — 3.

Группа параметров LUNA_FACES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Faces.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Faces. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_LAMBDA_UNIT_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Lambda Unit.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Lambda Unit. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО лиц.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-samples.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему БО лиц.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему БО лиц. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО тел.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-bodies-samples.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему БО тел.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему БО тел. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_IMAGES_ADDRESS#

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

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-image-origin.

Группа параметров LUNA_IMAGE_STORE_IMAGES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему исходных изображений.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему исходных изображений. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

См. подробную информацию в разделе "Отключаемые сервисы".

В руководстве по установке приведен раздел "Использование необязательных сервисов", описывающий настройку использования необязательных сервисов перед запуском LUNA PLATFORM.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

Группа параметров LUNA_EVENTS_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Events.

origin#

Параметр задает протокол, IP адрес и порт сервиса Events.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Events, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Events.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5040.

api_version#

Параметр задает версию API сервиса Events. Доступная версия API — "2".

Формат задания настройки — integer.

Значение по умолчанию — 2.

Группа параметров LUNA_EVENTS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Events.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Events. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_PYTHON_MATCHER_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Python Matcher.

origin#

Параметр задает протокол, IP адрес и порт сервиса Python Matcher.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Python Matcher, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Python Matcher.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5100.

api_version#

Параметр задает версию API сервиса Python Matcher. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_PYTHON_MATCHER_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Python Matcher.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Python Matcher. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_MATCHER_PROXY_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Python Matcher Proxy.

origin#

Параметр задает протокол, IP адрес и порт сервиса Python Matcher Proxy.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Python Matcher Proxy, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Python Matcher Proxy.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5110.

api_version#

Параметр задает версию API сервиса Python Matcher Proxy. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_PYTHON_MATCHER_PROXY_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Python Matcher Proxy.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Python Matcher Proxy. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров REDIS_DB_ADDRESS#

user#

Параметр задает имя пользователя БД Redis.

Формат задания настройки — string.

Значение по умолчанию не задано.

password#

Параметр задает пароль БД Redis.

Формат задания настройки — string.

Значение по умолчанию не указывается.

host#

Параметр задает IP-адрес БД Redis.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает номер порта, на котором Redis ожидает входящие сетевые соединения и прослушивает их для выполнения команд от клиентов.

Формат задания настройки — integer.

Значение по умолчанию — 6379.

channel#

Параметр задает канал Redis-канал, на который сервис подписывается сервис.

Формат задания настройки — integer.

Значение по умолчанию — luna-sender.

sentinel > master_name#

Параметр задает имя мастера базы данных Redis, который контролируется и управляется системой Sentinel.

Формат задания настройки — string.

Значение по умолчанию — luna_sender_master.

sentinel > sentinels#

Параметр задает список адресов и портов серверов Sentinel, которые будут использоваться клиентами для обнаружения и мониторинга БД Redis.

Формат задания настройки — list > string.

Значение по умолчанию — [].

sentinel > user#

Параметр задает имя пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

sentinel > password#

Параметр задает пароль пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

Группа параметров FETCH_EXTERNAL_IMAGE_TIMEOUTS#

Данная группа параметров представляет собой набор параметров для установки таймаутов в процессе выполнения HTTP-запросов к внешним ресурсам для загрузки изображений. Каждый из параметров в этой настройке определяет максимальное время ожидания для определенной операции в процессе выполнения запроса.

connect#

Параметр задает таймаут для установки соединения с внешним ресурсом. Если соединение не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

request#

Параметр задает таймаут для ожидания ответа на HTTP-запрос, который отправляется для получения изображения с внешнего ресурса.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_request#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

Группа параметров ATTRIBUTES_STORAGE_POLICY#

В данной группе параметров задаются настройки для сервиса Handlers, связанные с хранением временных атрибутов.

default_ttl#

Параметр задает время существования временных атрибутов по умолчанию.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 300.

max_ttl#

Параметр задает максимальное время существования временных атрибутов.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 86400.

Группа параметров LUNA_HANDLERS_LIMITS#

Данная группа параметров определяет ограничения для некоторых операций, выполняемых с помощью сервиса Handlers.

Увеличение данных ограничений может привести к уменьшению производительности.

received_images_limit#

Параметр задает максимальное количество изображений, которые можно указать в запросах "generate events", "detect faces" и "perform verification" с помощью схемы "multipart/form-data".

Для пакетной обработки изображений необходимо использовать задачу Estimator.

Формат задания настройки — integer.

Значение по умолчанию — 8.

raw_event_detections_limit#

Параметр задает максимальное количество детекций, которые можно указать в запросе "save event".

Формат задания настройки — integer.

Значение по умолчанию — 100.

raw_event_arrays_limit#

Параметр задает максимальную длину массивов в теле запроса "save event".

Формат задания настройки — integer.

Значение по умолчанию — 30.

result_candidate_limit#

Параметр задает максимальное количество результатов сравнения биометрических шаблонов в запросе "generate events".

Формат задания настройки — integer.

Значение по умолчанию — 100.

Группа параметров EXTERNAL_LUNA_API_ADDRESS#

Данная группа параметров предназначена для корректной обработки ссылок на объекты, созданные с помощью ресурсов "/images" и "/objects" в сервисе API. В данной секции задается адрес и версия API сервиса API.

Если в качестве входных данных для ресурсов "/detector", "handlers/{handler_id}/events" и "verifiers/{verifier_id}/verification" указывается URL-адрес и версия сервиса API объекта типа "images", совпадающие с адресом и версией API из секции "EXTERNAL_LUNA_API_ADDRESS" сервиса Handlers, то данные объекты будут загружаться с помощью сервиса Image Store напрямую, а не отправлять запрос в сервис API с последующим перенаправлением в сервис Image Store.

Пример формата: http://10.15.3.144:5000/6/images/141d2706-8baf-433b-82eb-8c7fada847da, где значение http://10.15.3.144:5000 должно совпадать со значением из настройки "origin", а значение 6 должно совпадать со значением настройки api_version секции "EXTERNAL_LUNA_API_ADDRESS".

Для избежания ошибок необходимо настроить данную секцию в настройках Handlers перед использованием URL-адресов до объектов типа "objects" или "images" в качестве источника входных данных.

origin#

Параметр задает протокол, IP адрес и порт сервиса API.

См. описание логики работы в разделе "Группа параметров EXTERNAL_LUNA_API_ADDRESS".

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5000.

api_version#

Параметр задает версию API сервиса API.

См. описание логики работы в разделе "Группа параметров EXTERNAL_LUNA_API_ADDRESS".

Формат задания настройки — integer.

Значение по умолчанию — 6.

Группа параметров LUNA_HANDLERS_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

luna_handlers_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

default_face_descriptor_version#

Параметр задает используемую версию биометрического шаблона лица.

Формат задания настройки — string.

Значение по умолчанию — 59.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

default_human_descriptor_version#

Параметр задает используемую версию биометрического шаблона тела.

См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

Формат задания настройки — string.

Значение по умолчанию — 116.

Примечание. См. подробную информацию о версиях биометрических шаблонах в разделе "Нейронные сети".

Настройки сервиса Backport 3#

Данный раздел описывает параметры сервиса Backport 3.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Backport 3 к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_backport3/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_backport3/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_BACKPORT3_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Backport3.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_backport3.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_backport3?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_backport3" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_backport3"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_BACKPORT3_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_API_ADDRESS#

Данная группа параметров задает настройки подключения к сервису API.

origin#

Параметр задает протокол, IP адрес и порт сервиса API.

IP адрес "127.0.0.1" означает, что будет использоваться сервис API, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом API.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5000.

api_version#

Параметр задает версию API сервиса API. Доступная версия API — "6".

Формат задания настройки — integer.

Значение по умолчанию — 6.

Группа параметров LUNA_API_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису API.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису API. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_PORTRAITS_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения портретов.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — portraits.

Группа параметров LUNA_IMAGE_STORE_PORTRAITS_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему портретов.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему портретов. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров BACKPORT3_EVENTS_DB_ADDRESS#

user#

Параметр задает имя пользователя БД Redis.

Формат задания настройки — string.

Значение по умолчанию не задано.

password#

Параметр задает пароль БД Redis.

Формат задания настройки — string.

Значение по умолчанию не указывается.

host#

Параметр задает IP-адрес БД Redis.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает номер порта, на котором Redis ожидает входящие сетевые соединения и прослушивает их для выполнения команд от клиентов.

Формат задания настройки — integer.

Значение по умолчанию — 6379.

channel#

Параметр задает канал Redis-канал, на который сервис подписывается сервис.

Формат задания настройки — integer.

Значение по умолчанию — luna-backport3.

sentinel > master_name#

Параметр задает имя мастера базы данных Redis, который контролируется и управляется системой Sentinel.

Формат задания настройки — string.

Значение по умолчанию — luna_backport3_master.

sentinel > sentinels#

Параметр задает список адресов и портов серверов Sentinel, которые будут использоваться клиентами для обнаружения и мониторинга БД Redis.

Формат задания настройки — list > string.

Значение по умолчанию — [].

sentinel > user#

Параметр задает имя пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

sentinel > password#

Параметр задает пароль пользователя сервера Sentinel.

Формат задания настройки — string.

Значение по умолчанию не задано.

Группа параметров LUNA_BACKPORT3_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

luna_backport3_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_samples_as_portraits#

Параметр позволяет использовать биометрические образцы вместо портретов для того, чтобы не хранить оба вида сущностей.

Формат задания настройки — boolean.

Значение по умолчанию — true.

backport3_enable_portraits#

Параметр позволяет отключить возможность использования портретов, но оставить возможность использования остального функционала сервиса Image Store. Если использование сервиса Image Store отключено в настройке "ADDITIONAL_SERVICES_USAGE", то данная настройка также должна быть отключена.

Формат задания настройки — boolean.

Значение по умолчанию — true.

backport3_enable_ws_events#

Параметр включает поддержку веб-сокетов для Backport3.

Формат задания настройки — boolean.

Значение по умолчанию — true.

max_candidate_in_response#

Параметр задает максимальное количество кандидатов в ответах на запросы сравнения.

Формат задания настройки — integer.

Значение по умолчанию — 5.

Настройки сервиса Backport 4#

Данный раздел описывает параметры сервиса Backport 4.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Backport 4 к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_backport4/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_backport4/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_BACKPORT4_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Backport4.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_backport3.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_backport3?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_backport3" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_backport3"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_BACKPORT4_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_API_ADDRESS#

Данная группа параметров задает настройки подключения к сервису API.

origin#

Параметр задает протокол, IP адрес и порт сервиса API.

IP адрес "127.0.0.1" означает, что будет использоваться сервис API, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом API.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5000.

api_version#

Параметр задает версию API сервиса API. Доступная версия API — "6".

Формат задания настройки — integer.

Значение по умолчанию — 6.

Группа параметров LUNA_API_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису API.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису API. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

sock_connect#

Параметр задает таймаут для установки соединения на уровне сокетов. Если соединение на уровне сокетов не устанавливается в установленное время, операция будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 10.

sock_read#

Параметр задает таймаут на чтение данных с сокета после успешного соединения. Если данные не поступают в установленное время, операция чтения будет прервана.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_FACES_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Faces.

origin#

Параметр задает протокол, IP адрес и порт сервиса Faces.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Faces, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Faces.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5030.

api_version#

Параметр задает версию API сервиса Faces. Доступная версия API — "3".

Формат задания настройки — integer.

Значение по умолчанию — 3.

Группа параметров LUNA_FACES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к сервису Faces.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к сервису Faces. Это время ожидания, в течение которого клиент пытается установить соединение с сервисом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 20.

request#

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

luna_backport4_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

Настройки сервиса Accounts#

Данный раздел описывает параметры сервиса Accounts.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Accounts к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_accounts/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_accounts/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_ACCOUNTS_DB#

В данной группе параметров задаются настройки подключения к базе данных сервиса Accounts.

db_type#

Параметр задает тип базы данных. Доступны следующие типы:

"postgres" — тип СУБД PostgreSQL
"oracle" — тип СУБД Oracle

Формат задания настройки — string.

Значение по умолчанию — postgres.

db_host#

Параметр задает имя сервера (хост) базы данных.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

db_port#

Параметр задает порт базы данных.

Порт по умолчанию для типа "postgres"- 5432.

Порт по умолчанию для типа "oracle" — 1521.

Формат задания настройки — string.

Значение по умолчанию — 5432.

db_user#

Параметр задает имя пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_password#

Параметр задает пароль пользователя базы данных.

Формат задания настройки — string.

Значение по умолчанию — luna.

db_name#

Параметр задает имя базы данных для типа "postgres" или имя SID для типа "oracle".

Формат задания настройки — string.

Значение по умолчанию — luna_accounts.

connection_pool_size#

Параметр задает размер пула соединений к БД. Реальное количество подключений может быть больше значения данной настройки на 1.

При необходимости в настройке "max_connections" конфигурационного файла PostgreSQL можно задать максимальное количество одновременных подключений к серверу БД. См. раздел "Продвинутая настройка PostrgeSQL" для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — 10.

dsn#

Параметр задает строку подключения DSN для соединения с БД.

DSN — это строка подключения, которая идентифицирует и указывает на источник данных (базу данных), к которому нужно установить соединение.

В строке DSN могут задаваться такие настройки, как множественные хосты, аутентификационные данные, порт и другие параметры.

Настройки зависят от типа БД. Множественные хосты поддерживаются только с PostgreSQL.

По умолчанию параметр "dsn" не отображается во вкладке "Settings" в Configurator. Проверить список всех доступных параметров для группы настроек можно на вкладке "Limitations".

Пример:

{
"dsn": "luna:luna@postgres01:5432,postgres02:5432/luna_accounts?some_option=some_value"
"db_settings": {
    "connection_pool_size": 5
    }
}

Здесь:

"luna:luna" — имя пользователя и пароль для подключения к PostgreSQL;
"@postgres01:5432,postgres02:5432" — список хостов и портов, разделенных запятыми. Это означает, что сервис будет пытаться подключиться к первому хосту ("postgres01") на порту 5432. Если это не удастся, она попытается подключиться ко второму хосту ("postgres02") также на порту 5432;
"/luna_accounts" — название базы данных;
"?some_option=some_value" — опциональные параметры для подключения.

При необходимости можно комбинировать строку DSN и классические настройки, однако строка DSN является более приоритетной. Можно частично заполнить строку DSN (например, "postgres01,postgres02/luna_accounts"), и тогда недостающие параметры будут заполнены из значений параметров "db_host", "db_port", "db_name", "db_user" и "db_password".

При запуске сервис создаст пул подключений к одному из доступных хостов DSN. В случае возникновения проблем с установлением соединения после нескольких неудачных попыток, сервис снова попытается настроить пул подключений к любому из доступных хостов DSN.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_ACCOUNTS_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_ACCOUNTS_HTTP_SETTINGS#

В данной группе параметров содержатся настройки, отвечающие за обработку HTTP-подключений. См. подробную информацию по следующей ссылке: https://sanic.dev/en/guide/deployment/configuration.html#builtin-values

request_timeout#

Параметр задает продолжительность времени между моментом, когда новое открытое TCP-соединение передается на сервер, и моментом, когда получен весь HTTP-запрос.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

response_timeout#

Параметр задает продолжительность времени между моментом, когда сервер передает HTTP-запрос приложению, и моментом, когда HTTP-ответ отправляется клиенту.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 600.

request_max_size#

Параметр задает максимальный размер запроса.

Формат задания настройки — integer (байты).

Значение по умолчанию — 1073741824.

keep_alive_timeout#

Параметр задает тайм-аут поддержания активности HTTP.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 15.

Группа параметров LUNA_SERVICE_METRICS#

Данная группа параметров включает и настраивает сбор метрик в формате Prometheus.

См. подробную информацию в разделе "Мониторинг".

enabled#

Параметр включает сбор метрик.

Если сбор метрик отключен, то запрос к ресурсу /metrics вернет соответствующее сообщение.

Формат задания настройки — boolean.

Значение по умолчанию — false.

metrics_format#

Параметр задает формат метрик.

На данный момент поддерживается только формат Prometheus.

См. официальную документацию Prometheus для более подробной информации.

Формат задания настройки — string.

Значение по умолчанию — prometheus.

extra_labels#

Параметр задает пользовательские типы лейблов.

Формат задания настройки — label_name=label_value.

Значение по умолчанию не задано.

Прочие#

luna_accounts_active_plugins#

Параметр задает список плагинов, которые должен использовать сервис.

Имена задаются в следующем формате:

[   
   "plugin_1",
   "plugin_2",
   "plugin_3"   
]

Список должен содержать имена файлов без расширения (.py).

Формат задания настройки — integer.

Значение по умолчанию — 1.

storage_time#

Параметр задает формат времени, используемый для записей в базе данных. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

Настройки сервиса Remote SDK#

Данный раздел описывает параметры сервиса Remote SDK.

Настройку сервиса можно выполнить с помощью сервиса Configurator.

Группа параметров LUNA_CONFIGURATOR#

Данная группа параметров задаёт настройки подключения сервиса Remote SDK к сервису Configurator.

Данная группа параметров не будет видна в пользовательском интерфейсе сервиса Configurator. Параметры можно изменить только в конфигурационном файле "config.conf", расположенном в директории "/srv/luna_remote_sdk/configs/" соответствующего контейнера.

use_configurator#

Параметр позволяет включить использование сервиса Configurator.

С помощью сервиса Configurator упрощается настройка сервисов LP. Сервис сохраняет все необходимые конфигурации для всех сервисов LP в одном месте.

При отключенном параметре будут использованы настройки из файла "config.conf", расположенного в директории "/srv/luna_remote_sdk/configs/" соответствующего контейнера.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

luna_configurator_origin#

Параметр задает протокол, IP адрес и порт сервиса Configurator.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5070.

luna_configurator_api#

Параметр задает версию API сервиса Configurator. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_MONITORING#

Данная группа параметров задает настройки мониторинга.

См. подробную информацию о мониторинге в разделе "Мониторинг".

storage_type#

Тип хранилища для хранения данных мониторинга.

В настоящее время доступно только БД Influx.

Формат задания настройки — string.

Значение по умолчанию — influx.

send_data_for_monitoring#

Параметр позволяет включить или отключить отправку данных для мониторинга в InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 1.

use_ssl#

Параметр позволяет использовать HTTPS для подключения к InfluxDB.

Формат задания настройки — integer.

Значение по умолчанию — 0.

organization#

Параметр задает рабочую область InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna.

token#

Параметр задает аутентификации InfluxDB 2.x.

Формат задания настройки — string.

bucket#

Параметр задаёт имя бакета InfluxDB 2.x.

Формат задания настройки — string.

Значение по умолчанию — luna_monitoring.

host#

Параметр задаёт IP-адрес InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 127.0.0.1.

port#

Параметр задает порт InfluxDB.

Формат задания настройки — string.

Значение по умолчанию — 8086.

flushing_period#

Параметр задает частоту отправки данных мониторинга в InfluxDB.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 1.

Группа параметров LUNA_REMOTE_SDK_LOGGER#

Данная группа параметров задает настройки логирования.

log_level#

Параметр задает уровень отладочной печати, по приоритету: "ERROR", "WARNING", "INFO", "DEBUG".

Формат задания настройки — string.

Значение по умолчанию — INFO.

log_time#

Параметр задает формат времени, используемый в записях лога. Доступны следующие значения:

"LOCAL" — отображает местное время системы, на которой выполняется запись логов;
"UTC" — отображает координированное всемирное время, которое является стандартом времени и не зависит от местной временной зоны или сезонных изменений времени.

Формат задания настройки — string.

Значение по умолчанию — LOCAL.

log_to_stdout#

Параметр позволяет отправлять логи в стандартный вывод (stdout).

Формат задания настройки — boolean.

Значение по умолчанию — true

log_to_file#

Параметр позволяет сохранять логи в файл. Директория с файлами логов указывается в параметре "folder_with_logs".

Формат задания настройки — boolean.

Значение по умолчанию — false.

folder_with_logs#

Параметр задает директорию, в которой хранятся логи. Относительный путь начинается с каталога с приложением.

Для использования данного параметра требуется включить параметр "log_to_file".

Формат задания настройки — string.

Значение по умолчанию — ./

Пример:

"folder_with_logs": "/srv/logs"

max_log_file_size#

Параметр задает максимальный размер файла лога в МБ перед выполнением его ротации (0 — не использовать ротацию).

Для использования данного параметра требуется включить параметр "log_to_file".

При необходимости можно настроить ротацию логов Docker. См. раздел "Настройка ротации логов Docker" в руководстве по установке LUNA PLATFORM.

Формат задания настройки — integer.

Значение по умолчанию — 1024

multiline_stack_trace#

Параметр включает многострочную трассировку стека в логах. Когда параметр включен, информация о стеке вызовов записывается в логах так, что каждый фрейм стека помещается на отдельной строке, что улучшает читаемость. Если параметр выключен, информация о стеке вызовов записывается на одной строке, что может сделать логи менее удобными для анализа.

Формат задания настройки — boolean.

Значение по умолчанию — true.

format#

Параметр определяет формат выводимых логов. Доступны следующие значения:

"default" — стандартный формат вывода логов LUNA PLATFORM
"json" — вывод логов в формате json
"ecs" — вывод логов в формате ECS (Elastic Common Schema)

При использовании значения "ecs" будут использоваться следующие поля:

"http.response.status_code" — содержит код состояния ответа HTTP (200, 404, 500 и т.д.);
"http.response.execution_time" — содержит информацию о времени, затраченном на выполнение запроса и получение ответа;
"http.request.method" — содержит метод HTTP-запроса (GET, POST, PUT и т.д.);
"url.path" — содержит путь в URL-адресе запроса;
"error.code" — содержит код ошибки, если запрос завершается с ошибкой.

Формат задания настройки — string.

Значение по умолчанию — default.

Группа параметров LUNA_LICENSES_ADDRESS#

Данная группа параметров задает настройки подключения к сервису Licenses.

origin#

Параметр задает протокол, IP адрес и порт сервиса Licenses.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Licenses, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Licenses.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5120.

api_version#

Параметр задает версию API сервиса Licenses. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО лиц.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-samples.

Группа параметров LUNA_IMAGE_STORE_FACES_SAMPLES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему БО лиц.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему БО лиц. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения БО тел.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-bodies-samples.

Группа параметров LUNA_IMAGE_STORE_BODIES_SAMPLES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему БО тел.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему БО тел. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_IMAGES_ADDRESS#

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

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Параметр задает имя бакета.

См. подробное описание бакетов в разделе "Описание бакетов".

Формат задания настройки — string.

Значение по умолчанию — visionlabs-image-origin.

Группа параметров LUNA_IMAGE_STORE_IMAGES_TIMEOUTS#

Данная группа параметров определяет временные интервалы для управления таймаутами HTTP-запросов, которые направляются к бакету, хранящему исходных изображений.

connect#

Параметр задает таймаут для установки соединения при отправке HTTP-запроса к бакету, хранящему исходных изображений. Это время ожидания, в течение которого клиент пытается установить соединение с бакетом.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 30.

request#

Параметр задает общий таймаут для выполнения всего HTTP-запроса. Он включает в себя время установки соединения, отправки запроса, получения ответа и закрытия соединения. Если весь процесс занимает больше времени, чем указано в этом параметре, то запрос будет прерван.

Формат задания настройки — integer (секунды).

Значение по умолчанию — 60.

Группа параметров LUNA_IMAGE_STORE_OBJECTS_ADDRESS#

В данной группе параметров задаются настройки бакета для хранения объектов.

origin#

Параметр задает протокол, IP адрес и порт сервиса Image Store.

IP адрес "127.0.0.1" означает, что будет использоваться сервис Image Store, расположенный на сервере с Configurator. Если сервис находится на ином сервере, то в данном параметре нужно указать корректный IP адрес сервера с запущенным сервисом Image Store.

Формат задания настройки — string.

Значение по умолчанию — http://127.0.0.1:5020.

api_version#

Параметр задает версию API сервиса Image Store. Доступная версия API — "1".

Формат задания настройки — integer.

Значение по умолчанию — 1.

bucket#

Включение/отключение данного сервиса может повлиять на работу других сервисов.

См. подробную информацию в разделе "Отключаемые сервисы".

В руководстве по установке приведен раздел "Использование необязательных сервисов", описывающий настройку использования необязательных сервисов перед запуском LUNA PLATFORM.

Формат задания настройки — integer ("0" или "1").

Значение по умолчанию — 1.

Группа параметров LUNA_REMOTE_SDK_RUNTIME_SETTINGS#

Данная группа параметров задает глобальные настройки для всех эстиматоров/детекторов.

global_device_class#

Параметр задает тип устройства ("cpu" или "gpu") для всех эстиматоров/детекторов, у которых значение параметра "device_class" = "global".

Формат задания настройки — string.

Значение по умолчанию — cpu.

num_threads#

Параметр задает количество рабочих потоков CPU-процессора, которые будут использоваться сервисом при выполнении эстимации/детекции. Желательно, чтобы значение этого параметра соответствовало числу физических ядер процессора для достижения максимальной производительности. Однако, слишком большое число потоков может привести к ухудшению производительности из-за дополнительных накладных расходов.

Формат задания настройки — integer.

Значение по умолчанию — 4.

num_compute_streams#

Параметр задает количество потоков вычислений на GPU-процессоре, которые будут использоваться сервисом при выполнении эстимации/детекции. Рекомендуется выбирать значение, соответствующее характеристикам конкретного GPU и задаче. Стоит учитывать, что NVIDIA может изменять поведение этого параметра в различных версиях программного обеспечения, поэтому рекомендуется проводить тестирование для определения оптимального значения.

Формат задания настройки — integer.

Значение по умолчанию — 6.

Группа параметров LUNA_REMOTE_SDK_FACE_DETECTOR_SETTINGS#

Данная группа параметров задает индивидуальные настройки работы детектора лица.

runtime_settings > device_class#

Параметр задает тип устройства для выполнения оценки ("cpu", "gpu" или "global")

Формат задания настройки — string.

Значение по умолчанию — cpu.

runtime_settings > num_threads#

Параметр задает размер батча для выполнения оценки.

Формат задания настройки — integer.

Значение по умолчанию — 10.

runtime_settings > num_compute_streams#

Параметр задает количество "рабочих процессов" для выполнения оценки.

Формат задания настройки — integer.

Значение по умолчанию — 1.

estimator_settings > min_face_size#

Параметр задает минимальный размер лица в пикселях.

Максимальный размер лица равен минимальному размеру лица, умноженному на 32.

Формат задания настройки — integer.

Значение по умолчанию — 50.

estimator_settings > redetect_face_target_size#

Параметр задает целевой размер лица для повторной детекции.

Формат задания настройки — integer.

Значение по умолчанию — 80.

estimator_settings > redetect_tensor_size#

Параметр задает целевой размер лица для повторной детекции после предварительной обработки.

Детекция считается неудачной, если оценка ниже указанного значения.

Формат задания настройки — integer.

Значение по умолчанию — 64.

estimator_settings > redetect_score_threshold#

Параметр задает порог оценки повторной детекции.

Повторная детекция считается неудачной, если оценка ниже указанного значения.

Формат задания настройки — number.

Значение по умолчанию — 0.3.

estimator_settings > score_threshold#

runtime_settings > num_compute_streams#

Параметр задает количество "рабочих процессов" для выполнения оценки.

Формат задания настройки — integer.

Значение по умолчанию — 1.

estimator_settings > real_threshold#

Параметр задает порог "Liveness threshold", ниже которого система будет считать результат атакой на биометрическое предъявление и будет выдан результат "spoof".

Формат задания настройки — float.

Значение по умолчанию — 0.5.

Группа параметров LUNA_REMOTE_SDK_GLASSES_ESTIMATOR_SETTINGS#

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

runtime_settings > device_class#

Параметр задает тип устройства для выполнения оценки ("cpu", "gpu" или "global")

Формат задания настройки — string.

Значение по умолчанию — cpu.

runtime_settings > num_threads#

Параметр задает размер батча для выполнения оценки.

Формат задания настройки — integer.

Значение по умолчанию — 10.

runtime_settings > num_compute_streams#

Параметр задает количество "рабочих процессов" для выполнения оценки.

Формат задания настройки — integer.

Значение по умолчанию — 1.

Группа параметров LUNA_REMOTE_SDK_FACE_WARP_ESTIMATOR_SETTINGS#

Данная группа параметров задает индивидуальные настройки работы эстиматора биометрического образца лица.

runtime_settings > device_class#

Параметр задает тип устройства для выполнения оценки ("cpu", "gpu" или "global")

Формат задания настройки — string.

Значение по умолчанию — cpu.

runtime_settings > num_threads#

Параметр задает размер батча для выполнения оценки.

Формат задания настройки — integer