7 Binding Support Function Metrics
BSF Metrics
This chapter includes information about Metrics for Oracle Communications Cloud Native Core, Binding Support Function (BSF).
- Observability Dashboard:
- This dashboard metadata is stored in the
BSF_Observability_Dashboard.jsonfile. - This dashboard has the panels that monitors the overall health status of the setup & contains details like resource utilization, kmps, latency, etc.
- Customers can use this Dashboard on a regular basis for observing the status of the setup and also for assessing the setup performance with a run.
- Depending upon the applicability of a panel or row, the customers have the flexibility to either remove, update or add content to the Dashboard.
- This dashboard metadata is stored in the
- Debug Dashboard:
- This dashboard metadata is stored in the
BSF_Debug_Dashboard.jsonfile. - This dashboard has the panels that monitor the operational status of the setup and is used for debugging & troubleshooting purposes.
- Customers can use this Dashboard when any issue occur in the NF and also when reporting a probable issue to Oracle Customer Support from the setup.
- Depending upon the applicability of a panel or row, the customers have the flexibility to either remove, update or add content to the Dashboard.
- This dashboard metadata is stored in the
The name of the metrics may contain suffix such as total, seconds, max and so on. It gets added by the Micrometer registry if it is not present in the metrics name. The metric name has the following format for suffix:
The metric name is equal to <Basename of the metric>_<Suffix>
Table 7-1 Metrics type and Suffix
| Metric Type | Suffix |
|---|---|
| Counter | _total |
| Gauge | N/A |
| TimerGauge | _seconds |
| MultiGauge | N/A |
| Timer | _seconds_max or _seconds
Note: There are two types of suffix used for timer metrics. For example, my_timer_seconds_max gauge and my_timer_seconds summary. In summary type, there will be further addition of suffix such as _count or _sum. |
| DistributionSummary | N/A or _max
Note: There are two types of suffix used for DistributionSummary. For example, my_distribution_ratio histogram and my_distribution_ratio_max gauge. In the histogram type there will be further addition of suffix such as bucket, _count, or sum. |
| LongTaskTimer | _seconds_max or _seconds
Note: There are two types of suffix used for LongTaskTimer. For example, long_task_timer_seconds_max gauge and long_task_timer_seconds summary. In summary type there will be further addition of suffix such as _active_count or _duration_sum. |
Table 7-2 Dimension Description
| Dimension | Description |
|---|---|
| operation_type | Type of operation
Values:
|
| dnn | Data Network Name or Access Point Name |
| snssai | Single Network Slice Selection Assistance Information |
| response_code | Response code
HTTP interfaces:
Diameter interfaces:
|
| latency |
The total time in between request and response. If latency between request and response is 203, then bucket number is 4. Max bucket set to 10 (0-9), Range 50ms. |
| nf_instance_Id | Unique id of the nf Instance.
HTTP interfaces: Diameter interfaces:
|
| nf_name | This represents the FQDN corresponding to the NF
InstanceID present in the nf_instance_id dimension.
HTTP interface: egress: NF FQDN |
| sbi_priority | Service Based Interface |
| service_version | Service version
Value: [UDR = "v1,v2", CHF = "v1"] |
| service | The complete name of current service.
Value: string |
| namespace | The namespace of current service.
Value: string |
| category | The category of current service.
Value:
|
| destHost | Value of destination Host received or sent in the corresponding request message |
| destRealm | Value of destination Realm received or sent in the corresponding request message |
| origHost | Value of origination Host received or sent in the corresponding request message |
| origRealm | Value of origination Realm received or sent in the corresponding request message |
| reqDestHost | Value of destination Host in corresponding request message of response message. |
| reqDestRealm | Value of destination Realm in corresponding request message of response message. |
| reqOrigHost | Value of origination Host in corresponding request message of response message. |
| reqOrigRealm | Value of origination Realm in corresponding request message of response message. |
| direction | Indicates direction of message flow.
|
| appId | Application ID exchanged in CEX messages or used in the respective message of an application. |
| applicationName | Human readable name of corresponding application ID
16777236 => Rx 16777238 => Gx 16777302 => Sy 16777217 => Sh Note: Sh interface is not supported for Converged Policy mode of deployment. 0xffffffff => Relay |
| cmdCode | Command code value in the received or sent, request or answer message |
| msgType | Type of the message, for example CCRT-T, CCR-I etc. |
| responseCode | result code in diameter message |
| spendingLimitDataSource | Specifies the source from which PCF fetches policy
counters.
Value: OCS |
| retry | Identify message is a retry message.
Value:
|
| retryAnswer | Reason for the retry message.
Value:
|
| level | Indicates the current load level or
the level of pod congestion.
Value:
|
| type | Resource type
Value:
|
| le | le is abrreviated as "Less than equal to".Value of a defined bucket for a Histogram. |
| sessRuleReports | Indicates that session rule report is received at PCF. |
| policyDecFailureReports | Indicates that Policy decision failure report is received at PCF. |
| isLeaderPod | Indicates if the pod calculating the threshold level is a leader pod. |
| prevLevel | Indicates the previous load level prior to current load level calculation. |
| levelChangeType | Indicates the level change type. The value of this
dimension can be:
|
| servicenameNon3gpp | - |
| serviceResource | - |
| params | Lists the API parameters. |
| outcome | Shows the outcome of an operation such as SUCCESS, FAILURE, TIMEOUT. |
| cause | Contains the error cause. |
7.1 Egress Gateway Metrics for SCP
This section provides details about SCP health monitoring metrics and the respective dimensions.
Table 7-3 ocbsf_oc_egressgateway_peer_health_status
| Field | Details |
|---|---|
| Description |
It defines Egress Gateway peer health status.
|
| Type | Gauge |
| Dimensions |
|
| Examples |
|
Table 7-4 ocbsf_oc_egressgateway_peer_health_ping_request
| Field | Details |
|---|---|
| Description | This metric is incremented every time a health ping is sent toward a peer. |
| Type | Counter |
| Dimensions |
|
| Examples |
|
Table 7-5 ocbsf_oc_egressgateway_peer_health_ping_response
| Field | Details |
|---|---|
| Description | This metric is incremented every time a health ping response is received from a peer irrespective of success or failure. |
| Type | Counter |
| Dimensions |
|
| Examples |
|
Table 7-6 ocbsf_oc_egressgateway_peer_health_status_transitions
| Field | Details |
|---|---|
| Description | This metric is incremented every time a peer is transitioned from Availble to Unavailable or from Unavailable to Available. |
| Type | Counter |
| Dimensions |
|
| Examples |
|
Table 7-7 ocbsf_oc_egressgateway_peer_count
| Field | Details |
|---|---|
| Description | This metric is incremented every time for the peer count. |
| Type | Gauge |
| Dimensions |
|
| Example | ocbsf_oc_egressgateway_peer_count{"peerset":"set-0"} 3.0 |
Table 7-8 ocbsf_oc_egressgateway_peer_available_count
| Field | Details |
|---|---|
| Description | This metric is incremented every time for the available peer count. |
| Type | Gauge |
| Dimensions |
|
| Example | ocbsf_oc_egressgateway_peer_available_count{"peerset":"set-0"} 4.0 |
7.2 Correlation-Info Header Metrics
For every correlation-info header received or newly generated, a metric will be pegged. Following are the list of metrics:
Below mention table list the metrics that shall be implemented as part of this feature with the following Dimensions:
- operation_type= {"create","update","delete","subscribe","unsubscribe","terminate","register","deregister"....}
- correlation_info_type={"imsi", "msisdn", "imsi,msisdn"}
Table 7-9 ocbsf_correlation_info_header_received
| Field | Details |
|---|---|
| Description |
BSF reports total outgoing request that are carried by the correlation-info header. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_correlation_info_header_received_total '{correlation_info_type="imsi", operation_type="create"}',2 |
Table 7-10 ocbsf_correlation_info_header_forwarded
| Field | Details |
|---|---|
| Description |
BSF reports total incoming request that are carried by the correlation-info header. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_correlation_info_header_received_total '{correlation_info_type="imsi", operation_type="update"}',1 |
Table 7-11 ocbsf_correlation_info_header_generated
| Field | Details |
|---|---|
| Description |
BSF reports the total responses carried by the correlation-info header. |
| Type | Counter |
| Dimensions |
|
| Examples |
|
7.3 Configuration Server Metrics
Table 7-12 topic_version
| Field | Details |
|---|---|
| Description |
Configuration service will have this metrics a database value from each topic version. The Services fetching the configurations from Configuration Server, will have its current topic version till which configurations has been fetched successfully. |
| Type | Gauge |
| Dimensions |
|
| Examples |
|
7.4 Active Sessions Count Metrics
Table 7-13 oc_db_active_session_count
| Field | Details |
|---|---|
| Description | Active sessions count |
| Type | Gauge |
| Dimensions |
|
Table 7-14 inbound_requests_total
| Field | Details |
|---|---|
| Description | Inbound requests total (number of requests received via CM/REST to get instantaneous Active Session Count) |
| Type | Counter |
| Dimensions |
|
7.5 AppInfo Metrics
Table 7-15 appinfo_service_running
| Field | Details |
|---|---|
| Description | Provides the status of monitored services. |
| Type | Gauge |
| Dimensions |
|
| Example | appinfo_service_running{service="xxx",namespace="xxx",category="xxx"} 1 |
Table 7-16 appinfo_category_running
| Field | Details |
|---|---|
| Description | Provides the status of monitored categories. |
| Type | Gauge |
| Dimensions |
|
| Example |
|
Table 7-17 appinfo_category_good
| Field | Details |
|---|---|
| Description | Provides the readiness of monitored categories. |
| Type | Gauge |
| Dimensions |
|
Table 7-18 nfscore
| Field | Details |
|---|---|
| Description |
|
| Type | Gauge |
| Dimensions |
|
| Example |
|
Table 7-19 nfScoringFactorActualValue
| Field | Details |
|---|---|
| Description | factor tag would contain one of the following values: successTPS, serviceHealth, signallingConnections, replicationHealth, localityPreference |
| Type | Gauge |
| Dimensions |
|
| Example |
|
7.6 Audit Service Metrics
The following table describes the Audit Service metrics and respective dimensions:
Table 7-20 audit_recs_stale_total
| Field | Details |
|---|---|
| Description | Number of records detected as stale. |
| Type | Counter |
| Dimensions |
|
| Example | audit_recs_stale_total{ServiceName="bsf-management-service",TableName="pcf_binding",} 1.0 |
Table 7-21 audit_recs_notif_total
| Field | Details |
|---|---|
| Description | Number of stale record notifications sent, applicable for modes: NOTIFY and DELETE_NOTIFY. |
| Type | Counter |
| Dimensions |
ServiceName |
| Example | audit_recs_notif_total{ServiceName="bsf-management-service",} 1.0 |
Table 7-22 audit_recs_deque_for_notif_total
| Field | Details |
|---|---|
| Description | Number of stale records dequeued to send Notification. |
| Type | Counter |
| Dimensions |
ServiceName |
| Example | audit_recs_deque_for_notif_total{ServiceName="bsf-management-service",} 1.0 |
Table 7-23 audit_recs_enque_for_notif_total
| Field | Details |
|---|---|
| Description | Number of stale records enqueued from Database. |
| Type | Counter |
| Dimensions |
ServiceName |
| Example | audit_recs_enque_for_notif_total{ServiceName="bsf-management-service",} 1.0 |
Table 7-24 oc_db_active_session_count
| Field | Details |
|---|---|
| Description | Reports the session for a given service. |
| Type | Gauge |
| Dimensions |
|
| Example | oc_db_active_session_count{Service="bsf-management-service",Table="pcfbinding",} 1.0 |
Table 7-25 topic_version
| Field | Details |
|---|---|
| Description | Describes the current applied version of a given topic (mentioned in dimension topic_name) into the pod. |
| Type | Gauge |
| Dimensions |
|
7.7 BSF Management Service
This section describes the metrics used for BSF Management service.
The following table provides information about metrics related to BSF Management service.
Table 7-26 ocbsf_ingress_response_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF sends a response message through Ingress Gateway. |
| Type | Gauge |
| Dimensions | operation_type
dnn snssai application_error_code response_code binding_level binding_id |
| Example | ocbsf_ingress_response_total{application="bsf-management-service",application_error_code="",binding_id="setxyz.bsfset.5gc.mnc015.mcc360,setxyz.bsfset.5gc.mnc015.mcc350",binding_level="nf-set",dnn="dnn1",operation_type="register",response_code="2xx",snssai="100-D143A5",} |
Table 7-27 ocbsf_ingress_request_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF receives a request message through Ingress Gateway. |
| Type | Gauge |
| Dimensions | operation_type
dnn snssai pcf_set_id pcf_id |
| Example | ocbsf_ingress_request_total{application="bsf-management-service",dnn="dnn1",operation_type="register",pcf_id="somePcfId",pcf_set_id="somePcfSetId",snssai="100-D143A5",} 1.0 |
Table 7-28 ocbsf_audit_notif_request_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF receives a notification request from the audit service for stale bindings. |
| Type | Counter |
| Dimensions | application |
| Example | ocbsf_audit_notif_request_count_total{application="bsf-management-service",operation_type="audit_notify",} 1.0 |
Table 7-29 ocbsf_audit_notif_response_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF sends a notification response for the request received from the Audit service for stale bindings. |
| Type | Counter |
| Dimensions | application |
| Example | ocbsf_audit_notif_response_count_total{application="bsf-management-service",operation_type="audit_notify",response_code="2xx",} 1.0 |
Table 7-30 ocbsf_audit_delete_records_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF successfully deletes stale bindings. |
| Type | Counter |
| Dimensions | application |
| Example | ocbsf_audit_delete_records_count_total{application="bsf-management-service",operation_type="audit_notify",} 1.0 |
Table 7-31 ocbsf_audit_delete_records_max_ttl_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when the BSF successfully deletes bindings on receiving maxTTL as 'true' |
| Type | Counter |
| Dimensions | application |
| Example | ocbsf_audit_delete_records_count_total{application="bsf-management-service",operation_type="audit_notify",} 1.0 |
Table 7-32 ocbsf_diamgw_notification_request_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF management service receives stale binding notification request from Diameter Gateway. |
| Type | Counter |
| Dimensions | application |
| Example | ocbsf_diamgw_notification_request_count_total{application="bsf-management-service",operation_type="audit_notify",} 1.0 |
Table 7-33 ocbsf_diamgw_notification_response_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF management service sends a response for the stale binding notification request from Diameter Gateway. |
| Type | Counter |
| Dimensions | application |
| Example | ocbsf_diamgw_notification_response_count_total{application="bsf-management-service",operation_type="audit_notify",} 1.0 |
Table 7-34 ocbsf_diamgw_delete_records_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF management service successfully deletes stale PCF bindings due to Diameter Gateway notification requests. |
| Type | Counter |
| Dimensions | application |
| Example | ocbsf_diamgw_delete_records_count_total{application="bsf-management-service",operation_type="audit_notify",} 1.0 |
Table 7-35 ocbsf_query_request_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF management service sends request to PCF to confirm if PcfBinding is stale or not. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_query_request_count_total{application="bsf-management-service",operation_type="query",response_code="2xx",} 1.0 |
Table 7-36 ocbsf_query_response_count_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF management service receives a response for PcfBinding stale confirmation request. |
| Type | Counter |
| Dimensions | application |
| Example | ocbsf_query_response_count_total{application=“bsf-management-service”,operation_type=“query”,response_code=“timeout”,} 1.0 |
Table 7-37 ocbsf_http_out_conn_request_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF sends notification request using HTTP in Diameter Gateway. |
| Type | Counter |
| Dimensions |
operation_type (delete) serviceResource servicename3gpp (DiameterGateway) |
Table 7-38 ocbsf_http_out_conn_response_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF receives response for notification request requests using HTTP in Diameter Gateway. |
| Type | Counter |
| Dimensions |
operation_type (delete) responseCode serviceResource servicename3gpp (DiameterGateway) |
Table 7-39 ocbsf_bindingQuery_request_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF receives a query request for PCF bindings. PCF Binding query-service sends SUPI, GPSI, IPv4 address, IPv6 address, and mac address to BSF. |
| Type | Counter |
| Dimensions |
operation_type (query) criteria_type (SUPI/GPSI/UE Address) |
| Example | ocbsf_bindingQuery_request_total{application="bsf-managementservice",gpsi="false",ipv4Addr="true",ipv6Prefix="false",macAddr48="false",operation_type="query",supi="true",} 1.0 |
Table 7-40 ocbsf_bindingQuery_response_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF sends a response message for a PCF bindings query request. PCF Binding query-service sends SUPI, GPSI, IPv4 address, IPv6 address, and mac address to BSF. |
| Type | Counter |
| Dimensions | response_code (2xx,
4xx)
operation_type (query) criteria_type (SUPI/GPSI/UE Address) |
| Example | ocbsf_bindingQuery_response_total{application="bsf-managementservice",application_error_code="",gpsi="false",ipv4Addr="true",ipv6Prefix="false",macAddr48="false",operation_type="query",response_code="2xx",supi="true",} 1.0 |
Table 7-41 ocbsf_bindingDelete_request_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF receives a request to delete PCF bindings. PCF binding sends the binding ids to BSF. |
| Type | Counter |
| Dimensions | application
operation_type (DELETE) |
| Example | ocbsf_bindingDelete_request_total{application="bsf-management-service",operation_type="manual_delete",pcf_binding_delete_count="3",}1.0 |
Table 7-42 ocbsf_bindingDelete_response_total
| Field | Details |
|---|---|
| Description | This metric is pegged when BSF sends a response message to the delete PCF bindings request. PCF binding sends the binding ids to BSF. |
| Type | Counter |
| Dimensions | application
response_code (2xx,5xx) operation_type (DELETE) |
| Example | ocbsf_bindingDelete_response_total{application="bsf-management-service",application_error_code="",operation_type="manual_delete",pcf_binding_delete_count="3",response_code="2xx",}1.0 |
Table 7-43 topic_version
| Field | Details |
|---|---|
| Description | Describes the current applied version of a given topic (mentioned in dimension topic_name) into the pod. |
| Type | Gauge |
| Dimensions |
|
| Example |
Table 7-44 http_server_requests_seconds_count
| Field | Details |
|---|---|
| Description | BSF Management service overall processing time. |
| Type | Counter |
| Dimensions |
|
| Example | http_server_requests_seconds_count{application="bsf-management-service",exception="None",method="GET",outcome="SUCCESS",status="200",uri="/v3/api-docs/swagger-config",} 1.0 |
Table 7-45 http_server_requests_seconds_sum
| Field | Details |
|---|---|
| Description | BSF Management service overall processing time. |
| Type | Gauge |
| Dimensions |
|
| Example | http_server_requests_seconds_sum{application="bsf-management-service",exception="None",method="GET",outcome="SUCCESS",status="200",uri="/v3/api-docs/swagger-config",} 0.008189215 |
Table 7-46 error_handler_exec_total
| Field | Details |
|---|---|
| Description | This metric is incremented on error handling performed by framework. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_error_handler_exec_total{application="bsf-management-service",application_exception="JavaException",error_type="INTERNAL",operation="CREATE",origin="JAVA",rule_name="REJECT_WITH_ENHANCED_DETAIL",source_interface="POLICY",status="400",target_interface="BSF",wrapped_exception="ServiceException",} |
Table 7-47 error_handler_in_total
| Field | Details |
|---|---|
| Description | This metric is incremented on initialization of error handling. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_error_handler_in_total{application="bsf-management-service",application_exception="JavaException",status="500",wrapped_exception="ServiceException",} |
Table 7-48 error_handler_out_total
| Field | Details |
|---|---|
| Description | This metric is incremented on completion of error handling. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_error_handler_out_total{application="bsf-management-service",application_exception="JavaException",error_resolved="true",status="400",wrapped_exception="ServiceException",} |
7.8 Collision Detection Metrics
Table 7-49 ocbsf_collision_detection_bad_request_code
| Field | Details |
|---|---|
| Description | This metric is pegged when a BAD_REQUEST error code is detected. |
| Metric Type | Counter |
| Dimensions |
|
Table 7-50 ocbsf_collision_detection_not_found_code
| Field | Details |
|---|---|
| Description | This metric is pegged when a NOT_FOUND error code is detected. |
| Type | Counter |
| Dimensions |
|
Table 7-51 ocbsf_collision_detection_forbidden_code
| Field | Details |
|---|---|
| Description | This metric is pegged when a FORBIDDEN error code is detected. |
| Type | Counter |
| Dimensions |
|
Table 7-52 ocbsf_collision_detection_unauthorized_code
| Field | Details |
|---|---|
| Description | This metric is pegged when an UNAUTHORIZED error code is detected. |
| Type | Counter |
| Dimensions |
|
Table 7-53 ocbsf_collision_detection_not_acceptable_code
| Field | Details |
|---|---|
| Description | This metric is pegged when a NON_ACCEPTABLE error code is detected. |
| Type | Counter |
| Dimensions |
|
Table 7-54 ocbsf_collision_detection_service_unavailable_code
| Field | Details |
|---|---|
| Description | This metric is pegged when an UNAVAILABLE error code is detected. |
| Type | Counter |
| Dimensions |
|
Table 7-55 ocbsf_collision_detection_method_not_allowed_code
| Field | Details |
|---|---|
| Description | This metric is pegged when a NOT_ALLOWED error code is detected. |
| Type | Counter |
| Dimensions |
|
Table 7-56 ocbsf_collision_detection_error_code
| Field | Details |
|---|---|
| Description | This metric is pegged when a GENERAL error code is detected. |
| Type | Counter |
| Dimensions |
|
7.9 CM Service Metrics
The following table describes the CM Service metrics and respective dimensions:
Table 7-57 system_operational_state
| Field | Details |
|---|---|
| Description | This metric indicates the current operational state |
| Type | Gauge |
| Dimensions |
|
| Example | system_operational_state{application="config-server",eng_version="",microservice="",namespace="",node="",pod="occnp-config-mgmt",vendor="oracle",} 1.0 |
7.10 Diameter Gateway Metrics
Table 7-58 ocbsf_diam_response_local_total
| Field | Details |
|---|---|
| Description | When the diameter request is timed out from the backend peer (diameter connector), this metric is incremented. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_diam_response_local_total{appId="16777236",cmdCode="265",direction="in",msgType="AAA",reqDestHost="ocbsf",reqDestRealm="oracle.com",reqOrigHost="",reqOrigRealm="",responseCode="timeout",} 1.0 |
Table 7-59 ocbsf_diam_response_network_total
| Field | Details |
|---|---|
| Description | When the diameter request is timed out from the external NF (AF or PCF), this metric is incremented. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_diam_response_network_total{appId="16777236",cmdCode="265",direction="in",msgType="AAA",reqDestHost="oc-diam-gateway",reqDestRealm="oracle.com",reqOrigHost="",reqOrigRealm="",responseCode="timeout",} 1.0 |
Table 7-60 diam_controlled_shutdown_message_reject_total
| Field | Details |
|---|---|
| Description | Indicates failure count because of forced shutdown feature. |
| Type | Counter |
| Dimensions |
|
| Example | diam_controlled_shutdown_message_reject_total{msgType="Gx_CCR_I",appId="16777238",cmdCode="272",destHost="",destRealm="oracle.com",operationalState="PARTIAL_SHUTDOWN",origHost="pgw.oracle.com",origRealm="test.example.com",responseCode="5012",} 1.0 |
Table 7-61 topic_version
| Field | Details |
|---|---|
| Description | Describes the current applied version of a given topic (mentioned in dimension topic_name) into the pod. |
| Type | Gauge |
| Dimensions |
|
Table 7-62 ocbsf_diam_request_network_total
| Field | Details |
|---|---|
| Description | Tracks total number of request messages of given command code to or from network. |
| Type | Counter |
| Dimensions |
|
Table 7-63 ocbsf_diam_request_inter_total
| Field | Details |
|---|---|
| Description | Tracks total number of request messages of given command code to or from host services. |
| Type | Counter |
| Dimensions |
|
Table 7-64 ocbsf_diam_realm_validation_failed_total
| Field | Details |
|---|---|
| Description | Used to count the number of failed Destination-Realm validation at Diameter Gateway for BSF. |
| Type | Counter |
| Dimensions |
|
| Example | ocbsf_diam_realm_validation_failed_total{appId="16777236",cmdCode="265",destHost="",destRealm="oracle.com",origHost="af.oracle.com",origRealm="oracle.com",responseCode="3003",validateRealmFailed="false", validateBindingRealmFailed="true"} 1.0 ; Type-Counter |
7.11 NRF Management Service
Table 7-65 NRF Instance Status
| Field | Details |
|---|---|
| Description | If the metric has
value
0 - NRF is unavailable/unhealthy 1 - NRF is available/healthy |
| Type | Gauge |
| Dimensions | NrfUri - URI of the NRF Instance |
Table 7-66 NRF Instance Status Count
| Field | Details |
|---|---|
| Description | The apiRoot shall be specified in the following
format:
'scheme'://'fqdn':'port' If health check procedure is disabled, all NRF instances are marked as HEALTHY after successful NfRegistration. |
| Type | Gauge |
| Dimensions | NrfUri - URI of the NRF
Instance
HealthStatus FailureReason - Reason for the status |
Table 7-67 NRF Instance Consecutive Healthy Count
| Field | Details |
|---|---|
| Description | The metric shall have a minimum value of 0 and maximum value of healthCheckCount. |
| Type | Gauge |
| Dimensions | NrfUri - URI of the NRF Instance |
Table 7-68 NRF Instance Consecutive Unhealthy Count
| Field | Details |
|---|---|
| Description | The metric shall have a minimum value of 0 and maximum value of healthCheckCount. |
| Type | Gauge |
| Dimensions | NrfUri - URI of the NRF Instance |
Table 7-69 DNS lookup requests
| Field | Details |
|---|---|
| Description | The metric shall be pegged only if enableVirtualNrfResolution is set to true. |
| Type | Gauge |
| Dimensions | Scheme - http or
https
VirtualFqdn - Fqdn that shall be used by the alternate service for the DNS lookup. |
Table 7-70 DNS lookup responses
| Field | Details |
|---|---|
| Description | The metric shall be pegged only if enableVirtualNrfResolution is set to true. |
| Type | Gauge |
| Dimensions | Scheme - http or
https
VirtualFqdn - Fqdn that shall be used by the alternate service for the DNS lookup. HttpStatusCode - The status code as received in the response. |
Table 7-71 DNS setup requests
| Field | Details |
|---|---|
| Description | The metric shall be pegged only if enableVirtualNrfResolution is set to true. |
| Type | Counter |
| Dimensions | Scheme - http or
https
VirtualFqdn - Fqdn that shall be used by the alternate service for the DNS lookup. |
Table 7-72 nrfclient_nfUpdate_status
| Field | Details |
|---|---|
| Description | Indicates if the NfRegister/NfUpdate operation is
successful with NRF after the NfProfile has been updated using the REST
API.
0 - Update is not successful. 1 - Update is successful. NFs may use this metric to configure alerts. |
| Type | Gauge |
| Dimensions |
|
7.12 Overload Control Metrics
Table 7-73 service_resource_stress
| Field | Details |
|---|---|
| Description | This metric tracks CPU, memory, failure count, and pending requests on the basis of which the overload level of a service is calculated. |
| Type | Gauge |
| Dimensions | type, Service |
Table 7-74 service_resource_overload_level
| Field | Details |
|---|---|
| Description | This metric tracks an individual resource's overload level that is calculated based on the resource usage and configured threshold. |
| Type | Gauge |
| Dimensions | type, Service |
Table 7-75 load_level
| Field | Details |
|---|---|
| Description | Provides information about the overload manager load level. |
| Type | Gauge |
| Dimensions | Service, namespace |
Table 7-76 diam_overload_message_reject_total
| Field | Details |
|---|---|
| Description | This metric tracks the total number of messages rejected due to overload on Diameter interface. |
| Type | Counter |
| Dimensions |
priority, response_code Other dimensions:destHost, destRealm, origHost, origRealm, appId, cmdCode, msgType, direction |
7.13 PerfInfo Metrics
Table 7-77 nf_load_info
| Field | Details |
|---|---|
| Description | Provides information about service load. |
| Type | Gauge |
| Dimensions |
|
| Example | nf_load_info{namespace="xxx",service="xxx"} 0.8486912141984638 |
Table 7-78 jvm_cpu_usage
| Field | Details |
|---|---|
| Description | Springboot per service jvm_cpu_usage. |
| Type | Gauge |
| Dimensions |
|
| Example | jvm_cpu_usage{namespace="xxx",service="xxx"} 0.2758240242725142 |
Table 7-79 jvm_memory
| Field | Details |
|---|---|
| Description | Springboot per service jvm_memory. |
| Type | Gauge |
| Dimensions |
|
| Example | jvm_memory{namespace="ttz",service="xxx"} 18.361382484436035 |
Table 7-80 cgroup_cpu_nanoseconds
| Field | Details |
|---|---|
| Description | Reports the total CPU time (in nanoseconds) on each CPU core for all the tasks in the cgroup. |
| Type | Gauge |
| Dimensions | NA |
| Example | cgroup_cpu_nanoseconds 2.1782821080274e+013 |
Table 7-81 cgroup_memory_bytes
| Field | Details |
|---|---|
| Description | Reports the memory usage. |
| Type | Gauge |
| Dimensions | NA |
| Example | cgroup_memory_bytes 1.31289088e+08 |
Table 7-82 load_level
| Field | Details |
|---|---|
| Description | This metric provides information about the load level of a service. |
| Type | Gauge |
| Dimension |
|
| Example | load_level{serivce="xxx"} L1 |
Table 7-83 system_overload_threshold_config_mode
| Field | Details |
|---|---|
| Description | Indicates whether the overload level threshold configuration is based on STANDALONE or PROFILE mode. |
| Type | Gauge |
| Dimension |
|
| Example | system_overload_threshold_config_mode 1.0 |
Table 7-84 active_overload_threshold_fetch_failed
| Field | Details |
|---|---|
| Description | Indicates whether the active profile data is fetched successfully or failed to fetch. |
| Type | Gauge |
| Dimension |
|
| Example | active_overload_threshold_fetch_failed 1.0 |
Table 7-85 load_level_report_total
| Field | Details |
|---|---|
| Description | This metric is used to track:
|
| Type | Counter |
| Dimension |
|
| Example | load_level_report_total{namespace="hi-riley", service="pcf-occnp-pcrf-core", isLeaderPod="True", level="Normal", levelChangeType="-"} 2.0 |
Table 7-86 service_resource_stress
| Field | Details |
|---|---|
| Description | This metric tracks CPU, memory, failure count, and pending requests on the basis of which the overload level of a service is calculated. |
| Type | Gauge |
| Dimension |
|
| Example | service_resource_stress{service="xxx", type="xxx"} 10.0 |
Table 7-87 service_resource_overload_level
| Field | Details |
|---|---|
| Description | This metric tracks an individual resource's overload level that is calculated based on the resource usage and configured threshold. |
| Type | Gauge |
| Dimension |
|
| Example | service_resource_overload_level{service="xxx", type="xxx"}2.0 |
Table 7-88 service_resource_overload_level_report_total
| Field | Details |
|---|---|
| Description | This metric is used to track:
|
| Type | Counter |
| Dimension |
|
| Example | service_resource_overload_level_report_total{namespace="hi-riley", service="pcf-occnp-pcrf-core", isLeaderPod="True", level="Normal", levelChangeType="-", type="cpu"} 2.0 |
Table 7-89 http_out_conn_request
| Field | Details |
|---|---|
| Description | This counter metric is used to count the number of http API Egress requests. |
| Type | Counter |
| Dimension |
|
| Example |
Table 7-90 http_out_conn_response
| Field | Details |
|---|---|
| Description | This counter metric is used to count the number of http API Egress responses. |
| Type | Counter |
| Dimension |
|
| Example |
Table 7-91 overload_manager_enabled
| Field | Details |
|---|---|
| Description | This metric indicates whether overload manager is enabled or disabled. |
| Type | Gauge |
| Dimension |
|
| Example | overload_manager_enabled{namespace="hi-riley", source="DIAM_GW"} 1 |
Table 7-92 leader_pod
| Field | Details |
|---|---|
| Description | This metric is used to know the leader pod. |
| Type | Gauge |
| Dimension |
|
| Example | leader_pod{namespace="hi-riley"} 1 |
For more information about dimensions, see Binding Support Function Metrics.
7.14 Pod Congestion Metrics
Table 7-93 ocbsf_pod_congestion_state
| Field | Details |
|---|---|
| Description | Tracks congestion state of pod. |
| Type | Gauge |
| Dimensions | level = 0,1,2 (0 = Normal, 1 = DoC, 2 = Congested) |
Table 7-94 ocbsf_pod_resource_stress
| Field | Details |
|---|---|
| Description | Tracks CPU, memory, queue usage (percentage) based on which POD is calculating its congestion state. |
| Type | Gauge |
| Dimensions | type = "PendingRequest","CPU","Memory" |
Table 7-95 ocbsf_pod_resource_congestion_state
| Field | Details |
|---|---|
| Description | Tracks individual resource's congestion state calculated based on the resource usage and configured threshold. |
| Type | Gauge |
| Dimensions | type =
"PendingRequest","CPU","Memory"
level = 0,1,2 (0 = Normal, 1 = DoC, 2 = Congested) |
Table 7-96 ocbsf_diam_congestion_message_reject_total
| Field | Details |
|---|---|
| Description | Tracks number of messages rejected due to congestion. |
| Type | Counter |
| Dimensions | priority = calculated or received DRMP priority of
message being
rejected
response_code = response code sent with rejected message destHost, destRealm, origHost, origRealm, appId, cmdCode, msgType, direction |
7.15 User-Agent Header Metrics
The following metric is introduced for User-Agent Header:
Table 7-97 oc.ingressgateway.http.requests
| Field | Details |
|---|---|
| Description | This metric is pegged for every incoming request. If the User-Agent header is not present, then UNKNOWN will be pegged. This will be independent of the User Agent validation feature at the Ingress Gateway. |
| Type | Counter |
| Dimensions |
|
7.16 Query Service Metrics
Table 7-98 queryservice_request
| Field | Details |
|---|---|
| Description | Number of query requests received. |
| Type | Counter |
| Dimensions | RequestType |
| Example | queryservice_response_total{Code="2xx",ReqType="GET",} 195.0 |
Table 7-99 queryservice_response
| Field | Details |
|---|---|
| Description | Number of responses sent for query requests. |
| Type | Counter |
| Dimensions | RequestType |
| Example | queryservice_request_total{ReqType="GET",} 257.0 |
Table 7-100 queryservice_sessionDelete_request
| Field | Details |
|---|---|
| Description | Total number of query requests to delete PCF bindings. |
| Type | Counter |
| Dimensions |
|
| Example | queryservice_sessionDelete_request{ReqType="DELETE",} 257.0 |
Table 7-101 queryservice_sessionDelete_response
| Field | Details |
|---|---|
| Description | Total number of responses for delete PCF bindings query requests. |
| Type | Counter |
| Dimensions |
|
| Example | queryservice_sessionDelete_response{Code="2xx",ReqType="DELETE",} 195.0 |
7.17 TLS Metrics
The following table describes the TLS metrics and the respective dimensions:
Table 7-102 oc_ingressgateway_incoming_tls_connections
| Field | Details |
|---|---|
| Description | Number of TLS Connections received on the Ingress Gateway and their negotiated TLS versions. The versions can be TLSv1.3 or TLSv1.2 |
| Type | Gauge |
| Dimensions |
|
| Example |
Table 7-103 oc_egressgateway_incoming_tls_connections
| Field | Details |
|---|---|
| Description | Number of TLS Connections received on the Egress Gateway and their negotiated TLS versions. The versions can be TLSv1.3 or TLSv1.2 |
| Type | Gauge |
| Dimensions |
|
| Example |
Table 7-104 security_cert_x509_expiration_seconds
| Field | Details |
|---|---|
| Description | Indicates the time to certificate expiry in epoch seconds. |
| Type | Histogram |
| Dimensions | serialNumber |
| Example |
Table 7-105 diam_conn_network
| Field | Details |
|---|---|
| Description | Indicates the number of TLS connections per TLS version. |
| Type | Gauge |
| Dimensions | tlsversion |
| Example | diam_conn_network{destHost="",destRealm="",direction="out",origHost="oc-diam-gateway",origRealm="oracle.com",tlsVersion="TLSv1.3"} 1 this metric will depict the number of tls connections . |
Table 7-106 diam_failed_conn_network
| Field | Details |
|---|---|
| Description | Indicates the number of failed TLS
connections.
Note: It is applicable when we configure Initiate Connection to true in peer node configurations in the CNC Console. |
| Type | Gauge |
| Dimensions |
|
| Example | diam_failed_conn_network{peerName="dgw",reason="SSL Handshake Exception",} 1.0 |
Table 7-107 diam_conn_network_responder
| Field | Details |
|---|---|
| Description | Indicates the number of allowed TLS responder connections with or without the peer configuration. |
| Type | Gauge |
| Dimensions |
|
| Example | diam_conn_network_responder{destHost="",destRealm="",direction="in",origHost="oc-diam-gateway",origRealm="oracle.com",tlsVersion="TLSv1.3", peerConfigValidated="true"} |
Table 7-108 dgw_tls_cert_expiration_seconds
| Field | Details |
|---|---|
| Description | Indicates the number of allowed TLS responder connections with or without the peer configuration. |
| Type | Gauge |
| Dimensions |
|
| Example | dgw_tls_cert_expiration_seconds{serialNumber="122859034516052844067924392230910496431389299229",subject="OU=CGIU, O=ORCL, L=BLR, ST=KA, C=IN",} 1.797882352E9 |
7.18 NRF Client Metrics
NF status and NF load metrics
Table 7-109 nrfclient_perf_info_nf_profile_load
| Field | Details |
|---|---|
| Description | The current Load of the NF. |
| Type | Gauge |
| Dimensions |
Table 7-110 nrfclient_current_nf_status
| Field | Details |
|---|---|
| Description | The current operative status of the NF. The gauge
shall be indicate the status as below:
|
| Type | Gauge |
| Dimensions |
|
Table 7-111 nrfclient_nf_status_with_nrf
| Field | Details |
|---|---|
| Description | The operative status of the NF communicated to the
NRF. The gauge shall be indicate the status as below:
|
| Type | Gauge |
| Dimensions |
|
NRF Health Status
Table 7-112 nrfclient_nrf_operative_status
| Field | Details |
|---|---|
| Description | The current operative status of the NRF Instance. If
the metric has value
|
| Type | Gauge |
| Dimensions | NrfUri - URI of the NRF Instance |
Table 7-113 nrfclient_nrf_status_total
| Field | Details |
|---|---|
| Description | Total number of times an NRF instance is marked as
healthy or unhealthy. The apiRoot is specified in the format
'scheme'://'fqdn':'port'.
Note: If health check procedure is disabled, all NRF instances are marked as HEALTHY after successful NF registration. |
| Type | Counter |
| Dimensions | NrfUri- URI of the NRF InstanceHealthStatus FailureReason - Reason for the status |
Table 7-114 nrfclient_nrf_successive_healthy_count
| Field | Details |
|---|---|
| Description | The metric shows the consecutive number of times the NRF is considered as healthy. The metric has a minimum value of 0 and maximum value of healthCheckCount. |
| Type | Counter |
| Dimensions | NrfUri- URI of the NRF Instance |
Table 7-115 nrfclient_nrf_successive_unhealthy_count
| Field | Details |
|---|---|
| Description | The metric shows the consecutive number of times the NRF is considered as unhealthy |
| Type | Counter |
| Dimensions | NrfUri- URI of the NRF Instance |
NF - NRF-Client metrics
Table 7-116 nrfclient_on_demand_conn_in_request_total
| Field | Details |
|---|---|
| Description | Total number of on-demand requests received from the backend NF to NRF Client. |
| Type | Counter |
| Dimensions |
|
Table 7-117 nrfclient_on_demand_conn_out_response_total
| Field | Details |
|---|---|
| Description | Total number of on-demand responses sent to the backend NF to NRF Client. |
| Type | Counter |
| Dimensions |
|
Table 7-118 nrfclient_on_demand_processing_latency_ms
| Field | Details |
|---|---|
| Description | Total message processing time duration in milliseconds. |
| Type | Histogram |
| Dimensions |
|
Table 7-119 ocpm_nrf_tracing_request_timeout_total
| Field | Details |
|---|---|
| Description | Total number of requests timeout sent to the backend NF from NRF Client. |
| Type | Counter |
| Dimensions |
|
NRF-Client - NRF metrics
Table 7-120 nrfclient_nw_conn_out_request_total
| Field | Details |
|---|---|
| Description | Total number of times NRF-client has sent a request to NRF. This includes autonomous requests as well as on-demand requests. |
| Type | Counter |
| Dimensions |
|
Table 7-121 nrfclient_nw_conn_in_response_total
| Field | Details |
|---|---|
| Description | Total number of times NRF-client has received a response from NRF. |
| Type | Counter |
| Dimensions |
|
Table 7-122 nrfclient_nw_conn_in_notify_request_total
| Field | Details |
|---|---|
| Description | Total number of nfStatusNotify requests received from NRF. |
| Type | Counter |
| Dimensions |
|
Table 7-123 nrfclient_nw_conn_out_notify_response_total
| Field | Details |
|---|---|
| Description | Total number of nfStatusNotify responses sent to NRF. |
| Type | Counter |
| Dimensions |
|
Table 7-124 nrfclient_network_message_processing_latency
| Field | Details |
|---|---|
| Description | Total message processing time duration. |
| Type | Histogram |
| Dimensions |
|
7.19 Metrics for Automated Certificate Lifecycle Management
The following metrics are used to support automated certificate lifecycle management for BSF:
Table 7-125 oc_certificatemanagement_tls_certificate_info
| Field | Details |
|---|---|
| Description | This metric is used to peg status of TLS certificates. This metric is further used for raising alarms. |
| Type | Gauge |
| Dimensions |
|
| Example | occnp_oc_certificatemanagement_tls_certificate_info{CertificateName="key-password.txt,bsf.cer,pcf.pem,trust-chain-password.txt,trust-chain.cer,",SecretName="bsf-igw-tls-ssl-bundle",Service="IngressGateway",Status="VALID",} 1.0 |