Configuration parameters of services

Index Manager service configuration

The section describes the Index Manager service parameters.

You can configure the service using the Configurator service.

LIM_MANAGER_LOGGER section

This section sets the logging settings for the logging.

log_level

The parameter sets the level of debug printing, by priority: "ERROR", "WARNING", "INFO", "DEBUG".

Setting format: string.

Default value: INFO.

log_time

The parameter sets the time format used in log entries. The following values are available:

• "LOCAL" — displays the local time of the system on which the logs are being recorded.
• "UTC" — displays Coordinated Universal Time, which is a time standard and is not affected by local time zones or seasonal time changes.

Setting format: string.

Default value: LOCAL.

log_to_stdout

The parameter enables you to send logs to standard output (stdout).

Setting format: boolean.

Default value: true

log_to_file

The parameter enables you to save logs to a file. The directory with log files is specified in the "folder_with_logs" parameter.

Setting format: boolean.

Default value: false.

folder_with_logs

The parameter sets the directory in which logs are stored. The relative path starts from the application directory.

To use this parameter, you must enable the "log_to_file" parameter.

Setting format: string.

Default value: ./

Example:

"folder_with_logs": "/srv/logs"

max_log_file_size

The parameter sets the maximum size of the log file in MB before performing its rotation (0 — do not use rotation).

To use this parameter, you must enable the "log_to_file" parameter.

If necessary, you can configure Docker log rotation. See the section "Docker log rotation" in the LUNA PLATFORM installation manual.

Setting format: integer.

Default value: 1024

multiline_stack_trace

The parameter enables multi-line stack tracing in logs. When the parameter is enabled, information about the call stack is recorded in the logs so that each stack frame is placed on a separate line, which improves readability. If the parameter is disabled, information about the call stack is recorded on one line, which may make logs less convenient for analysis.

Setting format: boolean.

Default value: true.

format

The parameter defines the format of the output logs. The following values are available:

• "default" — standard output format of the LUNA PLATFORM logs.
• "json" — output of logs in json format.
• "ecs" — output of logs in ECS format (Elastic Common Schema).

When using the "ecs" value, the following fields will be used:

• "http.response.status_code" — contains the HTTP response status code (e.g., 200, 404, 500, etc.).
• "http.response.execution_time" — contains information about the time taken to execute the request and receive the response.
• "http.request.method" — contains the HTTP request method (GET, POST, PUT, etc.).
• "url.path" — contains the path in the request's URL.
• "error.code" — contains the error code if the request results in an error.

Setting format: string.

Default value: default.

LIM_MANAGER_INDEXING section

This section sets the indexing settings set by the Index Manager service.

indexer_origins

The parameter sets the list of addresses of running instances of the Indexer service.

Setting format: array > string.

Default value: http://127.0.0.1:5180.

planning_period

The parameter sets the period of the planning routine, which checks the sets of lists that need to be indexed.

If the "planning_schedule" parameter is set, the "planning_period" parameter will be ignored.

If both parameters are set, then the "planning_schedule" parameter will take precedence.

Setting format: integer (seconds).

Default value: 600.

planning_schedule

The parameter sets the schedule for the planning routine in Cron format, which checks the sets of lists that need to be indexed.

Using a schedule provides accurate knowledge of the indexing execution time compared to periodic runs every few hours or minutes. This ensures a more predictable and controlled execution of indexing, as well as avoids time shifts that can occur with periodic runs. For example, if the service is unavailable or other issues arise, a periodic run may be skipped, which can disrupt the index update plans. However, it is important to consider that periodic runs also have their advantages. For instance, if the aim is to update the index every hour without the need for complex scheduling configurations.

For example, the value "0 0 * * 0 " means that indexing will be performed at 00:00 every Sunday.

If the "planning_schedule" parameter is set, the "planning_period" parameter will be ignored.

If both parameters are set, then the "planning_schedule" parameter will take precedence.

Setting format: string (Cron-like).

Default value is not set.

lookup_period

The parameter sets the period of the search routine, which checks the statuses of all running Indexer instances.

Setting format: integer (seconds).

Default value: 5.

face_lists > min_indexing_list_size

The parameter sets the minimum number of faces in the lists for the list to be indexed.

The parameter is used only when using the parameter "indexing_lists" with the value "dynamic".

Setting format: integer.

Default value: 50000.

face_lists > indexing_lists

The parameter sets a set of lists for indexing.

You can either specify lists explicitly or specify the value "dynamic". In the latter case, all lists will be processed whose number of face descriptors exceeds the number specified in the "min_indexing_list_size" parameter.

Setting format: array > string.

Default value: dynamic.

ef_construction

The parameter sets a limit on the number of nearest neighbors considered when constructing the index.

Higher values result in a more accurate graph, but it takes longer to build.

It is recommended to change the parameter together with the "ef_search" parameter of the Indexed Matcher service.

Setting format: integer.

Default value: 1600.

LIM_MANAGER_HTTP_SETTINGS section

This section contains parameters responsible for process HTTP connections. More detail see here.

request_timeout

The parameter sets the duration of time between the instant when a new open TCP connection is passed to the server, and the instant when the whole HTTP request is received.

Setting format: integer (seconds).

Default value: 60.

response_timeout

The parameter sets the duration of time between the instant the server passes the HTTP request to the app, and the instant a HTTP response is sent to the client.

Setting format: integer (seconds).

Default value: 600.

request_max_size

The parameter sets the maximum size of the request.

Setting format: integer (bytes).

Default value: 1073741824.

keep_alive_timeout

The parameter sets the timeout for maintaining HTTP activity.

Setting format: integer (seconds).

Default value: 15.

LIM_MANAGER_DB section

In this section, the settings for connecting to the database of the Index Manager service are set.

db_user

The parameter sets the name of the Redis database user.

Setting format: string.

Default value is not set.

db_password

This parameter sets the password of the Redis database user.

Setting format: string.

Default value is not set.

db_host

The parameter sets the host of the Redis database.

Setting format: string.

Default value: 127.0.0.1.

db_port

The parameter sets the port of the Redis database.

Setting format: string.

Default value: 6379.

db_settings > connection_pool_size

This parameter sets the size of the pool of connections to the Redis database.

Setting format: string.

Default value: 100.

db_number

The parameter sets the number of the Redis database. Each number corresponds to a separate database, which enables you to separate the data.

Setting format: integer.

Default value: 0.

sentinel > master_name

The parameter sets the name of the Redis database master, which is monitored and managed by the Sentinel system.

Setting format: string.

Default value: index_manager.

sentinel > sentinels

The parameter sets the list of addresses and ports of Sentinel servers that will be used by clients to detect and monitor the Redis database.

Setting format: list > string.

Default value: [].

sentinel > user

The parameter sets the user name of the Sentinel server.

Setting format: string.

Default value: Not specified.

sentinel > password

The parameter sets the password of the Sentinel server user.

Setting format: string.

Default value: Not specified.

INFLUX_MONITORING section

In this section, settings for monitoring are set.

For more information about monitoring, see "Monitoring" section.

send_data_for_monitoring

The parameter enables you to enable or disable sending monitoring data to InfluxDB.

Setting format: integer.

Default value: 1.

use_ssl

The parameter enables you to use HTTPS to connect to InfluxDB.

Setting format: integer.

Default value: 0.

organization

The parameter sets InfluxDB workspace.

Setting format: string.

Default value: luna.

token

The parameter sets InfluxDB authentication token.

Setting format: string.

bucket

The parameter sets InfluxDB bucket name.

Setting format: string.

Default value: luna_monitoring.

host

The parameter sets IP address of server with InfluxDB.

Setting format: string.

Default value: 127.0.0.1.

port

The parameter sets InfluxDB port.

Setting format: string.

Default value: 8086.

flushing_period

The parameter sets frequency of sending monitoring data to InfluxDB.

Setting format: integer (seconds).

Default value: 1.

LUNA_FACES_ADDRESS section

This section sets the connection settings for the Faces service.

origin

The parameter sets the protocol, IP address and port of the Faces service.

The IP address "127.0.0.1" means that the Faces service located on the server with Configurator will be used. If the service is located on another server, then in this parameter you need to specify the correct IP address of the server with the Faces service running.

Setting format: string.

Default value: http://127.0.0.1:5030.

api_version

The parameter sets the version of the Faces service. The available API version is "3".

Setting format: integer.

Default value: 3.

LUNA_FACES_TIMEOUTS section

This section sets time intervals for managing the timeouts of HTTP requests that are sent to the Faces service.

connect

The parameter sets the timeout for establishing a connection when sending an HTTP request to the Faces service. This is the timeout during which the client tries to establish a connection with the service.

Setting format: integer (seconds).

Default value: 20.

request

The parameter sets a general timeout for the entire HTTP request. It includes the time to establish a connection, send a request, receive a response, and close the connection. If the entire process takes longer than specified in this parameter, the request will be aborted.

Setting format: integer (seconds).

Default value: 60.

sock_connect

The parameter sets the timeout for establishing a connection at the socket level. If the socket level connection is not established at the set time, the operation will be aborted.

Setting format: integer (seconds).

Default value: 10.

sock_read

The parameter sets the timeout for reading data from the socket after a successful connection. If the data does not arrive at the set time, the read operation will be interrupted.

Setting format: integer (seconds).

Default value: 60.

LUNA_SERVICE_METRICS section

This section enables and configures the collection of metrics in the Prometheus format.

See "Monitoring" for details.

enabled

The parameter enables metrics collection.

If metrics collection is disabled, a request to the /metrics resource will return an appropriate message.

Setting format: boolean.

Default value: false.

metrics_format

The parameter sets the metrics format.

Currently only the Prometheus format is supported.

See the official Prometheus documentation for more details.

Setting format: string.

Default value: prometheus.

extra_labels

The parameter specifies custom label types.

Setting format: label_name=label_value.

Default value is not set.

Other

index_storage_type

The parameter sets the type of index storage. Currently, only the "LOCAL" option is available.

The value "LOCAL" means that the indexes will be stored in the directory specified in the "index_storage_local" parameter.

Setting format: string.

Default value: LOCAL.

index_storage_local

The parameter sets the directory for storing indexes with "LOCAL" storage type.

Setting format: string.

Default value: ./local_storage.

storage_time

The parameter sets the time format used for records in the database. The following values are available:

• "LOCAL" — displays the local time of the system on which logs are being recorded.
• "UTC" — displays coordinated universal time, which is a standard time and does not depend on the local time zone or seasonal time changes.

Setting format: string.

Default value: LOCAL.

lim_manager_active_plugins

The parameter sets a list of plugins that the service should use.

The names are given in the following format:

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

The list should contain file names without the extension (.py).

Setting format: integer.

Default value: 1.

default_face_descriptor_version

The parameter sets the version of the face descriptor to use.

Setting format: string.

Default value: 59.

Indexed Matcher service configuration

The section describes the Indexed Matcher service parameters.

You can configure the service using the Configurator service.

LIM_MATCHING section

This section sets the settings for indexed matching.

ef_search

The parameter sets a limit on the considered number of nearest neighbors when searching for an index.

Higher values result in a more accurate but slower search.

It is recommended to change the parameter together with the "ef_construction" parameter of the Indexed Manager service.

Setting format: integer.

Default value: 1600.

LIM_MATCHER_REFRESH section

In this section, the settings for index refreshing in the Indexed Matcher service memory are set.

enabled

The parameter allows you to enable index refreshing.

Setting format: integer.

Default value: 1.

LIM_MATCHER_LOGGER section

This section sets the logging settings for the logging.

log_level

The parameter sets the level of debug printing, by priority: "ERROR", "WARNING", "INFO", "DEBUG".

Setting format: string.

Default value: INFO.

log_time

The parameter sets the time format used in log entries. The following values are available:

• "LOCAL" — displays the local time of the system on which the logs are being recorded.
• "UTC" — displays Coordinated Universal Time, which is a time standard and is not affected by local time zones or seasonal time changes.

Setting format: string.

Default value: LOCAL.

log_to_stdout

The parameter enables you to send logs to standard output (stdout).

Setting format: boolean.

Default value: true

log_to_file

The parameter enables you to save logs to a file. The directory with log files is specified in the "folder_with_logs" parameter.

Setting format: boolean.

Default value: false.

folder_with_logs

The parameter sets the directory in which logs are stored. The relative path starts from the application directory.

To use this parameter, you must enable the "log_to_file" parameter.

Setting format: string.

Default value: ./

Example:

"folder_with_logs": "/srv/logs"

max_log_file_size

The parameter sets the maximum size of the log file in MB before performing its rotation (0 — do not use rotation).

To use this parameter, you must enable the "log_to_file" parameter.

If necessary, you can configure Docker log rotation. See the section "Docker log rotation" in the LUNA PLATFORM installation manual.

Setting format: integer.

Default value: 1024

multiline_stack_trace

The parameter enables multi-line stack tracing in logs. When the parameter is enabled, information about the call stack is recorded in the logs so that each stack frame is placed on a separate line, which improves readability. If the parameter is disabled, information about the call stack is recorded on one line, which may make logs less convenient for analysis.

Setting format: boolean.

Default value: true.

format

The parameter defines the format of the output logs. The following values are available:

• "default" — standard output format of the LUNA PLATFORM logs.
• "json" — output of logs in json format.
• "ecs" — output of logs in ECS format (Elastic Common Schema).

When using the "ecs" value, the following fields will be used:

• "http.response.status_code" — contains the HTTP response status code (e.g., 200, 404, 500, etc.).
• "http.response.execution_time" — contains information about the time taken to execute the request and receive the response.
• "http.request.method" — contains the HTTP request method (GET, POST, PUT, etc.).
• "url.path" — contains the path in the request's URL.
• "error.code" — contains the error code if the request results in an error.

Setting format: string.

Default value: default.

LIM_MATCHER_HTTP_SETTINGS section

This section contains parameters responsible for process HTTP connections. More detail see here.

request_timeout

The parameter sets the duration of time between the instant when a new open TCP connection is passed to the server, and the instant when the whole HTTP request is received.

Setting format: integer (seconds).

Default value: 60.

response_timeout

The parameter sets the duration of time between the instant the server passes the HTTP request to the app, and the instant a HTTP response is sent to the client.

Setting format: integer (seconds).

Default value: 600.

request_max_size

The parameter sets the maximum size of the request.

Setting format: integer (bytes).

Default value: 1073741824.

keep_alive_timeout

The parameter sets the timeout for maintaining HTTP activity.

Setting format: integer (seconds).

Default value: 15.

LIM_MATCHER_DB section

In this section, the settings for connecting to the database of the Index Matcher service are set.

db_user

The parameter sets the name of the Redis database user.

Setting format: string.

Default value is not set.

db_password

This parameter sets the password of the Redis database user.

Setting format: string.

Default value is not set.

db_host

The parameter sets the host of the Redis database.

Setting format: string.

Default value: 127.0.0.1.

db_port

The parameter sets the port of the Redis database.

Setting format: string.

Default value: 6379.

db_settings > connection_pool_size

This parameter sets the size of the pool of connections to the Redis database.

Setting format: string.

Default value: 100.

db_number

The parameter sets the number of the Redis database. Each number corresponds to a separate database, which enables you to separate the data.

Setting format: integer.

Default value: 0.

sentinel > master_name

The parameter sets the name of the Redis database master, which is monitored and managed by the Sentinel system.

Setting format: string.

Default value: indexed_matcher.

sentinel > sentinels

The parameter sets the list of addresses and ports of Sentinel servers that will be used by clients to detect and monitor the Redis database.

Setting format: list > string.

Default value: [].

sentinel > user

The parameter sets the user name of the Sentinel server.

Setting format: string.

Default value: Not specified.

sentinel > password

The parameter sets the password of the Sentinel server user.

Setting format: string.

Default value: Not specified.

INFLUX_MONITORING section

In this section, settings for monitoring are set.

For more information about monitoring, see "Monitoring" section.

send_data_for_monitoring

The parameter enables you to enable or disable sending monitoring data to InfluxDB.

Setting format: integer.

Default value: 1.

use_ssl

The parameter enables you to use HTTPS to connect to InfluxDB.

Setting format: integer.

Default value: 0.

organization

The parameter sets InfluxDB workspace.

Setting format: string.

Default value: luna.

token

The parameter sets InfluxDB authentication token.

Setting format: string.

bucket

The parameter sets InfluxDB bucket name.

Setting format: string.

Default value: luna_monitoring.

host

The parameter sets IP address of server with InfluxDB.

Setting format: string.

Default value: 127.0.0.1.

port

The parameter sets InfluxDB port.

Setting format: string.

Default value: 8086.

flushing_period

The parameter sets frequency of sending monitoring data to InfluxDB.

Setting format: integer (seconds).

Default value: 1.

LUNA_FACES_ADDRESS section

This section sets the connection settings for the Faces service.

origin

The parameter sets the protocol, IP address and port of the Faces service.

The IP address "127.0.0.1" means that the Faces service located on the server with Configurator will be used. If the service is located on another server, then in this parameter you need to specify the correct IP address of the server with the Faces service running.

Setting format: string.

Default value: http://127.0.0.1:5030.

api_version

The parameter sets the version of the Faces service. The available API version is "3".

Setting format: integer.

Default value: 3.

LUNA_FACES_TIMEOUTS section

This section sets time intervals for managing the timeouts of HTTP requests that are sent to the Faces service.

connect

The parameter sets the timeout for establishing a connection when sending an HTTP request to the Faces service. This is the timeout during which the client tries to establish a connection with the service.

Setting format: integer (seconds).

Default value: 20.

request

The parameter sets a general timeout for the entire HTTP request. It includes the time to establish a connection, send a request, receive a response, and close the connection. If the entire process takes longer than specified in this parameter, the request will be aborted.

Setting format: integer (seconds).

Default value: 60.

sock_connect

The parameter sets the timeout for establishing a connection at the socket level. If the socket level connection is not established at the set time, the operation will be aborted.

Setting format: integer (seconds).

Default value: 10.

sock_read

The parameter sets the timeout for reading data from the socket after a successful connection. If the data does not arrive at the set time, the read operation will be interrupted.

Setting format: integer (seconds).

Default value: 60.

LUNA_LICENSES_ADDRESS section

This section sets the connection settings for the Licenses service.

origin

The parameter sets the protocol, IP address and port of the Licenses service.

The IP address "127.0.0.1" means that the Licenses service located on the server with Configurator will be used. If the service is located on another server, then in this parameter you need to specify the correct IP address of the server with the Licenses service running.

Setting format: string.

Default value: http://127.0.0.1:5120.

api_version

The parameter sets the version of the Licenses service. The available API version is "1".

Setting format: integer.

Default value: 1.

LUNA_SERVICE_METRICS section

This section enables and configures the collection of metrics in the Prometheus format.

See "Monitoring" for details.

enabled

The parameter enables metrics collection.

If metrics collection is disabled, a request to the /metrics resource will return an appropriate message.

Setting format: boolean.

Default value: false.

metrics_format

The parameter sets the metrics format.

Currently only the Prometheus format is supported.

See the official Prometheus documentation for more details.

Setting format: string.

Default value: prometheus.

extra_labels

The parameter specifies custom label types.

Setting format: label_name=label_value.

Default value is not set.

Other

lim_matcher_cache

The parameter sets the path to the directory with the cache.

For more information about caching, see "Index caching".

To disable caching, leave the field empty.

Setting format: string.

Default value: not set.

index_storage_type

The parameter sets the type of index storage. Currently, only the "LOCAL" option is available.

The value "LOCAL" means that the indexes will be stored in the directory specified in the "index_storage_local" parameter.

Setting format: string.

Default value: LOCAL.

index_storage_local

The parameter sets the directory for storing indexes with "LOCAL" storage type.

Setting format: string.

Default value: ./local_storage.

lim_matcher_active_plugins

The parameter sets a list of plugins that the service should use.

The names are given in the following format:

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

The list should contain file names without the extension (.py).

Setting format: integer.

Default value: 1.

default_face_descriptor_version

The parameter sets the version of the face descriptor to use.

Setting format: string.

Default value: 59.

Indexer service configuration

The section describes the Indexer service parameters.

You can configure the service using the Configurator service.

LIM_INDEXER_LOGGER section

This section sets the logging settings for the logging.

log_level

The parameter sets the level of debug printing, by priority: "ERROR", "WARNING", "INFO", "DEBUG".

Setting format: string.

Default value: INFO.

log_time

The parameter sets the time format used in log entries. The following values are available:

• "LOCAL" — displays the local time of the system on which the logs are being recorded.
• "UTC" — displays Coordinated Universal Time, which is a time standard and is not affected by local time zones or seasonal time changes.

Setting format: string.

Default value: LOCAL.

log_to_stdout

The parameter enables you to send logs to standard output (stdout).

Setting format: boolean.

Default value: true

log_to_file

The parameter enables you to save logs to a file. The directory with log files is specified in the "folder_with_logs" parameter.

Setting format: boolean.

Default value: false.

folder_with_logs

The parameter sets the directory in which logs are stored. The relative path starts from the application directory.

To use this parameter, you must enable the "log_to_file" parameter.

Setting format: string.

Default value: ./

Example:

"folder_with_logs": "/srv/logs"

max_log_file_size

The parameter sets the maximum size of the log file in MB before performing its rotation (0 — do not use rotation).

To use this parameter, you must enable the "log_to_file" parameter.

If necessary, you can configure Docker log rotation. See the section "Docker log rotation" in the LUNA PLATFORM installation manual.

Setting format: integer.

Default value: 1024

multiline_stack_trace

The parameter enables multi-line stack tracing in logs. When the parameter is enabled, information about the call stack is recorded in the logs so that each stack frame is placed on a separate line, which improves readability. If the parameter is disabled, information about the call stack is recorded on one line, which may make logs less convenient for analysis.

Setting format: boolean.

Default value: true.

format

The parameter defines the format of the output logs. The following values are available:

• "default" — standard output format of the LUNA PLATFORM logs.
• "json" — output of logs in json format.
• "ecs" — output of logs in ECS format (Elastic Common Schema).

When using the "ecs" value, the following fields will be used:

• "http.response.status_code" — contains the HTTP response status code (e.g., 200, 404, 500, etc.).
• "http.response.execution_time" — contains information about the time taken to execute the request and receive the response.
• "http.request.method" — contains the HTTP request method (GET, POST, PUT, etc.).
• "url.path" — contains the path in the request's URL.
• "error.code" — contains the error code if the request results in an error.

Setting format: string.

Default value: default.

INFLUX_MONITORING section

In this section, settings for monitoring are set.

For more information about monitoring, see "Monitoring" section.

send_data_for_monitoring

The parameter enables you to enable or disable sending monitoring data to InfluxDB.

Setting format: integer.

Default value: 1.

use_ssl

The parameter enables you to use HTTPS to connect to InfluxDB.

Setting format: integer.

Default value: 0.

organization

The parameter sets InfluxDB workspace.

Setting format: string.

Default value: luna.

token

The parameter sets InfluxDB authentication token.

Setting format: string.

bucket

The parameter sets InfluxDB bucket name.

Setting format: string.

Default value: luna_monitoring.

host

The parameter sets IP address of server with InfluxDB.

Setting format: string.

Default value: 127.0.0.1.

port

The parameter sets InfluxDB port.

Setting format: string.

Default value: 8086.

flushing_period

The parameter sets frequency of sending monitoring data to InfluxDB.

Setting format: integer (seconds).

Default value: 1.

LUNA_FACES_ADDRESS section

This section sets the connection settings for the Faces service.

origin

The parameter sets the protocol, IP address and port of the Faces service.

The IP address "127.0.0.1" means that the Faces service located on the server with Configurator will be used. If the service is located on another server, then in this parameter you need to specify the correct IP address of the server with the Faces service running.

Setting format: string.

Default value: http://127.0.0.1:5030.

api_version

The parameter sets the version of the Faces service. The available API version is "3".

Setting format: integer.

Default value: 3.

LUNA_FACES_TIMEOUTS section

This section sets time intervals for managing the timeouts of HTTP requests that are sent to the Faces service.

connect

The parameter sets the timeout for establishing a connection when sending an HTTP request to the Faces service. This is the timeout during which the client tries to establish a connection with the service.

Setting format: integer (seconds).

Default value: 20.

request

The parameter sets a general timeout for the entire HTTP request. It includes the time to establish a connection, send a request, receive a response, and close the connection. If the entire process takes longer than specified in this parameter, the request will be aborted.

Setting format: integer (seconds).

Default value: 60.

sock_connect

The parameter sets the timeout for establishing a connection at the socket level. If the socket level connection is not established at the set time, the operation will be aborted.

Setting format: integer (seconds).

Default value: 10.

sock_read

The parameter sets the timeout for reading data from the socket after a successful connection. If the data does not arrive at the set time, the read operation will be interrupted.

Setting format: integer (seconds).

Default value: 60.

LIM_INDEXER_HTTP_SETTINGS section

This section contains parameters responsible for process HTTP connections. More detail see here.

request_timeout

The parameter sets the duration of time between the instant when a new open TCP connection is passed to the server, and the instant when the whole HTTP request is received.

Setting format: integer (seconds).

Default value: 60.

response_timeout

The parameter sets the duration of time between the instant the server passes the HTTP request to the app, and the instant a HTTP response is sent to the client.

Setting format: integer (seconds).

Default value: 600.

request_max_size

The parameter sets the maximum size of the request.

Setting format: integer (bytes).

Default value: 1073741824.

keep_alive_timeout

The parameter sets the timeout for maintaining HTTP activity.

Setting format: integer (seconds).

Default value: 15.

LUNA_SERVICE_METRICS section

This section enables and configures the collection of metrics in the Prometheus format.

See "Monitoring" for details.

enabled

The parameter enables metrics collection.

If metrics collection is disabled, a request to the /metrics resource will return an appropriate message.

Setting format: boolean.

Default value: false.

metrics_format

The parameter sets the metrics format.

Currently only the Prometheus format is supported.

See the official Prometheus documentation for more details.

Setting format: string.

Default value: prometheus.

extra_labels

The parameter specifies custom label types.

Setting format: label_name=label_value.

Default value is not set.

Other

index_storage_type

The parameter sets the type of index storage. Currently, only the "LOCAL" option is available.

The value "LOCAL" means that the indexes will be stored in the directory specified in the "index_storage_local" parameter.

Setting format: string.

Default value: LOCAL.

index_storage_local

The parameter sets the directory for storing indexes with "LOCAL" storage type.

Setting format: string.

Default value: ./local_storage.

lim_indexer_active_plugins

The parameter sets a list of plugins that the service should use.

The names are given in the following format:

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

The list should contain file names without the extension (.py).

Setting format: integer.

Default value: 1.

default_face_descriptor_version

The parameter sets the version of the face descriptor to use.

Setting format: string.

Default value: 59.

Matching plugin configuration

LUNA_INDEXED_LIST_PLUGIN section

This section is responsible for connecting the matching plugin with Redis when calculating matching cost.

It is possible to specify the Redis Sentinel address. See "Use Redis sentinel".

redis_url

The parameter sets the Redis address.

Setting format: string.

Default value: redis://localhost:6379.

request_timeout

The parameter sets the connection timeout to Redis.

Setting format: integer.

Default value: 60.

\