Web Call Server 5.1 - RU
Space shortcuts
Page tree

Versions Compared

Old Version 6

changes.mady.by.user admin

Saved on

compared with

New Version 7

changes.mady.by.user admin

Saved on

Key

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

...

Аттрибут

Значение

Описание

log4j.rootLogger

info, stdout, fAppender

Корневой логгер. 

info - Уровень логгирования INFO. Доступны другие более подробные уровни, например DEBUG и TRACE и менее подробные, например ERROR.

stdout, fAppender - определяют как и куда будут выводиться логи.

log4j.logger.incoming.Publication

info, incoming_publication

Логгер статистики RTMFP-SIP звонков для входящего с SIP сервера трафика.


info - уровень логгирования
incoming_publication - определяют как и куда будут выводиться логи.

log4j.logger.outgoing.Publication

info, outgoing_publication

Логгер статистики RTMFP-SIP звонков для исходящего на SIP сервер трафика.

info - уровень логгирования
outgoing_publication - определяют как и куда будут выводиться логи.

log4j.logger.pushLogs.FlashphonerHandler

Не используется

Не используется

log4j.additivity.incoming.Publication

false

Не дублировать данные логи в общий лог, а писать в отдельные

log4j.additivity.outgoing.Publication

false

Не дублировать данные логи в общий лог, а писать в отдельные

log4j.logger.sipMessages

DEBUGdebug

Выводить входящие и исходящие SIP сообщения в лог

log4j.logger.WSServerHandlertraceВыводить исходящие Websocket сообщения в лог
log4j.logger.WSClientdebugВыводить входящие Websocket сообщения в лог

log4j.appender.stdout

org.apache.log4j.ConsoleAppender

Вывод логов в stdout

log4j.appender.fAppender

org.apache.log4j.DailyRollingFileAppender

Вывод логов в fAppender

log4j.appender.incoming_publication

org.apache.log4j.DailyRollingFileAppender

Вывод статистики RTMFP в incoming_publication

log4j.appender.outgoing_publication

org.apache.log4j.DailyRollingFileAppender

Вывод статистики RTMFP в outgoing_publication

log4j.appender.clientLog

org.apache.log4j.DailyRollingFileAppender

Не используется

...

WCS автоматически подхватывает изменения, сделанные в файле log4j.properties. Это удобно для целей отладки и получения дополнительных логов без перезагрузки сервера. Например, в том случае если требуется включить более подробные логи или изменить формат вывода логов. Однако для большей надежности в production все же рекомендуется выполнить перезагрузку WCS-сервера.

Трассировка Websocket сообщений

В целях отладки или разработки собственного API, может быть включена трассировка всех Websocket сообщений, кроме транспортных. Для того, чтобы логировать все входящие/исходящие Websocket сообщения в файл websocket.log в каталоге /usr/local/FlashphonerWebCallServer/logs/server_logs, необходимо добавить в файл log4j.properties следующие строки:

Code Block
languagejava
themeRDark
log4j.logger.WSServerHandler=trace, wsAppender
log4j.logger.WSClient=debug, wsAppender
log4j.appender.wsAppender=org.apache.log4j.DailyRollingFileAppender
log4j.appender.wsAppender.DatePattern='.'yyyy-MM-dd-HH
log4j.appender.wsAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.wsAppender.layout.ConversionPattern=%d{HH:mm:ss,SSS} %-5p %20.20c{1} - %t %m%n
log4j.appender.wsAppender.File=${com.flashphoner.fms.AppHome}/logs/server_logs/websocket.log

Клиентские логи

Клиентские логи - это логи на сервере, которые относятся к сессии web-клиента. Клиентские логи в client_logs пишутся только тогда, когда включена настройка enable_extended_logging=true. Управлять уровнем логгирования можно настройкой client_log_level, которая может принимать значения ERROR, INFO, DEBUG, TRACE.

...

Code Block
languagebash
themeRDark
3000;3001;f294f6116bf2cc4c725f20457ed76e5b@192.168.56.2;2014-11-21 15:01:37; 2014-11-21 15:01:41; 2014-11-21 15:02:45;64;ANSWERED



Поле

Описание

src

Инициатор звонка

dst

Принимающий звонок

cid

Идентификатор звонка

start

Начало звонка (дата и время).

answer

Дата и время ответа абонента или SIP стороны.

end

Дата и время завершения звонка

billsec

Время в секундах между 'answer' и 'end'.

disposition

Результат звонка: ANSWERED, NO_ANSWER, BUSY, FAILED.

MDR-логи

Message Detail Record - это журнал SIP-сообщений.

...

Code Block
languagebash
themeRDark
Fri Dec 26 15:26:16 NOVT 2014,null,A006,A005,RECEIVED

...

Поле
Описание
date
Дата и время сообщения
msgId
Идентификатор сообщения. Будет представлен только в message/cpim сообщениях, при isImdnRequired=true (см. документацию Web Call Server - Call Flow, где описаны параметры передаваемых сообщений в методе sendMessage).
from
SIP from
to
SIP to
disposition
Результат сообщения: RECEIVED, SENT, FAILED.
RECEIVED - сообщение получено.
SENT - сообщение отправлено.
FAILED - во время отправки сообщения произошла ошибка.

Вы также можете собирать любую необходимую статистику по сообщениям и их статусам, используя WCS REST API. См. документацию Web Call Server - Call Flow, где перечислены все методы и наборы данных, которые WCS отправляет чрез REST при обработке сообщений.
...
 Code Block
languagebash
themeRDark
2015-11-11 08:36:13;Flash;stream-Bob;5c2d75c0-7d87-421d-aa93-2732c48d8eaa;00:00:48;UNPUBLISHED;;PUBLISH;3;
Поле
Описание
end
Дата и время завершения сессии
mediaProvider
Используемое медиа на WCS JavaScript API: WebRTC, Flash
name
Имя публикуемого / воспроизводимого потока
mediaSessionId
Идентификатор медиа-сессии
duration
Продолжительность сессии
disposition
Как сессия была завершена: UNPUBLISHED, STOPPED, FAILED
UNPUBLISHED - публикация потока была остановлена
STOPPED - воспроизведение потока было остановлено
FAILED - некорректное завершение сессии
info
Если disposition==FAILED, содержит описание причины
type
PUBLISH в случае публикации потока
SUBSCRIBE в случае воспроизведения потока
subscribers
Количество подписчиков в случае публикации потока; 0 в случае воспроизведения потока
CONNDR-логи
Connection Detail Record - это журнал WebSocket сессий.
...
 Code Block
languagebash
themeRDark
2018-04-25 19:29:08;/5.44.168.45:52199/95.191.131.64:8443;DISCONNECTED;Normal disconnect;17;
Поле
Описание
end
Дата и время завершения сессии
mediaSessionId
Идентификатор медиа-сессии
disposition
Как сессия была завершена: DISCONNECTED, FAILED
DISCONNECTED - завершение сессии по инициативе клиента
FAILED - некорректное завершение сессии
info
Содержит описание завершения сессии
duration
Продолжительность сессии