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.

BIG-IP 2016-03-14 pem stats subscriber(1)