Home
MATRIXX Monitoring and Logging
Metrics and Alerts
The following information describes monitoring metrics and alerts information for MATRIXX. MATRIXX Support recommends using the Prometheus and Grafana third-party products to monitor a MATRIXX environment, along with aggregated logging.
Monitoring with Prometheus and Grafana
The following information describes how to implement monitoring through Prometheus in a containerized environment for MATRIXX. Information collected by Prometheus can be displayed with tools such as Grafana.
MATRIXX Engine and TRA Monitoring
After you have implemented monitoring through Prometheus, you can refer to metrics for MATRIXX Engine and Traffic Routing Agent (TRA) described in this section.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
- About MATRIXX Monitoring and Logging
  MATRIXX Monitoring and Logging describes monitoring and logging for MATRIXX components in a MATRIXX environment.
- Metrics and Alerts
  The following information describes monitoring metrics and alerts information for MATRIXX. MATRIXX Support recommends using the Prometheus and Grafana third-party products to monitor a MATRIXX environment, along with aggregated logging.
  - Monitoring with Prometheus and Grafana
    The following information describes how to implement monitoring through Prometheus in a containerized environment for MATRIXX. Information collected by Prometheus can be displayed with tools such as Grafana.
    - Installing Prometheus and Grafana
      Most Kubernetes environments offer a Prometheus and Grafana stack, often disabled by default.
    - Using Prometheus without ServiceMonitor
      Enabling monitoring with the MATRIXX Helm chart global.monitoring.enabled property installs a ServiceMonitor custom resource definition (CRD). When Prometheus is installed with the Prometheus operator, it discovers this CRD and configures itself to collect metrics from MATRIXX endpoints. If you install Prometheus without the operator, you must manually configure Prometheus to point to MATRIXX endpoints and configure the MATRIXX Helm chart to add annotations to the pods.
    - Prometheus Metrics Dashboard
      Prometheus metrics can be viewed directly in the Prometheus dashboard.
    - Grafana Dashboards
      To display MATRIXX metrics, MATRIXX provides Grafana dashboard templates in JSON format.
    - MATRIXX Engine and TRA Monitoring
      After you have implemented monitoring through Prometheus, you can refer to metrics for MATRIXX Engine and Traffic Routing Agent (TRA) described in this section.
      - MATRIXX Engine Metrics
        This topic describes the metrics available to Prometheus from MATRIXX Engine.
      - Common Metrics Recommended for Grafana
        The following common metrics are recommended for MATRIXX Engine Grafana dashboards.
      - Engine Metrics Recommended for Grafana
        The following MATRIXX Engine metrics are recommended for MATRIXX Engine Grafana dashboards.
      - Out-of-Bounds Engine System Resource Metrics
        Use the mtx-engine-system-health-check container in the engine-health-checker pod to monitor the engine pod system resources that are being used, including CPU and disk space, and alert users when the metrics they are monitoring are outside predefined bounds.
      - inspect_engine_metrics.py
        The inspect_engine_metrics.py script analyzes engine metrics against user-defined boundaries. It can be run inside a MATRIXX pod or in a Kubernetes cluster outside of a MATRIXX pod.
      - Traffic Routing Agent Metrics
        docker_kubernetes/r_prom_tra.html#reference_smw_s4r_wwb__table_dhn_rvl_spb describes the metrics available to Prometheus for the Traffic Routing Agent (TRA).
      - Route Cache Controller Metrics
        Route Cache Controller Metrics describes the metrics available to Prometheus from Route Cache Controller (RC).
    - Java Application Monitoring
      Java application monitoring is facilitated by Micrometer Stats Exporter and Spring Boot Actuator.
    - Viewing MATRIXX SNMP Stats with Grafana
      Use Grafana to display MATRIXX SNMP statistics and other metrics exported to Prometheus, using MATRIXX-provided custom Grafana dashboard templates.
    - Monitoring Network Enabler with Prometheus
      Network Enabler (NE) SNMP statistics can be monitored with Prometheus.
  - Cluster HA States
    A cluster can change high availability (HA) states during engine start up, manual switchover, failover, and when the connection to a remote peer cluster is lost.
  - MATRIXX Engine Start-Up Sequence
    A Topology Operator engine-starter instance starts MATRIXX Engine and engine-level Traffic Routing Agent (TRA-PROC and TRA-PUB) pods.
  - Monitoring the MATRIXX Engine Environment Locally
    The following topics explain how to monitor the MATRIXX Engine locally using the internal MATRIXX Engine tools.
  - Custom System Monitor Configuration
    You configure the optional MATRIXX System Monitor by editing the sysmon_config.xml file. After the file is configured, System Monitor continuously monitors the MATRIXX Engine processing pod.
  - Alert Management Integration with SNMP Traps
    In a Cloud Native environment you can integrate the statistics and metrics data collected by Prometheus with other systems, such as Alert Manager, and you can configure snmp-notifier to convert the generated alerts to SNMP traps for reporting in external monitoring systems.
  - Retrieving Core Dump Information
    Core dumps are files that include the complete contents of the memory of a process at a point in time. Core dump handling in MATRIXX must be enabled per namespace. By default this feature is disabled and the commonly mounted /coredumps directory is empty until this feature is enabled.
- Logging
  The following describes logging information for MATRIXX.
- Tracing
  The following information describes tracing information for MATRIXX.
- Monitoring Components
  The following information describes monitoring different components for MATRIXX.
- Appendixes
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

MATRIXX Engine and TRA Monitoring

After you have implemented monitoring through Prometheus, you can refer to metrics for MATRIXX Engine and Traffic Routing Agent (TRA) described in this section.