Logging Логгинг

 

Logging Логгинг

Wowza Media Server Pro использует apache.org log4j библиотеку как свой логгинг введение. The log4j logging system provides ample functionality for log formatting, log rolling and log retrieval for most applications. By default, Wowza Media Server Pro is configured to log basic information to the server console and detailed information in the W3C Extended Common Log Format (ECLF) to a log file. The log files are written to the following folder:

[install-dir]/logs

Wowza Media Server Pro логгинг может генерировать следующие лог поля:

date

Дата лог события

time

Время лог события

tz

Временная зона лог события

x-event

Лог событие (см ниже)

x-category

Категория лог события (сервре, vhost, приложение , сессия, поток)

x-severity

Лог аварийных событий (DEBUG, INFO, WARN, ERROR, FATAL)

x-status

Статус лог события (см таблицу ниже)

x-ctx

Экстра сведения в контексте лог события

x-comment

Экстра комментарии о лог событии

x-vhost

Имя виртуального хоста, из которого события генерировались

x-app

Имя приложения, из которого событие было сгенерировано

x-appinst

Имя типового приложения, из которого событие было сгенерировано

x-duration

Время в секундах Время в секундах Time in seconds that this event occurred within the lifetime of the x-category object

s-ip

IP адрес по которому сервер получает это событие

s-port

Номер порта, по которому сервер получает это событие

s-uri

Полная строка соединений, по которой сервер получил данное событие

c-ip

Клиент соединение IP адрес

c-proto

Клиент соединение протокол (rtmp, rtmpe, rtmpt(HTTP-1.1), rtmpte(HTTP-1.1), rtmps(HTTP-1.1))

c-referrer

URL Flash ролика , что инициализирует соединение с сервером

c-user-agent

Версия Flash клиента, что инициализирует соединение с сервером

c-client-id

Клиент ID номер подписанный сервером для соединения

cs-bytes

Общее кол-во байтов переведенных от клиента на сервер ( аккамулятивно )

sc-bytes

Общее кол-во байтов переданных от сервера клиенту (аккамулятивно)

x-stream-id

ID НОМЕРА ПОТОКА ПОДПИСАННЫЕ СЕРВЕРОМ ДЛЯ ОБЪЕКТА ПОТОКА

x-spos

Позиция в миллисекундах для медиа потока

cs-stream-bytes

Общее кол-во байтов переданных из клиента на сервер для потоков x- потоков ID (АККАМУЛЯТИВНО)

 

sc-stream-bytes

Общее кол-во байтов переданных с сервера клиенту для потока x-stream-id (АККАМУЛЯТИВНО)

x-sname

Имя потока x-stream-id

x-sname-query

Запрос параметров потока x-stream-id

x-file-name

Полный путь файла потока x-stream-id

x-file-ext

Расширение файла потока x-stream-id

x-file-size

Размер файла в байтах для потока x-stream-id

x-file-length

Длина файла в секундах потока x-stream-id

x-suri

Полная полоса соединения для потока x-stream-id (включая параметры запроса)

x-suri-stem

Полная полоса соединения для потока x-stream-id (исключая параметры запроса)

x-suri-query

Параметры запроса для полосы соединения

cs-uri-stem

Полная полоса соединения для потока x-stream-id (без параметров запроса )

cs-uri-query

Параметры запроса для потока x-stream-id

 

Wowza Media Server Pro генерирует следующие лог события :

 

comment

 

 

комментарий

server-start

Сервер старт

server-stop

Сервер закрыт

vhost-start

Виртуальный хост старт

vhost-stop

Виртуальный хост закрыт

app-start

Application instance start

app-stop

Application instance shutdown

connect-pending

Запрет разрешения на соединение приложением и менеджером лицензии

connect

Результат соединения

connect-burst

Connection accepted in burst zone

disconnect

Клиент (сессия) разъединение с сервером

play

Проигрыватель стартовал на потоке

pause

Проигрыватель на паузе на потоке

unpause

Проигрыватель отключена пауза на потоке

seek

Seek has occurred on a stream

setstreamtype

Клиентский вызов netConnection.call(“setStreamType”, null, “[streamtype]”);

setbuffertime

Клиенский вызова на NetStream.setBufferTime(сек) залогировано в миллисек

stop

Проигрыватель отключен на потоке

create

Меди поток или данных поток создан

destroy

Медиа или данных поток уничтожен

publish

Старт потока публикации

unpublish

Стоп потока публикации

record

Старт потока записи

recordstop

Стоп потока записи

announce

RTSP Session Description Protocol (SDP) объявление

Wowza Media Server Pro генерирует следующий лог статус обозначения:

100

 

Запрет или ожидание (для разрешения)

200

Успешно

400

Ошибочный запрос

401

Отклонено приложением

413

Отклонено менеджером лицензии

500

Внутренняя ошибка

Wowza Media Server Pro логгинг конфигурирован в conf/log4j.properties файле свойств. Много логов выбора конфигурации доступно в log4j лог системе. Памятка этой секции покрывает базовые свойства для принятия или отключения разных лог полей, событий или категорий. Ниже пример на базовых свойствах log4j.properties файла для Wowza Media Server Pro.

# create log appenders stdout and R

log4j.rootCategory=INFO, stdout, R

# Console appender

log4j.appender.stdout=org.apache.log4j.ConsoleAppender

log4j.appender.stdout.layout=com.wowza.wms.logging.ECLFPatternLayout

log4j.appender.stdout.layout.Fields=x-severity,x-category,x-event,x-ctx,x-comment

log4j.appender.stdout.layout.OutputHeader=false

log4j.appender.stdout.layout.QuoteFields=false

log4j.appender.stdout.layout.Delimeter=space

# Access appender

log4j.appender.R=org.apache.log4j.DailyRollingFileAppender

log4j.appender.R.DatePattern=’.’yyyy-MM-dd

log4j.appender.R.File=${com.wowza.wms.ConfigHome}/logs/wowzamediaserverpro_access.log

log4j.appender.R.layout=com.wowza.wms.logging.ECLFPatternLayout

log4j.appender.R.layout.Fields=x-severity,x-category,x-event;date,time,c-client-id,c-ip,c-port,cs-bytes,sc-bytes,x-duration,x-sname,x-stream-id,sc-stream-bytes,cs-stream-bytes,x-file-size,x-file-length,x-ctx,x-comment

log4j.appender.R.layout.OutputHeader=true

log4j.appender.R.layout.QuoteFields=false

log4j.appender.R.layout.Delimeter=tab

памятка

Всегда направляйте через слеш , ссылаясь на расположение файла (даже в Windows ).

В этом примере лог свойств файла In this example the logging properties file has been simplified to highlight a few key features. Первое заявление в этом файле устанавливает лог уровень на “INFO” и определяет два ампресанда; “stdout” и “R”. Устанавливая лог, уровень на “INFO” конфигурирует лог механизм на строгое соответсвие событий “INFO” или выше. Лог соответсвиея в порядке убывания : DEBUG, INFO, WARN, ERROR и FATAL. Чтобы залогинить все события установите лог событие на уровень “DEBUG”. Затем , сконфигурируйте каждый амперсанд.Важные свойства в этой секции:

[install-dir]/logs/[vhost]/wowzamediaserverpro_access.log

[install-dir]/logs/[vhost]/wowzamediaserverpro_error.log

[install-dir]/logs/[vhost]/wowzamediaserverpro_stats.log

«на-приложение» логгинг будет генерировать :

[install-dir]/logs/[vhost]/[application]/wowzamediaserverpro_access.log

[install-dir]/logs/[vhost]/[application]/wowzamediaserverpro_error.log

[install-dir]/logs/[vhost]/[application]/wowzamediaserverpro_stats.log

Этот метод очень полезен, когда вы предлагаете Wowza Pro server как общий сервис для нескольких пользователей.

Field

разделенные запятыми, список полей к логу

OutputHeader

Буленовские значения (true/false) которые инструктируют лог систему для записи в формате W3C Extended Common Log Format заголовков каждый раз при запуске сервера.

QuoteFields

Буленовские значения Boolean value (true/false) что инструктируют лог систему на заполнение всех полей данных в двойном запросе.

Delimiter

Свойство ограничителя для использования между полями данных . Легальные значения “tab”, “space” или актуальные значения характера ограничителя.

CategoryInclude

Через запятую список лог категорий. Только лог события с указанными категориями будут логиниться.

CategoryExclude

Через запятую список категорий.Только лог события , которые не указаны в данной категории будут логиниться.

EventInclude

Через запятую список лог событий. Только лог события с специфическими именами событий будут логиниться.

EventExclude

Через запятую список лог категорий .Только лог события имена которых не в списке будут логиниться.

Эти свойства позволяют управлять способом, по которому лог информация форматируется и фильтруется. Для более детальной информации как сконфигурировать log4j по специфическим свойствам, таким как прокрутка, лог файла или дополнительным типам амперсандов посетите apache.org сайт на http://logging.apache.org/log4j.

Wowza Pro может также быть сконфигурирован , чтобы генерировать логи на основе: «на- виртуальный хост» и «на-приложение». Эта конфигурация включена, но разкомментирована на дне файла [install-dir]/conf/log4j.properties по умолчанию. Первая разкомментированная секция включает конфигурация «на-приложение» логгинг. Вторая разкомментированная секция включает конфигурацию «на виртуальный хостинг» логгинг. Включите обе эти функции, просто уберите комментарии (“#” значок вначале каждой строки) из секции. На «виртуальный хост» логгинг будет генерировать следующую структуру директорий:

 

Реклама
Logging Логгинг

Добавить комментарий

Заполните поля или щелкните по значку, чтобы оставить свой комментарий:

Логотип WordPress.com

Для комментария используется ваша учётная запись WordPress.com. Выход / Изменить )

Фотография Twitter

Для комментария используется ваша учётная запись Twitter. Выход / Изменить )

Фотография Facebook

Для комментария используется ваша учётная запись Facebook. Выход / Изменить )

Google+ photo

Для комментария используется ваша учётная запись Google+. Выход / Изменить )

Connecting to %s