Обновить конфигурацию логирования: Server.SetLog

Метод и параметры

Метод обновляет конфигурацию логирования в runtime.

string Server.SetLog (StdoutObject stdout, FileObject file, RemoteObject remote, SyslogObject syslog)

Параметры метода

StdoutObject stdout – задает конфигурацию логирования в stdout.

object StdoutObject

string stdout.pattern = [%Timestamp] %Message – паттерн для логирования. Допустимые флаги:

%Timestamp – время сообщения
AppId – идентификатор компонента
Tag – идентификатор экземпляра компонента
%Verbose – уровень логирования
%Message – непосредственно само сообщение
%EscMessage – экранированное сообщение с escape-символами, используется для json-паттернов

string stdout.tag = media-server – глобальный тэг для логирования

number stdout.verbose = 3 – уровень логирования

FileObject file – задает конфигурацию логирования в файл

object FileObject

number file.number = 3 – количество файлов логирования

string file.path = /tmp/test.log – путь к файлу логирования

string file.pattern = [%Timestamp] %Message – паттерн для логирования

number file.rotate = 8192 – количество байт для ротации файла

string file.tag = media-server – глобальный тэг для логирования

number file.verbose = 3 – уровень логирования

RemoteObject remote – задает конфигурацию удаленного логирования

object RemoteObject

url remote.path = udp://localhost:8109 – адрес удаленного логгера для отправки сообщений

string remote.pattern = {"tag":"%Tag","verbose":"%Verbose","timestamp":"%Timestamp","app_id":"%AppId","message":"%EscMessage"} – паттерн для логирования

string remote.tag = media-server– глобальный тэг для логирования

number remote.verbose = 3– уровень логирования

SyslogObject syslog – задает конфигурацию логирования в syslog

object SyslogObject

string syslog.facility = local0 – категория сообщения

string syslog.pattern = [%Timestamp] %Message – паттерн для логирования

string syslog.tag = media-server – глобальный тэг для логирования

number syslog.verbose = 3 – уровень логирования

POST /api/

JSON-RPC

JSON

{
    "jsonrpc": "2.0",
    "method": "Server.SetLog",
    "params": {
        "stdout": {
            "tag": "media-server",
            "verbose": 3,
            "pattern": "[%Timestamp] %Message"
        },
        "file": {
            "tag": "media-server",
            "verbose": 3,
            "pattern": "[%Timestamp] %Message",
            "path": "/tmp/test.log",
            "rotate": 8192,
            "number": 3
        },
        "remote": {
            "tag": "media-server",
            "verbose": 3,
            "pattern": "{\"tag\":\"%Tag\",\"verbose\":\"%Verbose\",\"timestamp\":\"%Timestamp\",\"app_id\":\"%AppId\",\"message\":\"%EscMessage\"}",
            "path": "udp://localhost:8109"
        },
        "syslog": {
            "tag": "media-server",
            "verbose": 3,
            "pattern": "[%Timestamp] %Message",
            "facility": "local0"
        }
    },
    "id": 1
}

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/' \
	--header 'Content-Length: 913' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--header 'Authorization: Bearer <api-authorization-token>' \
	--header 'Content-Length: <Длина данных>' \
	--data '{
    "jsonrpc": "2.0",
    "method": "Server.SetLog",
    "params": {
        "stdout": {
            "tag": "media-server",
            "verbose": 3,
            "pattern": "[%Timestamp] %Message"
        },
        "file": {
            "tag": "media-server",
            "verbose": 3,
            "pattern": "[%Timestamp] %Message",
            "path": "/tmp/test.log",
            "rotate": 8192,
            "number": 3
        },
        "remote": {
            "tag": "media-server",
            "verbose": 3,
            "pattern": "{\"tag\":\"%Tag\",\"verbose\":\"%Verbose\",\"timestamp\":\"%Timestamp\",\"app_id\":\"%AppId\",\"message\":\"%EscMessage\"}",
            "path": "udp://localhost:8109"
        },
        "syslog": {
            "tag": "media-server",
            "verbose": 3,
            "pattern": "[%Timestamp] %Message",
            "facility": "local0"
        }
    },
    "id": 1
}'

PHP

$data = array (
  'jsonrpc' => '2.0',
  'method' => 'Server.SetLog',
  'params' => 
  array (
    'stdout' => 
    array (
      'tag' => 'media-server',
      'verbose' => 3,
      'pattern' => '[%Timestamp] %Message',
    ),
    'file' => 
    array (
      'tag' => 'media-server',
      'verbose' => 3,
      'pattern' => '[%Timestamp] %Message',
      'path' => '/tmp/test.log',
      'rotate' => 8192,
      'number' => 3,
    ),
    'remote' => 
    array (
      'tag' => 'media-server',
      'verbose' => 3,
      'pattern' => '{"tag":"%Tag","verbose":"%Verbose","timestamp":"%Timestamp","app_id":"%AppId","message":"%EscMessage"}',
      'path' => 'udp://localhost:8109',
    ),
    'syslog' => 
    array (
      'tag' => 'media-server',
      'verbose' => 3,
      'pattern' => '[%Timestamp] %Message',
      'facility' => 'local0',
    ),
  ),
  'id' => 1,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'POST',
		'header' => "Content-Type: application/json\r
Accept: application/json\r
Authorization: Bearer <api-authorization-token>\r
Content-Length: <Длина данных>",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/', false, $context);

200 OK

bool – результат выполнения операции

JSON

true

400 Bad Request

Ошибка json-rpc

JSON

{
    "error": {
        "code": -32601,
        "message": "Method not found"
    }
}

500 Internal Server Error

Ошибка сервера