GetPcrfSessionsStat - Статистика по сессиям на BRAS/PCRF

Общая информация

  1. Команда актуальна, начиная с версии 1.7.

  2. Команда добавлена для отображения открытых на BRAS/PCRF сессиях согласно данным из MongoDB pcrf.session.

Входные параметры

Параметр Значение Формат значения Расшифровка формата Ссылка

type

Типы сессий

total_stored,
expired,
closed_await_delete,
rejected,
accepted,
active,
opened

param

Параметры выборки

NbiParameter

Расшифровка значений типа сессии 'type':

  • total_stored - всего сессий в БД;

  • expired - сессии, время которых (session_timeout) с момента авторизации (auth_date) уже истекло;

  • closed_await_delete - закрытые сессий (stop_date уже известна); сохранены в БД на небольшой срок только для возможности обработать связанный аккаунтинг;

  • rejected - сессии, получившие reject (auth_status = 2) при попытке авторизации;

  • accepted - сессии, получившие accept (auth_status = 1) при авторизации;

  • active - активные сессии (auth_status = 1, stop_date = null);

  • opened - открытые сессии, на которых еще не было попытки авторизации (auth_status = null или auth_status = 0).

Список доступных имен параметров выборки 'param':

  • ap_domain - домен ТД;

  • ap_id - идентификатор ТД;

  • ssid_name - имя SSID;

  • user_name - имя пользователя, используемое при авторизации;

  • user_domain - домен пользователя;

  • nas_ip - IP адрес ESR, обслуживающего сессию;

  • mac - MAC адрес абонента в формате aa:00:99:00:00:ff;

  • tariff - имя тарифа;

  • tariff_domain - домен тарифа;

  • ignore_empty_domain = true - игнорировать отсутствие фильтра ap_domain и не заполнять его значением из роли.

Выходные параметры

Параметр Значение Формат значения

array

Количество сессий по каждому запрошенному типу

NbiRadiusItemGraphArray

code

Код ответа

int

detail

Пояснение к ответу

String

Примеры команд и кодов

Код Описание

0

Успешно
Запрос
<soapenv:Envelope>
   <soapenv:Header/>
   <soapenv:Body>
      <nbi:GetPcrfSessionsStat>
         <nbi:type>active</nbi:type>
         <nbi:type>opened</nbi:type>
         <nbi:param>
            <xsd:name>ap_domain</xsd:name>
            <xsd:value>.root</xsd:value>
         </nbi:param>
         <nbi:param>
            <xsd:name>ssid_name</xsd:name>
            <xsd:value>TEST</xsd:value>
         </nbi:param>
      </nbi:GetPcrfSessionsStat>
   </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope>
   <soapenv:Body>
      <ns:GetPcrfSessionsStatResponse>
         <ns:return>
            <ax21:code>0</ax21:code>
            <ax21:detail/>
            <ax221:array>
               <ax21:item>
                  <ax21:name>active</ax21:name>
                  <ax21:value>10.0</ax21:value>
               </ax21:item>
               <ax21:item>
                  <ax21:name>opened</ax21:name>
                  <ax21:value>20.0</ax21:value>
               </ax21:item>
            </ax221:array>
         </ns:return>
      </ns:GetPcrfSessionsStatResponse>
   </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

10

Нет прав на указанный в списке ключей домен

37

Недопустимые значения параметров из списков 'type', 'param'

281

Недопустимые имена параметров 'type', 'param'

Пример использования

См. также

Вернуться к списку команд
Версия 1.21-2344
Дата публикации 22-12-2021 05:34:48