Home
MATRIXX Kafka CDR Consumer
Deploying Kafka CDR Consumer and Extensions
Deploying Kafka CDR Consumer and extensions involves installing and configuring the Kafka CDR Consumer and extension Helm charts. This section explains how to install and modify the Helm charts and the properties you configure. For information about the Helm properties, see the discussions about Kafka CDR Consumer properties and each extension.
Kafka CDR Consumer Properties
cdr_consumer/r_kafka_cdr_consumer_props.html#reference_amn_k4x_3wb__table_uzz_xhk_xlb describes the properties in the Kafka CDR Consumer Helm values file that configure Kafka CDR Consumer.
Kafka CDR Consumer Tracing Properties
You can configure tracing in the Kafka CDR Consumer Helm chart by using the OpenTelemetry SDK Auto Configure Extension and exporting environment variables. cdr_consumer/r_kafka_cdr_consumer_tracing_props.html#reference_cx2_1fp_mwb__table_ims_541_f5b describes the environment variables that configure OpenTelemetry tracing for Kafka CDR Consumer.

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
MATRIXX Policy
MATRIXX Kafka CDR Consumer
- About MATRIXX Kafka CDR Consumer
  MATRIXX Kafka CDR Consumer provides information about how to install, configure, and extend Kafka CDR Consumer and its out-of-the-box extensions.
- Kafka CDR Consumer Overview
  Kafka CDR Consumer is a cloud native Apache Kafka Consumer microservice that consumes charging data records (CDRs) that are injected into Kafka topics by external systems or from MATRIXX CDRs. The offline Kafka CDR Consumer retrieves the events from the Kafka topics and injects them into MATRIXX Engine for usage rating and charging.
- Deploying Kafka CDR Consumer and Extensions
  Deploying Kafka CDR Consumer and extensions involves installing and configuring the Kafka CDR Consumer and extension Helm charts. This section explains how to install and modify the Helm charts and the properties you configure. For information about the Helm properties, see the discussions about Kafka CDR Consumer properties and each extension.
  - Install Kafka CDR Consumer and Extensions
    Install and configure Kafka CDR Consumer or an extension using the supplied Helm chart.
  - Kafka CDR Consumer Properties
    cdr_consumer/r_kafka_cdr_consumer_props.html#reference_amn_k4x_3wb__table_uzz_xhk_xlb describes the properties in the Kafka CDR Consumer Helm values file that configure Kafka CDR Consumer.
    - Kafka CDR Consumer Engine Connection Properties
      You can specify an engine client connection in the Kafka CDR Consumer Helm chart. cdr_consumer/r_kafka_cdr_consumer_engine_props.html#reference_iqz_3px_3wb__table_qwf_ps1_hwb describes the properties that configure an engine client connection for Kafka CDR Consumer.
    - Kafka CDR Consumer Log Rotation Properties
      You can configure log rotation in the Kafka CDR Consumer Helm Chart component using environment variables as values for the SizeBasedTriggeringPolicy and DefaultRolloverStrategy elements of the log4j2.xml file. cdr_consumer/r_kafka_cdr_consumer_log_props.html#reference_c35_3qx_3wb__table_bty_4kh_hwb describes the environment variables that configure log file rotation for Kafka CDR Consumer.
    - Kafka CDR Consumer Tracing Properties
      You can configure tracing in the Kafka CDR Consumer Helm chart by using the OpenTelemetry SDK Auto Configure Extension and exporting environment variables. cdr_consumer/r_kafka_cdr_consumer_tracing_props.html#reference_cx2_1fp_mwb__table_ims_541_f5b describes the environment variables that configure OpenTelemetry tracing for Kafka CDR Consumer.
- Monitoring Kafka CDR Consumer
  Use aggregated logging and the Prometheus and Grafana third-party products to monitor Kafka CDR Consumer.
- TAP3 JSON Kafka CDR Consumer
  The TAP3 JSON Kafka CDR Consumer is an out-of-box extension that consumes JSON-mapped TAP3 messages from Apache Kafka topics and maps them to MtxDiamRoMsg messages for MATRIXX Engine rating.
- Diameter CDR Kafka CDR Consumer
  The Diameter CDR Kafka CDR Consumer is an out-of-box extension that consumes plain MtxDiamRoMsg protocol buffer binary files and maps them to MtxDiamRoMsg charging messages for MATRIXX Engine rating.
- CHF CDR Kafka CDR Consumer
  The CHF CDR Kafka CDR Consumer is an out-of-box extension that consumes plain Mtx5GMsg compact MDCs (CMDCs) and maps them to Mtx5GMsg charging messages for MATRIXX Engine rating.
- Create a Custom Kafka CDR Consumer Extension
  You can create your own custom Kafka CDR Consumer extensions for charging implementations that are not covered by out-of-box extensions delivered with the Kafka CDR Consumer.
- Deploy a Custom Kafka CDR Consumer Extension
  All Kafka CDR Consumer extensions can use the same Helm chart. After you create an extension, you can use a Helm values file to manually deploy the image. Each extension you create can have its own values file.
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

Kafka CDR Consumer Tracing Properties

You can configure tracing in the Kafka CDR Consumer Helm chart by using the OpenTelemetry SDK Auto Configure Extension and exporting environment variables. OpenTelemetry Configuration Properties describes the environment variables that configure OpenTelemetry tracing for Kafka CDR Consumer.

Table 1. OpenTelemetry Configuration Properties
Property	Description
opentelemetry.enable	Set to `true` to enable OpenTelemetry tracing.
opentelemetry.serviceName	The service name, for example, kafka-cdr-consumer.
opentelemetry.endPointUrl	The URL to the OpenTelemetry Collector endpoint. The default is http://localhost:4317.
opentelemetry.propagators	A comma-separated list of propagators that propagate the trace context over the wire.
opentelemetry.tracesExporter	The trace exporter. Set the value to `otlp` when paired with OpenTelemetry Collector server.
opentelemetry.resourceAttributes	Specifies additional OpenTelemetry resource attributes in the format: key1=val1,key2=val2,key3=val3.

The following is a tracing configuration example:

opentelemetry:
  # telemetry required engine.transportType set to HTTP_1_1 or HTTP_2
  enable: false
  serviceName: kafka-cdr-consumer
  endPointUrl: http://localhost:4317
  propagators: b3multi
  tracesExporter: otlp
  # Specify additional OpenTelemetry resource attributes in format: key1=val1,key2=val2,key3=val3
  resourceAttributes: ""