Различия

Показаны различия между двумя версиями страницы.

--- dpi:bras_bng:cli:acct [2023/09/01 11:41] – elena.krasnobryzh
+++ dpi:bras_bng:cli:acct [2024/09/26 15:29] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 1: / Строка 1: @@
-====== acct ======
+====== 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>

Аккаунт

Настройки

Различия