Accounting CLI [Документация VAS Experts]

Accounting CLI

Вывод и управление аккаунтинг-сессиями fastpcrf.

Это команда к fastpcrf, так что в аргументе -r утилиты следует задавать адрес fastpcrf.

pcrf acct show all

Вывод содержимого БД аккаунтинга fastpcrf. Заметим, что наличие записи в выводе этой команды не обязательно означает, что есть активная аккаунтинг-сессия. Если у записи нет атрибута session id, значит, эта запись не является активной.

fdpi_cli pcrf acct show all

pcrf acct show active

Вывод активных сессий БД аккаунтинга fastpcrf. В вывод этой команды попадают активные сессий и сессии, завершенные в ближайшие 5 минут

fdpi_cli pcrf acct show active

pcrf acct show

Вывод аккаунтинг-сессий по указанному ключу

fdpi_cli pcrf acct show [ip=X | session=X | multi_session_id=X | login=X | uid=X]

ключ указывается одним из аргументов:

  • ip - IPv4- или IPv6-адрес абонента
  • session - accounting session-id
  • multi_session_id - accounting multi-session-id
  • login - логин абонента
  • uid - внутренний уникальный идентификатор записи агрегации. Этот id присваивается в момент создания записи и, в отличие от session-id, никогда не изменяется.

Примеры (10.20.98.78 - адрес fastpcrf-сервера):

fdpi_cli -r 10.20.98.78 pcrf acct show ip=192.168.0.25
fdpi_cli -r 10.20.98.78 pcrf acct show ip=2001:5098:89::/64
fdpi_cli -r 10.20.98.78 pcrf acct show session=67890978DAE00067
fdpi_cli -r 10.20.98.78 pcrf acct show multi_session_id=M67890978DAE00067
fdpi_cli -r 10.20.98.78 pcrf acct show login=JohnSmith
fdpi_cli -r 10.20.98.78 pcrf acct show uid=1034

pcrf acct raw show

Вывод сырых данных (raw-уровень по IP) БД аккаунтинга. Это неагрегированные данные, пришедшие от fastDPI.

fdpi_cli pcrf acct raw show [all | ip=X | session=X | multi_session_id=X | login=X | uid=X]

ключ указывается одним из аргументов:

  • all - вывод все raw БД
  • ip - IPv4- или IPv6-адрес абонента
  • session - accounting session-id
  • multi_session_id - accounting multi-session-id
  • login - логин абонента
  • uid - вывод raw-записей, входящих в запись агрегации с указанным внутренним уникальным идентификатором

Примеры:

   # Вывести все записи
fdpi_cli pcrf acct raw show all
 
   # поиск по IP
fdpi_cli pcrf acct raw show ip=192.168.0.25
fdpi_cli pcrf acct raw show ip=2001:5098:89::/64
 
   # поиск по session-id или multi-session-id:
fdpi_cli pcrf acct raw show session=67890978DAE00067
fdpi_cli pcrf acct raw show multi_session_id=M67890978DAE00067
 
   # Поиск по логину:
fdpi_cli pcrf acct raw show login=JohnSmith
 
   # Поиск по UID
fdpi_cli pcrf acct raw show uid=34098

pcrf acct show stat

Вывод внутренней статистики БД аккаунтинга fastpcrf

fdpi_cli pcrf acct show stat

pcrf acct [start | stop | idle | restart]

Управление аккаунтинг-сессиями

fdpi_cli pcrf acct [start | stop | idle | restart] [ip=X | session=X | multi_session_id=X | login=X | uid=X]

Действия:

  • start - стартует accounting-сессию для указанного абонента. Допустимыми аргументами являются ip, login. Если сессия уже активна, команда ничего не делает.
  • stop - завершение accounting-сессий. Аргументы session и ip завершают одну сессию, остальные могут завершить несколько сессий.
  • idle - завершение accounting-сессий по причине idle timeout. Отличие от stop в том, что сессия, завершенная по тайм-ауту неизменности данных, автоматически стартует при появлении трафика абонента, если не включен режим синхронизации acct_auth_sync. Аргументы session и ip завершают одну сессию, остальные могут завершить несколько сессий.
  • restart - завершение текущей активной сессии и старт новой. Если сессия неактивна, она становится активной. Если сессия активна, она закрывается (stop) и стартует новая сессия с другим session id.

Должен быть указан один из аргументов:

  • ip - IPv4- или IPv6-адрес абонента
  • session - accaunting session-id (имеет смысл для команд stop, restrart, idle)
  • multi_session_id - accounting multi-session-id
  • login - логин абонента
  • uid - внутренний уникальный идентификатор записи агрегации. Этот id присваивается в момент создания записи и, в отличие от session-id, никогда не изменяется.

Примеры:

   # Старт аккаунтинг-сессий для всех IP-адресов логина
fdpi_cli pcrf acct start login=JohnSmith
   # Послать Acct Stop для сессии 67890978DAE00067
fdpi_cli pcrf acct stop pcrf acct stop session=67890978DAE00067
   # Рестартовать  acct-сесию для IP
fdpi_cli pcrf acct restart ip=192.168.52.36
fdpi_cli pcrf acct restart ip=2001:5098:89::/64
   # Завершить все сессии мультисессии по idle timeout
fdpi_cli pcrf acct idle multi_session_id=M67890978DAE00067

pcrf acct interim

Немедленная отправка interim update для указанных сессий. Для отправки interim update сессия должна быть активной.

fdpi_cli pcrf acct interim [ip=X | session=X | multi_session_id=X | login=X | uid=X]

Должен быть указан один из аргументов:

  • ip - IPv4- или IPv6-адрес абонента
  • session - accaunting session-id
  • multi_session_id - accounting multi-session-id
  • login - логин абонента
  • uid - внутренний уникальный идентификатор записи агрегации. Этот id присваивается в момент создания записи и, в отличие от session-id, никогда не изменяется.

Примеры:

fdpi_cli pcrf acct interim ip=192.168.52.36
fdpi_cli pcrf acct interim ip=2001:5098:89::/64
fdpi_cli pcrf acct interim multi_session_id=M67890978DAE00067
fdpi_cli pcrf acct interim session=67890978DAE00067
fdpi_cli pcrf acct interim login=JohnSmith