Configuration

All settings are in config/parameters.yml.

Database settings

db:
    host: localhost
    name: pinba
    user: user
    pass: password

In section db you must define database connection settings. Pinboard connects to the same database as Pinba.

Logging

Pinboard can keep a log of slow and heavy requests which displays in sections "Request time" and "Memory peak usage" for each monitoring site.

logging:
    # in seconds
    long_request_time:
        global: 0.5
        "supersite1.com": 0.8
        "superfastsite2.com": 0.3
    # max memory usage in kB
    heavy_request:
        global: 10000
        "coolsite.ru": 5000
        "heavysite.ru": 30000

Parameters global are used as default for all monitoring sites. For example above all requests with execution time more than 0.5 seconds and used memory more than 10000 kB will saved in log.

For any site you can define personal settings by adding corresponding parameters in sections long_request_time and heavy_request.

If no settings in section logging Pinboard uses following parameters:

long_request_time: 0.3
heavy_request: 4000

Pagination

pagination:
    row_per_page: 50

In section pagination you can define number of records per page in sections "Request time", "Memory peak usage" and "Error statuses".

If no settings in section pagination Pinboard uses following parameter:

row_per_page: 50

Security

In section "Security" you can define settings for user authentication and authorization.

secure:
    enable: true
    users:
        username1:
            password: my_sha512_password
        username2:
            password: my_sha512_password
            hosts: '.*mysite.com'

Parameter enable switch on/off the authentication and the authorization on site.

In section users define who has the access to the site.

In section password define user password, the encrypted algorithm is sha512 with 1000 iterations.

In hosts define a regular expression which controls the access to hosts information. By default, the user has the access to all hosts.

There is command which helps you to configure user access. It adds settings to users section.

./console add-user username password [hosts]

For details see chapter Security.