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.
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.

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.
      - Configuring Prometheus without ServiceMonitor
        Configure Prometheus with annotations to scrape SNMP-based metrics from SNMP Exporter.
      - Configuring MATRIXX Pod Annotations for Prometheus
        Add annotations to MATRIXX pods using the using the global.annotations.podAnnotations configuration property.
    - 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.
    - 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

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.