====== Accounting CLI ======
{{indexmenu_n>6}}

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

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

==== pcrf acct show all ====
Вывод содержимого БД аккаунтинга fastpcrf. Заметим, что наличие записи в выводе этой команды не обязательно означает, что есть активная аккаунтинг-сессия. Если у записи нет атрибута session id, значит, эта запись не является активной. 
<code bash>
fdpi_cli pcrf acct show all
</code>

==== pcrf acct show active ====
Вывод активных сессий БД аккаунтинга fastpcrf. В вывод этой команды попадают активные сессий и сессии, завершенные в ближайшие 5 минут
<code bash>
fdpi_cli pcrf acct show active
</code>

==== pcrf acct show ====
Вывод аккаунтинг-сессий по указанному ключу
<code bash>
fdpi_cli pcrf acct show [ip=X | session=X | multi_session_id=X | login=X | uid=X]
</code>
ключ указывается одним из аргументов:
  * ''ip'' - IPv4- или IPv6-адрес абонента
  * ''session'' - accounting session-id
  * ''multi_session_id'' - accounting multi-session-id
  * ''login'' - логин абонента
  * ''uid'' - внутренний уникальный идентификатор записи агрегации. Этот id присваивается в момент создания записи и, в отличие от session-id, никогда не изменяется.

Примеры (10.20.98.78 - адрес fastpcrf-сервера):
<code bash>
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
</code>

==== pcrf acct raw show ====
Вывод сырых данных (raw-уровень по IP) БД аккаунтинга. Это неагрегированные данные, пришедшие от fastDPI.
<code bash>
fdpi_cli pcrf acct raw show [all | ip=X | session=X | multi_session_id=X | login=X | uid=X]
</code>
ключ указывается одним из аргументов:
  * ''all'' - вывод все raw БД
  * ''ip'' - IPv4- или IPv6-адрес абонента
  * ''session'' - accounting session-id
  * ''multi_session_id'' - accounting multi-session-id
  * ''login'' - логин абонента
  * ''uid'' - вывод raw-записей, входящих в запись агрегации с указанным внутренним уникальным идентификатором

Примеры:
<code bash>           
   # Вывести все записи
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
</code>

==== pcrf acct show stat ====
Вывод внутренней статистики БД аккаунтинга fastpcrf
<code bash>
fdpi_cli pcrf acct show stat
</code>

==== pcrf acct [start | stop | idle | restart] ====
Управление аккаунтинг-сессиями
<code bash>
fdpi_cli pcrf acct [start | stop | idle | restart] [ip=X | session=X | multi_session_id=X | login=X | uid=X]
</code>
Действия:
  * ''start'' - стартует accounting-сессию для указанного абонента. Допустимыми аргументами являются ''ip'', ''login''. Если сессия уже активна, команда ничего не делает.
  * ''stop'' - завершение accounting-сессий. Аргументы ''session'' и ''ip'' завершают одну сессию, остальные могут завершить несколько сессий.
  * ''idle'' - завершение accounting-сессий по причине idle timeout. Отличие от ''stop'' в том, что сессия, завершенная по тайм-ауту неизменности данных, автоматически стартует при появлении трафика абонента, если не включен режим синхронизации [[dpi:bras_bng:radius_integration:radius_accounting:setup#acct_auth_sync|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, никогда не изменяется.

Примеры:
<code bash>
   # Старт аккаунтинг-сессий для всех 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
</code>

==== pcrf acct interim ====
Немедленная отправка interim update для указанных сессий.
Для отправки interim update сессия должна быть активной.
<code bash>
fdpi_cli pcrf acct interim [ip=X | session=X | multi_session_id=X | login=X | uid=X]
</code>

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


Примеры:
<code bash>
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
</code>