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)