Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Настройка подключения к БД для хранения метрик

Настройка подключения к БД Influx

Для разрешения передачи метрик в БД Influx необходимо указать параметр в файле wcsoam.properties

Code Block
themeRDark
influxdbmetric_enabledstore=trueinflux

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

...

Code Block
themeRDark
influxdb_database=wcs_oam
influxdb_user=root
influxdb_password=root

При большой нагрузке на WCS-сервер и соответствующем объеме входящих метрик рекомендуется подключаться По умолчанию, WCS OAM подключается к БД Influx по UDP:

Code Block
themeRDark
influxdb_udp=true
influxdb_udp_port=8089

В этом случае возможны потери значений метрик. Для исключения потерь метрики могут передаваться по HTTP POST запросами вида

Code Block
languagejs
themeRDark
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
themeRDark
influxdb_udp=false

В любом случае, выборки метрик осуществляются по HTTP GET запросами вида

Code Block

...

languagejs
themeRDark
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
themeRDark
metric_store=timescale

Также необходимо указать URL БД и параметры доступа

Code Block
themeRDark
timescale.url=jdbc:postgresql://127.0.0.1:5432/wcsstat
timescale.username=wcsoam
timescale.password=wcsoam

Тонкая настройка

Кэширование записи метрик в БД для снижения нагрузки настраивается при помощи параметра

Code Block
themeRDark
timescale_batch_size=1000

В этом случае метрики записываются в БД пачками по 1000 значений.

Настройка подключения к БД для хранения статистики

Поддержка хранения статистики включается настройкой

...

  • 'wcsoam' - имя базы данных, имя и пароль пользователя, настроенные для Postgresql

Тонкая настройка

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

...

По умолчанию, размер очереди установлен в 3000 записей.

Настройка логирования SQL-запросов

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

Code Block
themeRDark
logging.level.org.hibernate.SQL=debug
logging.level.org.hibernate.type.descriptor.sql=trace

Необходимо отметить, что при использовании TimescaleDB, запись метрик в этом случае также будет логироваться.

Настройка взаимодействия с WCS

...