| 1 | Log Overview |
2 | Log Types |
3 | Log Events |
4 | Configuration |
5 | Reported Data |
| 5.1 | SAPC Application Logs Record Output Format |
1 Log Overview
Logging information is a high-level, cluster-significant, function-based (as opposed to implementation-particular) information suited primarily for network or system administrators, or automated tools to review current and historical logged information to troubleshoot issues such as misconfigurations, network disconnects and unavailable resources.
This document provides information about the main logged events of the SAPC used by operators or system administrators.
The SAPC provides some other more detailed (implementation dependent, for deeper software troubleshooting purposes) log events, targeted only for Ericsson support personnel which are not listed in this document.
2 Log Types
There are different logs to store different types of events:
| Application Log | It is used for events related to the SAPC application noteworthy processing circumstances, those that may affect the service (used for troubleshooting). For example: a subscriber is autoprovisioned. The log events of this category are the ones covered in Section 3. | |
| Emergency Calls Log |
It is used for events related
to the SAPC emergency services. For example: an AF Emergency
Session established. The log events of this category are the ones
covered in Table 2 and Table 3.
| |
| Alarm Log | Each time an alarm is triggered, a log entry is generated. | |
| Notification Log | Each time a notification is sent, a log entry is generated. | |
| System Log | Used by applications to record noteworthy system circumstances, particularly those that affect service. | |
3 Log Events
This chapter explains the application events logged by the SAPC in tables with the following format:
|
Event Name |
Slogan of the event |
|
Description |
The explanation of the cause event |
|
Severity |
One of the following level values:
|
|
Source |
Subsystem originating the event: |
|
Additional Info |
Any other relevant information. This information is literally what is displayed in the log file. When there are several parameters data logged in additional info, all of them are logged (empty values in case there is no information for any of them). For protocol-related event logs, and to ease the tracking, there are cases where some parameters values are printed, even if they are not directly received in the messages content, but internally completed by the SAPC. |
|
Event Name |
AF Emergency Session established. |
|
Description |
The SAPC has received and authorized a new request for IMS emergency service. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Dynamic Policy Control |
|
Additional Info |
|
|
Event Name |
AF Emergency Session terminated. |
|
Description |
The SAPC has received a termination request for IMS emergency service. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Dynamic Policy Control |
|
Additional Info |
|
|
Event Name |
Autoprovisioned subscriber. |
|
Description |
A subscriber has been autoprovisioned. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Subscription |
|
Additional Info |
|
|
Event Name |
Configuration error. |
|
Description |
A configuration error has been detected. |
|
Severity |
4: WARNING |
|
Source |
Any |
|
Additional Info |
|
|
Event Name |
Diameter incoming message discarded. |
|
Description |
Discarded an incoming Diameter message. Therefore, the message has not been processed. |
|
Severity |
3: ERROR |
|
Source |
Any |
|
Additional Info |
(1) Value of the Subscription-Id AVP(s) received inside the message.
|
Event Name |
Diameter peer node restarted. |
|
Description |
A restart on a diameter peer has been detected. Sessions cleaning has been scheduled. |
|
Severity |
5: NOTICE |
|
Source |
Any |
|
Additional Info |
|
|
Event Name |
Discarded received usage. |
|
Description |
A traffic message (CCR) has been received containing reported usage for a subscriber, but the SAPC discards the received usage. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Fair Usage |
|
Additional Info |
|
|
Event Name |
EBM mandatory parameter missed. |
|
Description |
Mandatory parameter is missing. |
|
Severity |
3: ERROR |
|
Source |
EBM |
|
Additional Info |
|
|
Event Name |
End deleting inactive sessions. |
|
Description |
The SAPC has finished to remove inactive sessions. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Obsolete Sessions Notifier |
|
Additional Info |
|
|
Event Name |
End deleting old sessions. |
|
Description |
The SAPC has finished to remove old sessions belonging to the restarted peer. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Obsolete Sessions Notifier |
|
Additional Info |
|
Event Name |
End sessions emergency removal. |
|
Description |
The SAPC has finished the emergency procedure to remove sessions and its Origin-State-Id has changed. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Sessions Emergency Removal |
|
Additional Info |
|
|
Event Name |
End User Notification discarded |
|
Description |
The internal queue in the End User Notification subsystem is filled. The end user notification is discarded. |
|
Severity |
3: ERROR |
|
Source |
End User Notifications |
|
Additional Info |
|
|
Event Name |
Error fetching data from external DB. |
|
Description |
There has been an error requesting data from external database. Example: The database is not accessible. |
|
Severity |
3: ERROR |
|
Source |
External Database |
|
Additional Info |
|
|
Event Name |
Error sending ASR. |
|
Description |
|
|
Severity |
4: WARNING |
|
Source |
Dynamic Policy Control |
|
Additional Info |
|
|
Event Name |
Error sending CCA. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Access and Charging Control QoS Control Sd Application Detection and Control |
|
Additional Info |
|
|
Event Name |
Error sending RAR. |
|
Description |
|
|
Severity |
4: WARNING |
|
Source |
Access and Charging Control QoS Control Dynamic Policy Control Sd Application Detection and Control |
|
Additional Info |
|
|
Event Name |
Error sending SLR. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Sy Subscriber Charging |
|
Additional Info |
|
|
Event Name |
Error sending SNA. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Sy Subscriber Charging |
|
Additional Info |
|
|
Event Name |
Error sending SNR. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Sy Subscriber Charging |
|
Additional Info |
|
|
Event Name |
Error sending TSR. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Sd Application Detection and Control |
|
Additional Info |
|
|
Event Name |
Error storing data into external DB. |
|
Description |
There has been an error writing data in the external database. Example: The database is not accessible. |
|
Severity |
3: ERROR |
|
Source |
External Database |
|
Additional Info |
|
|
Event Name |
Existing IP Session removed. |
|
Description |
A CCR Initial message, for an existing IP Session has been received. The old IP Session is removed. |
|
Severity |
4: WARNING |
|
Source |
Access and Charging Control |
|
Additional Info |
|
Event Name |
Geographical redundancy state changed. |
|
Description |
Indicates when the SAPC changes its geographical redundancy state. |
|
Severity |
4: WARNING |
|
Source |
Geographical Redundancy |
|
Additional Info |
|
|
Event Name |
Internal error. |
|
Description |
The SAPC has detected an internal error. |
|
Severity |
4: WARNING |
|
Source |
Any |
|
Additional Info |
|
|
Event Name |
IP-CAN session exists. |
|
Description |
The IP-CAN session to be created exists. |
|
Severity |
4: WARNING |
|
Source |
Access and Charging Control |
|
Additional Info |
|
|
Event Name |
License error. |
|
Description |
The SAPC has answered a request with error due to a missing or expired license. When the SAPC can process the request even if a function (for example end user notifications) is not licensed, this log does not appear. |
|
Severity |
4: WARNING |
|
Source |
Any |
|
Additional Info |
|
|
Event Name |
IMS Multimedia Priority Service. |
|
Description |
An AAR has been received with IMS Multimedia Priority Service enabled. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Dynamic Policy Control |
|
Additional Info |
|
|
Event Name |
NetLoc information not received during AF session termination. |
|
Description |
The SAPC received an STR from AF requesting network location information, but did not receive it from the PCEF. |
|
Severity |
4: WARNING |
|
Source |
Dynamic Policy Control |
|
Additional Info |
|
|
Event Name |
Non-Persistent data storage empty. |
|
Description |
Non-persistent data such as Time of Day, subscriber session, and subscriber notifications are empty. This means that:
|
|
Severity |
4: WARNING |
|
Source |
Any |
|
Additional Info |
|
Event Name |
Not supported OpenSSL cipher suite for Provisioning REST API access. |
|
Description |
The SAPC Provisioning REST API does not support the configured cipher. |
|
Severity |
4: WARNING |
|
Source |
Subscription |
|
Additional Info |
|
|
Event Name |
Notification Server Communication Error. |
|
Description |
A communication error between the SAPC and the Notification Server has been detected. |
|
Severity |
3: ERROR |
|
Source |
End User Notifications |
|
Additional Info |
|
Event Name |
Protocol error. |
|
Description |
The SAPC processes a message with a result different than success, and the reason for the error is information sent inside the message. |
|
Severity |
4: WARNING |
|
Source |
Any |
|
Additional Info |
|
Event Name |
Reset of accumulated usage data. |
|
Description |
The accumulated usage data have been reset. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Fair Usage |
|
Additional Info |
|
(1) This value is only displayed
if quota rollover is enabled.
|
Event Name |
|
|
Description |
The SAPC Provisioning REST API is not available due to none configured cipher is supported. |
|
Severity |
2: CRITICAL |
|
Source |
Subscription |
|
Additional Info |
|
|
Event Name |
Rollover limit surpassed. |
|
Description |
A subscriber rollover usage limit has been surpassed. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Fair Usage |
|
Additional Info |
|
Event Name |
Rule Installation Failure. |
|
Description |
A CCR has been received indicating Rule Installation Failure. For example, any rule has been reported as inactive by the PCEF, or there has been an installation with lower QoS (rules active but with Rule-Failure-Code = UNSUCCESSFUL_QOS_VALIDATION). |
|
Severity |
5: NOTICE |
|
Source |
Access and Charging Control QoS Control |
|
Additional Info |
|
|
Event Name |
|
|
Description |
|
|
Severity |
4: WARNING |
|
Source |
SOAP Notification |
|
Additional Info |
|
|
Event Name |
|
|
Description |
SOAP Request received containing notificationEvent not supported. |
|
Severity |
4: WARNING |
|
Source |
SOAP Notification |
|
Additional Info |
|
|
Event Name |
Start deleting inactive sessions. |
|
Description |
The SAPC has started to remove inactive sessions. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Obsolete Sessions Notifier |
|
Additional Info |
|
|
Event Name |
Start deleting old sessions. |
|
Description |
The SAPC has started to delete old sessions belonging to the restarted peer. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Obsolete Sessions Notifier |
|
Additional Info |
|
Event Name |
Start sessions emergency removal. |
|
Description |
The SAPC has started the emergency procedure to remove sessions and its Origin-State-Id is going to change. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Sessions Emergency Removal |
|
Additional Info |
|
|
Event Name |
Timeout receiving RAA. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Access and Charging Control QoS Control Dynamic Policy Control Sd Application Detection and Control |
|
Additional Info |
|
|
Event Name |
Timeout receiving SLA. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Sy Subscriber Charging |
|
Additional Info |
|
|
Event Name |
Timeout receiving STA. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Sy Subscriber Charging |
|
Additional Info |
|
|
Event Name |
Timeout receiving TSA. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Sd Application Detection and Control |
|
Additional Info |
|
|
Event Name |
Unable to deliver End User Notification. |
|
Description |
The SAPC has not been able to send the subscriber notification. |
|
Severity |
6: INFORMATIONAL |
|
Source |
End User Notifications |
|
Additional Info |
|
|
Event Name |
Unsuccessful RAA received. |
|
Description |
The SAPC received an RAA message with result code not success. |
|
Severity |
3: ERROR |
|
Source |
Access and Charging Control QoS Control Sd Application Detection and Control |
|
Additional Info |
|
|
Event Name |
Unsuccessful SLA received. |
|
Description |
The SAPC received an SLA message with result code not success. |
|
Severity |
3: ERROR |
|
Source |
Sy Subscriber Charging |
|
Additional Info |
|
|
Event Name |
Unsuccessful SNA sent. |
|
Description |
|
|
Severity |
3: ERROR |
|
Source |
Sy Subscriber Charging |
|
Additional Info |
|
|
Event Name |
Unsuccessful STA received. |
|
Description |
The SAPC received an STA message with result code not success. |
|
Severity |
3: ERROR |
|
Source |
Sy Subscriber Charging |
|
Additional Info |
|
|
Event Name |
Unsuccessful TSA received. |
|
Description |
The SAPC received a TSA message with result code not success. |
|
Severity |
3: ERROR |
|
Source |
Sd Application Detection and Control |
|
Additional Info |
|
|
Event Name |
Usage Limit Surpassed. |
|
Description |
A subscriber usage limit has been surpassed. |
|
Severity |
6: INFORMATIONAL |
|
Source |
Fair Usage |
|
Additional Info |
4 Configuration
To configure the log level for the SAPC, set the loggingLevel attribute of the BusinessEvents object to the proper value. Example using COM cliss:
# /opt/com/bin/cliss
>configure
(config)>ManagedElement=1,PolicyControlFunction=1,BusinessEvents=1,loggingLevel=3
(config)>commit
>show ManagedElement=1,PolicyControlFunction=1,BusinessEvents=1,loggingLevel
loggingLevel=3
5 Reported Data
To check the logs generated by the system follow next steps:
- Access to the SAPC according to System Administrator Guide.
- Depending on the type of log that the user needs to check, enter in the paths defined in Table 54.
The following table shows the default location for log files.
|
Logs |
File |
|---|---|
|
SAPC Application Logs |
/cluster/storage/no-backup/coremw/var/log/saflog/sapc/sapc__<createdate>_<createtime>[_<closedate>_<closetime>].log |
|
SAPC Java Application Logs (external database and end user notifications) |
/cluster/storage/no-backup/coremw/var/log/saflog/sapc/sapcJava_<createdate>_<createtime>[_<closedate>_<closetime>].log |
|
SAPC Emergency Calls Logs |
/cluster/storage/no-backup/coremw/var/log/saflog/sapc/emergencyCalls_<createdate>_<createtime>[_<closedate>_<closetime>].log |
|
Alarm Logs |
/cluster/storage/no-backup/coremw/var/log/saflog/saLogAlarm_<createdate>_<createtime>[_<closedate>_<closetime>].log |
|
Notification Logs |
/cluster/storage/no-backup/coremw/var/log/saflog/saLogNotification_<createdate>_<createtime>[_<closedate>_<closetime>].log |
|
System Logs |
/cluster/storage/no-backup/coremw/var/log/saflog/saLogSystem_<createdate>_<createtime>[_<closedate>_<closetime>].log |
5.1 SAPC Application Logs Record Output Format
Events in the application log contain the following information:
- Log record identifier
- Timestamp
- Severity. This field contains two characters to define the severity. All the possible severity identifiers are defined in Table 55.
- Message Information. This field includes following information:
- The DomainName, that is the identity of the Service Component, Service Unit, Service Group, and Service Application of the instance triggering the log.
- The Event Name.
- The Additional Info.
The following table shows the set of severity identifiers:
|
Severity Identifiers |
Description |
|---|---|
|
EM |
EMERGENCY |
|
AL |
ALERT |
|
CR |
CRITICAL |
|
ER |
ERROR |
|
WA |
WARNING |
|
NO |
NOTICE |
|
IN |
INFORMATIONAL |
The following is an example of a printed log event:
Example 1 SAPC Application Log Example
1821 16:59:33 02/22/2016 ER safComp=ERIC-SAPC_PcrfProc,safSu=ERIC-SAPC_PcrfProc-3,safSg=ERIC-SAPC_PcrfProc,safApp=ERIC-SAPC "Diameter incoming message discarded. SessionId: tc_04_02_Reset_Period_2GGSN_gxr9;ggsnNodeHostname.nodeHostRealm.com;2;460222, SubsId: 34600320402, Protocol: Gx, MesssageType: CCR-I"

Contents