/domain/<DOMAIN>/tts/properties/ - команды настройки сервиса TTS
В данном разделе описываются команды настройки базового приложения core_trike_tts сервиса TTS, доступные администратору виртуальной АТС.
Таблица 1 — Описание параметров приложения "core_trike_tts" сервиса TTS, доступные администратору виртуальной АТС
Название | Значение по умолчанию | Описание |
---|---|---|
actual_calls_archive_size | 1000 | Количество завершенных вызовов, которое будет хранить сервис service_actual_calls. |
actual_calls_enabled | true | Определяет, включен (true) или выключен (false) сервисе истории вызовов (будет или нет история вызовов сохраняться в базу). |
adaptation | undefined | текущая адаптация |
autoclean_enabled | true | Определяет, активирована ли автоочистка. |
autoclean_start_at | every 1 day at 00:00 | Определяет время и периодичность запуска автоочистки. Задается в следующих видах: - every <N> (day/week/month/year) at <HH:MM>, где <N> — автоочистка будет срабатывать каждые <N> дней (недель, месяцев, лет соответственно) в заданное время с небольшой погрешностью, необходимой, чтобы при большом количестве доменов не создать большую нагрузку на сервер MySQL. Например, значение "every 1 day at 00:00" означает, что автоочистка будет запускаться каждый день около полуночи. - at <DD.MM.YYYY HH:MM:SS> — автоочистка сработает в заданное время, после чего задача автоматически удалится. Например, "at 22.12.2014 15:00:00" означает, что необходимо выполнить очистку 22 декабря 2014 года ровно в 15:00. |
cdr_columns_name | Команда позволяет изменить название колонки <column> на новое | |
cdr_generation_enabled | true | Определяет, включена (true) или выключена (false) запись CDR в БД и генерации CDR-файлов. |
cdr_header | "Eltex SSW cdr" | Если включена опция generate_cdr_without_fields, сюда добавляется кастомное название устройства. |
cdr_field_delimiter | semicolon | Разделитель полей CDR: 0..255 отображает символ, указанyый в формате десятичного ASCII кода. |
cdr_field_delimeter_representation | ppp_hex_representation | Определяет в каком формате будет присутствовать символ - разделитель полей, если он встречается внутри поля: ppp_hex_representation отображает символ в стилистике протокола PPP4 (символ точка с запятой заменится последовательностью 0x3B ); |
cdr_type | normal | Определяет формат создаваемых CDR-файлов: расширенный (extended), обычный (normal) или задаваемый вручную (manual). Расширенный режим отличается от обычного дополнительными полями: - CODEC — список кодеков; - T_DNA — время ожидания ответа абонента при неотвеченном вызове, в секундах. В manual режиме список колонок создаваемого CDR-файла берется из свойства manual_cdr_columns |
cdr_time_rounding | downside | Определяет режим округления времени при записи CDR-файлов. Доступные значения: downside — округление в меньшую сторону путем, берется только прошедшее целое количество секунд (2999мс округляется до 2-x секунд); upside — округление в большую сторону путем. Если количество миллисекунд в последней секунде > 0 — считается эту секунду (1001мс округляется до 2-x секунд); downside_with_delta — округление в меньшую сторону, если количество миллисекунд в последней секунде <= 850, иначе, округляем в большую сторону. Замечание: если весь вызов длился более 200мс, но меньше 1 секунды — то время вызова будет равно 1 секунде; upside_with_delta — округление в большую сторону, если количество миллисекунд в последней секунде >= 330, иначе, округляем в меньшую сторону. Замечание: если весь вызов длился более 200мс, но меньше 1 секунды — то время вызова будет равно 1 секунде; mathematically — математическое округление. Если количество миллисекунд в последней секунде >= 500 — округляем в большую сторону, иначе — в меньшую; millisecond — записываем время в CDR в миллисекундах. |
manual_cdr_columns | type, datetime, okod_a, okod_b, kod_a, kod_b, nai_a, nai_b, n_tr_gr_a, n_tr_gr_b, t_ecd, t_dba, t_dna, cause_isup, cause_int, completind, origin_dig, dialed_dig, actsusb, categ_a, categ_b, place, rec_seq, servuser, servindic, treatment, conn_id, redirected, redirection, orig_called, port_a, port_b, src_ip, dst_ip, src_port, dst_port, media_proxy, codec, diagnostic, domain, cdr_group, signal_src_ip, signal_dst_ip, signal_src_port, signal_dst_port, call_record_a, call_record_b, isup_spc_a, isup_spc_b, isup_dpc_a, isup_dpc_b, isup_ni_a, isup_ni_b, cic_a, cic_b, smg_nai_a, smg_nai_b, date_time, call_duration, type_a, type_b, start_time, end_time, redirect_flag, inf_connection | Задается список колонок, которые будут присутствовать в CDR-файле. При этом колонки будут в том порядке, в каком они заданы. |
enabled | true | Определяет, включен (true) или выключен (false) сервис TTS (история вызовов, запись CDR). |
generate_cdr_without_fields | false | Определяет скрывать ли стандартные заголовки полей в первой строке cdr- файла. |
partial_cdr_timeout | 300 | Период, по истечении которого в базе данных создается запись с информацией о вызове. Также параметр задает периодичность, с которой будут выгружаться "partial CDR", в секундах. |
port_source | iface_name | Формат записи имен интерфейсов: iface_name — в CDR/tollticket будет записано имя интерфейса; iface_id — в CDR/tollticket будет записано id интерфейса. |
purge_older_than | 2 month | Период времени, по истечении которого записи в базе данных будут удалены. Значение может быть задано в часах (hour[s]), днях (day[s]), неделях (week[s]), месяцах (month[s]), годах (year[s]). |
sign_cdr_enabled | false | Опция, при включении которой (значение "true") будет производиться цифровая подпись CDR-файлов и отдельных записей в рамках CDR-файлов. В CDR-файл будет добавлена колонка с именем SIGN, в которой для каждой записи будет прописана её цифровая подпись. Кроме того, в CDR-файле будет создана CDR-запись типа "final", все поля которой, кроме "SIGN", будут пустыми. В поле "SIGN" у данной записи будет подпись всего CDR-файла. |
Набор полей при разных cdr_type:
normal
- type
- datetime
- kod_a
- kod_b
- n_tr_gr_a
- n_tr_gr_b
- t_ecd
- t_dba
- cause_isup
- cause_int
- completind
- dialed_dig
- actsusb
- categ_a
- place
- rec_seq
- servuser
- servindic
- treatment
- conn_id
- redirected
- redirection
- orig_called
- src_ip
- dst_ip
- port_a
- port_b
- diagnostic
extended
- type
- datetime
- kod_a
- kod_b
- n_tr_gr_a
- n_tr_gr_b
- t_ecd
- t_dba
- t_dna
- cause_isup
- cause_int
- completind
- dialed_dig
- actsusb
- categ_a
- place
- rec_seq
- servuser
- servindic
- treatment
- conn_id
- redirected
- redirection
- orig_called
- src_ip
- dst_ip
- port_a
- port_b
- media_proxy
- diagnostic
- codec
manual
- type
- datetime
- okod_a
- okod_b
- kod_a
- kod_b
- nai_a
- nai_b
- n_tr_gr_a
- n_tr_gr_b
- t_ecd
- t_dba
- t_dna
- cause_isup
- cause_int
- completind
- origin_dig
- dialed_dig
- actsusb
- categ_a
- categ_b
- place
- rec_seq
- servuser
- servindic
- treatment
- conn_id
- redirected
- redirection
- orig_called
- port_a
- port_b
- src_ip
- dst_ip
- src_port
- dst_port
- media_proxy
- codec
- diagnostic
- domain
- cdr_group
- signal_src_ip
- signal_dst_ip
- signal_src_port
- signal_dst_port
- call_record_a
- call_record_b
- isup_spc_a
- isup_spc_b
- isup_dpc_a
- isup_dpc_b
- isup_ni_a
- isup_ni_b
- cic_a
- cic_b
- smg_nai_a
- smg_nai_b
- date_time
- call_duration
- type_a
- type_b
- start_time
- end_time
- redirect_flag
- inf_connection
При этом в режиме manual можно менять состав колонок и их порядок
clean
Данной командой восстанавливаются значения заданных параметров по умолчанию.
Путь команды:
/domain/<DOMAIN>/tts/properties/clean
Синтаксис:
clean [<FIELD>] [--force]
Параметры:
<FIELD> - название параметра, значение которого нужно установить по умолчанию, список параметров приведен в таблице 1.
--force - выполнить команду без запроса подтверждения.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/tts/properties/clean adaptation Property adaptation values successfully restored
info
Данная команда служит для просмотра информации о настройках параметров приложения "core_trike_tts" сервиса TTS.
Путь команды:
/domain/<DOMAIN>/tts/properties/info
Синтаксис:
info [<FIELD>]
Параметры:
<FIELD> - название параметра, список параметров приведен в таблице 1.
Пример:
Посмотреть информацию о настройках приложения "core_trike_tts" сервиса TTS для виртуальной АТС "test.domain".
admin@mycelium1@ecss1$ domain/biysk.local/tts/properties/info ┌──────────────────────────────────┬───────────┬────────────────────────────────────────────────────────────────────────────────┐ │ Property │ Domain │ Value │ ├──────────────────────────────────┼───────────┼────────────────────────────────────────────────────────────────────────────────┤ │actual_calls_archive_size │biysk.local│1000 │ │actual_calls_enabled │biysk.local│true │ │adaptation │biysk.local│undefined │ │autoclean_enabled │biysk.local│true │ │autoclean_start_at │biysk.local│every 1 day at 00:00:00 │ │cdr_columns_name │biysk.local│ │ │cdr_field_delimiter │biysk.local│comma (,) │ │cdr_field_delimiter_representation│biysk.local│ppp_hex (';' -> 0x3B) │ │cdr_generation_enabled │biysk.local│true │ │cdr_header │biysk.local│biysk │ │cdr_time_rounding │biysk.local│downside │ │cdr_type │biysk.local│manual │ │enabled │biysk.local│true │ │generate_cdr_without_fields │biysk.local│false │ │manual_cdr_columns │biysk.local│type, datetime, okod_a, okod_b, kod_a, kod_b, nai_a, nai_b, n_tr_gr_a, n_tr_gr_b│ │ │ │, t_ecd, t_dba, t_dna, cause_isup, cause_int, completind, origin_dig, dialed_dig│ │ │ │, actsusb, categ_a, categ_b, place, rec_seq, servuser, servindic, treatment, con│ │ │ │n_id, redirected, redirection, orig_called, port_a, port_b, src_ip, dst_ip, src_│ │ │ │port, dst_port, media_proxy, codec, diagnostic, domain, cdr_group, signal_src_ip│ │ │ │, signal_dst_ip, signal_src_port, signal_dst_port, call_record_a, call_record_b,│ │ │ │ isup_spc_a, isup_spc_b, isup_dpc_a, isup_dpc_b, isup_ni_a, isup_ni_b, cic_a, ci│ │ │ │c_b, smg_nai_a, smg_nai_b, date_time, call_duration, type_a, type_b, start_time,│ │ │ │ end_time, redirect_flag, inf_connection │ │partial_cdr_timeout │biysk.local│3600 │ │port_source │biysk.local│iface_name │ │purge_older_than │biysk.local│2 month │ │sign_cdr_enabled │biysk.local│false │ └──────────────────────────────────┴───────────┴────────────────────────────────────────────────────────────────────────────────┘ [exec at: 04.02.2022 15:30:26, exec time: 38ms, nodes: md1@ecss1 v.3.14.11.41]
Описание таблицы:
- Property - название параметра;
- Domain - имя виртуальной АТС;
- Value - значение параметра.
set
Данной командой выполняется настройка параметров приложения "core_trike_tts" сервиса TTS.
Путь команды:
/domain/<DOMAIN>/tts/properties/set
Синтаксис:
set <FIELD> <VALUE>
Параметры:
<FIELD> - название конфигурируемого параметра, список параметров приведен в таблице 1;
<VALUE> - значение параметра.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/tts/properties/set adaptation default_adaptation Property "adaptation" successfully changed from: undefined to default_adaptation.