<!-- Source: https://docs.squirro.com/en/latest/technical/admin/configuration/config-files/common-ini.html -->
# common.ini

The `common.ini` config file, located at `/etc/squirro/common.ini` configures common settings for all Squirro services.

For changes in this config file to be considered, all Squirro services must be restarted.

## Logging

The log level can be changed, so that more messages end up in the log files.

This setting is done in the `[logger_root`] section.

|  |  |  |
| --- | --- | --- |
| Key | Usage | Default |
| `level` | Set the log level that is written to the log files. Allowed values: DEBUG, INFO, WARN, ERROR. | INFO |

## Pipeline

Some pipeline settings are configured in the common.ini file. Others can be set in the [ingester.ini](ingester-ini.md#admin-ingester-ini) file.

The following settings are done in the `[pipeline`] section.

|  |  |  |
| --- | --- | --- |
| Key | Usage | Default |
| `step_plumber_timeout_secs` | The maximum duration a request from the `ingester` service to the `plumber` service (`ingester.pipelet_step --> plumber`) can take. When changing this timeout, the nginx configuration also needs to be updated, as there is a separate timeout at play there. For the timeout to take full effect, also edit `/etc/nginx/conf.d/plumber-fastcgi.inc` and adjust the `fastcgi_read_timeout` value. Reload nginx after applying this change with `sudo systemctl reload nginx`. | 3600 |

## Index

The `[index]` section in the common.in file manages certain index settings affecting how data is retrieved from the storage nodes or indexed.

|  |  |  |
| --- | --- | --- |
| Key | Usage | Default |
| `default_abstract_size` | The default length of returned abstract. | 500 |
| `default_limit_size` | Default limit of size of item to get in bytes. In an API call this can be ignored with the parameter `oversize=true`. | 512000 |

## Example Configuration

```ini
[handlers]
keys = file

[logger_root]
handlers = file
level = DEBUG

[handler_file]
dir = /var/log/squirro
args = ('%(dir)s/%(application)s/%(application)s.log', 'a', 52428800, 1)
```
