...
Для применения любых изменений настроек, требуется перезапуск бэкенд-сервера.
Настройка подключения к БД для хранения метрик
Настройка подключения к БД Influx
Для разрешения передачи метрик в БД Influx необходимо указать параметр в файле wcsoam.properties
Code Block | ||
---|---|---|
| ||
influxdbmetric_enabledstore=trueinflux |
Для настройки подключения к БД Influx необходимо указать URL БД. По умолчанию, если БД установлена на том же сервере, URL должен быть указан как
...
Code Block | ||
---|---|---|
| ||
influxdb_database=wcs_oam influxdb_user=root influxdb_password=root |
При большой нагрузке на WCS-сервер и соответствующем объеме входящих метрик рекомендуется подключаться По умолчанию, WCS OAM подключается к БД Influx по UDP:
Code Block | ||
---|---|---|
| ||
influxdb_udp=true influxdb_udp_port=8089 |
...
В этом случае возможны потери значений метрик. Для исключения потерь метрики могут передаваться по HTTP POST запросами вида
Code Block | ||||
---|---|---|---|---|
| ||||
POST /write?u=root&p=root&db=wcs_oam&rp=default&precision=n&consistency=one HTTP/1.1
3-5062030c-9def-49c2-a89e-639d664ab806 AUDIO_CODEC=102i,AUDIO_LOST=3795015i,AUDIO_RATE=137776i,AUDIO_SYNC=123432141899i,seq=26558i 1562263828767000000 |
Переключение на HTTP для записи метрик производится настройкой
Code Block | ||
---|---|---|
| ||
influxdb_udp=false |
В любом случае, выборки метрик осуществляются по HTTP GET запросами вида
Code Block | ||||
---|---|---|---|---|
| ||||
GET /query?u=root&p=root&db=wcs_oam&q=SELECT+*+FROM+%221-89dc5510-a198-11e9-a049-030fe6b5675c%22+order+by+time+desc+limit+10+offset+0 HTTP/1.1 |
Настройка подключения к БД Timescale
Для разрешения передачи метрик в БД Timescale необходимо указать параметр в файле wcsoam.properties
Code Block | ||
---|---|---|
| ||
metric_store=timescale |
Также необходимо указать URL БД и параметры доступа
Code Block | ||
---|---|---|
| ||
timescale.url=jdbc:postgresql://127.0.0.1:5432/wcsstat
timescale.username=wcsoam
timescale.password=wcsoam |
Тонкая настройка
Кэширование записи метрик в БД для снижения нагрузки настраивается при помощи параметра
Code Block | ||
---|---|---|
| ||
timescale_batch_size=1000 |
В этом случае метрики записываются в БД пачками по 1000 значений.
Настройка подключения к БД для хранения статистики
Поддержка хранения статистики включается настройкой
...
- 'wcsoam' - имя базы данных, имя и пароль пользователя, настроенные для Postgresql
Тонкая настройка
При больших нагрузках, может возникнуть необходимость изменения размера очереди на запись в БД. Это можно сделать при помощи настройки
...
По умолчанию, размер очереди установлен в 3000 записей.
Настройка логирования SQL-запросов
При необходимости, в целях отладки может быть включено логирование SQL-запросов следующими настройками в файле wcsoam.properties
Code Block | ||
---|---|---|
| ||
logging.level.org.hibernate.SQL=debug
logging.level.org.hibernate.type.descriptor.sql=trace |
Необходимо отметить, что при использовании TimescaleDB, запись метрик в этом случае также будет логироваться.
Настройка взаимодействия с WCS
...
Для авторизации подключения необходимо указать в файле wcsoam.properties ключ при помощи настройки
Code Block | ||
---|---|---|
| ||
secretsecurity_key=123456789 |
По умолчанию ключ установлен в 123.
...