pem stats subscriber
pem stats subscriber(1) BIG-IP TMSH Manual pem stats subscriber(1)
NAME
subscriber - Displays and resets PEM subscriber statistics.
MODULE
pem stats
SYNTAX
Display statistics for the subscriber component within the pem stats
module using the syntax in the following section.
DISPLAY
show subscriber
option:
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
DESCRIPTION
You can use the subscriber component to display PEM subscriber
statistics. The Current column represents count of sessions or other
objects that exist at the moment. The Max column represents maximal
count of sessions or other objects that ever existed at the same time.
The Total column represents total count of sessions or other objects
that existed since the start or the last statistics reset. Some entries
support only the Total column. The statistics details are described
below:
Active subscriber sessions
Specifies the number of all subscriber sessions. Note that you can
use the db component in the sys module to configure
tmm.pem.spm.maxsessionlimit to set the number of subscribers
supported per processing unit (TMM). Then, the max number of the
subscribers per device is set accordingly.
Subscriber sessions marked for deletion
Specifies the number of sessions that were marked for deletion,
but not yet deleted.
Dynamic subscriber sessions without data from RADIUS
Specifies the number of sessions related to non-static subscribers
that were neither created by RADIUS accounting start message nor
updated by RADIUS accounting interim message. This counter is not
incremented for a session related to static subscriber, even if
this session is created dynamically.
Subscriber sessions by state/Waiting for provisioning
Specifies the number of sessions that are pending for provision.
Subscriber sessions by state/Waiting for provisioning Hold Timeout
Specifies the number of sessions that are within the provisioning
hold time period.
Subscriber sessions by state/Provisioned
Specifies the number of provisioned sessions.
Subscriber sessions by state/Failed provisioning
Specifies the number of sessions, which provisioning failed.
Usually this state is temporary and these sessions will try to be
reprovisioned.
Subscriber sessions by origin/Sessions discovered via RADIUS
Specifies the number of sessions, which were created by RADIUS
accounting start message.
Subscriber sessions by origin/Sessions discovered via DHCP
Specifies the number of sessions, which were created by DHCP
message.
Subscriber sessions by origin/Sessions discovered from traffic
Specifies the number of sessions, which were created by client
traffic that doesn't correspond to any existing session.
Subscriber sessions by origin/Sessions discovered via iRules
Specifies the number of sessions, which were created by iRules
using PEM::session create or other command.
Subscriber sessions by origin/Pre-configured Static Subscriber Sessions
Specifies the number of sessions, which were created for static
subscriber with pre-configured IP-addresses.
Subscriber sessions provisioning source/Sessions provisioned via Gx
Specifies the number of sessions, which were provisioned from PCRF
via Gx interface.
Subscriber sessions provisioning source/Sessions provisioned via Sd
Specifies the number of sessions, which were provisioned from PCRF
via Sd interface.
Subscriber sessions provisioning source/Sessions provisioned via iRules
Specifies the number of sessions, which were provisioned by iRule
command.
Subscriber sessions provisioning source/Sessions provisioned from
static subscriber database
Specifies the number of sessions which policies were defined on
creation of the corresponding static subscriber.
Subscriber sessions provisioning source/Sessions not provisioned
(pending and failed)
Specifies the number of not provisioned sessions.
Subscriber session update statistics/Session updates received
Specifies total count of session update attempts, e.g. by RADIUS
accounting interim message, Gx Credit-Control-Request (CCR) Update
request or iRule command.
Subscriber session update statistics/Session updates applied
successfully
Specifies total count of session update attempts that were
successful.
Subscriber session update statistics/Session updates received via
RADIUS
Specifies total count of session update attempts by RADIUS
accounting interim message.
Subscriber session update statistics/Session updates received via Gx
Specifies total count of session update attempts by Gx Credit-
Control-Request updates (CCR-U) or Re-Auth-Requests updates (RAR).
Subscriber session update statistics/Session updates received via Sd
Specifies total count of session update attempts by Sd Credit-
Control-Request updates (CCR-U) or Re-Auth-Requests updates (RAR).
Subscriber session update statistics/Session updates received via
iRules
Specifies total count of session update attempts by iRule command.
Subscriber session deletion statistics/Total sessions fully deleted
Specifies total count of completely deleted sessions.
Subscriber session deletion statistics/Sessions replaced
Specifies total count of sessions that were deleted because they
were replaced by other sessions.
Subscriber session deletion statistics/Provisioned sessions deleted
Specifies total count of deleted sessions that had been
provisioned at the moment of deletion.
Subscriber session deletion statistics/Waiting for provisioning
sessions deleted
Specifies total count of deleted sessions that were pending for
provisioning at the moment of deletion.
Subscriber session deletion statistics/Failed provisioning sessions
deleted
Specifies total count of deleted sessions that were in
provisioning failed state at the moment of deletion.
Subscriber session deletion statistics/Sessions deleted via RADIUS
Specifies total count of sessions deleted by RADIUS accounting
stop message.
Subscriber session deletion statistics/Sessions deleted via Gx
Specifies total count of sessions deleted by Gx RAR-t message.
Subscriber session deletion statistics/Sessions deleted due to Gx
connectivity problems
Specifies total count of sessions deleted by the Fatal Grace Time
timer associated with a diameter endpoint.
Subscriber session deletion statistics/Sessions deleted via Sd
Specifies total count of sessions deleted by Sd RAR-t message.
Subscriber session deletion statistics/Sessions deleted due to Sd
connectivity problems
Specifies total count of sessions deleted by the Fatal Grace Time
timer associated with a diameter endpoint.
Subscriber session deletion statistics/Sessions deleted via DHCP
Specifies total count of sessions deleted by DHCP release message.
Subscriber session deletion statistics/Sessions deleted due to
Inactivity
Specifies total count of sessions deleted due to inactivity for
time configured in the tmm.pem.session.inactivitytimeout variable.
Subscriber session deletion statistics/Sessions deleted via iRules
Specifies total count of sessions deleted by iRule command.
Subscriber session deletion statistics/Sessions deleted
administratively
Specifies total count of sessions deleted interactively by
operator.
Subscriber session deletion statistics/Sessions deleted due to static
subscriber removal
Specifies total count of sessions deleted due to deletion of the
corresponding static subscriber. This includes sessions that were
created by RADIUS accounting start message, but deleted by
deletion of static subscriber.
Subscriber session deletion statistics/Pre-configured static subscriber
sessions deleted
Specifies total count of deleted sessions, which policies were
defined on creation of the corresponding static subscriber. This
includes sessions that were configured in static subscriber, but
created and deleted by RADIUS accounting messages.
Multiple IP address subscriber sessions/Active sessions with single IP
address
Specifies the number of sessions, which are associated with one IP
address.
Multiple IP address subscriber sessions/Active sessions with multiple
IP addresses
Specifies the number of sessions, which are associated with more
than one IP address.
Multiple IP address subscriber sessions/Active sessions with both IPv4
and IPv6 addresses
Specifies the number of sessions, which are associated with one or
multiple IPv4 addresses and one or multiple IPv6 addresses
Multiple IP address subscriber sessions/Active sessions with more than
one IPv4 address
Specifies the number of sessions, which are associated with more
than one IPv4 address.
Multiple IP address subscriber sessions/Active sessions with more than
one IPv6 address
Specifies the number of sessions, which are associated with more
than one IPv6 address.
Multiple IP address subscriber sessions/Total session IPv4 addresses
Specifies the number of IPv4 addresses associated with existing
sessions. IP address uniqueness is not checked, so if the same IP
address is added and removed several times, the total counter is
incremented the each time address is added.
Multiple IP address subscriber sessions/Total session IPv6 addresses
Specifies the number of IPv6 addresses associated with existing
sessions. IP address uniqueness is not checked, so if the same IP
address is added and removed several times, the total counter is
incremented the each time address is added.
Multiple IP address subscriber sessions/Sessions provisioned after hold
timeout
Specifies the number of sessions, which were put on provision hold
and were provisioned after the provision hold period finished.
Multiple IP address subscriber sessions/Session IP addresses added
after session is provisioned
Specifies the total number of IP addresses that were added to
already provisioned sessions. IP address uniqueness is not
checked, so if the same IP address is added and removed several
times, this counter is incremented the each time address is added.
Multiple IP address subscriber sessions/Session IP addresses removed
without session delete
Specifies the total number of IP addresses that were removed from
existing sessions without session deletion. This is possible for
sessions associated with multiple IP addresses.
Exceptions, Errors, Other Statistics/Failed provisioning attempts
Specifies the aggregated number of failed provisioning attempts
for all subscribers in the system since the last reset of the
counter. For example, a provisioning attempt fails if a policy
server (PCRF) returns an error, or does not respond for any
reason.
Exceptions, Errors, Other Statistics/Subscriber Limit Exceeded
Specifies the count of the session creation failures, which are
caused by exceeding the max number of subscribers supported by one
processing unit (TMM).
Exceptions, Errors, Other Statistics/Session IP address limit exceeded
Specifies the count of the session creation or update failures,
which are caused by exceeding the max number of IP addresses per
session.
Exceptions, Errors, Other Statistics/Attempts to remove non-existent
session via RADIUS
Specifies the count of attempts to remove session by RADIUS
accounting stop message, which failed because the session was not
found.
Exceptions, Errors, Other Statistics/Attempts to remove non-existent
session via DHCP
Specifies the count of attempts to remove session by DHCP release
message, which failed because the session was not found.
Exceptions, Errors, Other Statistics/Attempts to remove non-existent
session via Gx
Specifies the count of attempts to remove session by Gx RAR-t
message, which failed because the session was not found.
Exceptions, Errors, Other Statistics/Attempts to remove non-existent
session via Sd
Specifies the count of attempts to remove session by Sd RAR-t
message, which failed because the session was not found.
Exceptions, Errors, Other Statistics/Attempts to remove non-existent
session via iRules
Specifies the count of attempts to remove session by iRule
command, which failed because the session was not found.
Exceptions, Errors, Other Statistics/Subscriber sessions with activity
log enabled Specifies the number of sessions for which the activity log
was enabled.
You can reset the PEM subscriber statistics using reset-stats command.
EXAMPLES
show subscriber
Displays the PEM subscriber statistics.
reset-stats subscriber
Resets the PEM subscriber statistics.
OPTIONS
For information about the options that you can use with the command
show, see help show.
SEE ALSO
show, pem stats action, pem stats gx, pem stats gy, pem stats hsl, pem
stats radius, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or
by any means, electronic or mechanical, including photocopying,
recording, or information storage and retrieval systems, for any
purpose other than the purchaser's personal use, without the express
written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2009-2013, 2016. All rights
reserved.
BIG-IP 2016-03-14 pem stats subscriber(1)