Monitoring
Logging
The connector makes use of SLF4J for logging integration. The logger uses the logger name org.init.ohja.kafka.connect.adso.sink. The logging destination and format can be configured, e.g. in the log4j configuration properties in the Confluent Platform or via Kafka Connect configuration file.
SAP® JCo includes a logger called com.sap.conn.jco which can only be used with log4j. In addition to setting the logging level for the JCo logger, one can use configuration property jco.trace_level to fine tune the level of logging.
The connector provides additional log location information ohja.location using MDC (mapped diagnostic context). The log location contains the name of the nearest enclosing definition of val, class, trait, object or package and the line number.
Example Log4j 1.x appender:
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[%d] %p %X{connector.context}%m %X{ohja.location}%n
If using the Confluent Platform, the logs can be seen by running a CLI command:
confluent local services connect log
For additional details check out the official tutorial.
aDSO Monitoring in SAP
SAP® BI related transaction RSA1 can be used for monitoring and administration purposes.
JMX Metrics
The BW aDSO Sink Connector supports all the connector and task metrics provided by Kafka Connect through Java Management Extensions (JMX). In addition, the BW aDSO Sink Connector provides extra JMX metrics for accessing state managed by the connector.
MBean: org.init.ohja.kafka.connect:type=adso-sink-task-metrics,connector=([-.w]+),task=([d]+)
| Metric | Explanation |
|---|---|
| retries | Count of retries performed in the connector task that is in retrying state. |
| ${configGroup}-name | Advanced Data Store Object name configured in the configuration group. |
| ${configGroup}-request-begin | Start timestamp of the request for the Advanced Data Store Object configured in the configuration group. |
| ${configGroup}-row-count | Row count of inserted rows in a request for the Advanced Data Store Object configured in the configuration group. |