Created: | Updated:
z/IRIS Server (a.k.a. IronTap)
The requirements and recommendations below achieve an average processing throughput of 10,000 SMF records per second. Users should adjust the following requirements, as needed, to meet the required SMF processing throughput in each environment.
4 logical processors
Recommended Linux distributions
Ubuntu 16.04+, Debian 7+
Supports operating systems with English language support only.
AdoptOpenJDK is recommended
IronTap Docker image
Recommended Docker version: 20.10+
OpenTelemetry ziris-instrumentation-extension module
IBM Db2 for z/OS JDBC drivers
Compatible version 4 JDBC drivers for IBM Db2 for z/OS version 12 are supported by the z/IRIS Instrumentation Extension for OpenTelemetry Java agents.
IBM documents compatible drivers here.
OpenTelemetry Java agent version
Refer to ziris-instrumentation-extensions versions to find out which ziris-instrumentation-extension release is compatible with your OpenTelemetry Java agent.
zFS mounted file system
Minimum allocated space
Mainframe software requirements
Supported z/OS releases
z/OS 2.1, z/OS 2.2, z/OS 2.3, z/OS 2.4
Required Java platform
IBM SDK, Java Technology Edition, Version 8 64 Bit
At least 1 SMF in-memory resource must be defined for any SMF record types that will be streamed via z/IRIS.
SMF Logstream mode is a prerequisite to activate SMF in-memory resources.
TCP/IP must be active and configured on z/OS.
Users should ensure that the number of SMF records written to a single SMF in-memory resource will not result in a loss of SMF records due an exceptionally high throughput vs available buffer space.
2.2.0 or newer
Apache Kafka provides a bi-directional compatibility policy since version 0.10.2. This means that older versions may work as well. We recommend always using the latest generally available libraries as they include vital security patches and performance improvements.
The Apache Kafka Configuration Guide provides system configuration for 10,000 SMF Records/s (~35.000 KB/s depending on the type of records). This configuration would need to be scaled to meet total SMF throughput processing.
Supported SMF records
Click here for a list of supported SMF records.
Distributed Db2 trace streaming for APM integration
Db2 for z/OS Releases
Db2 for z/OS v12
SMF Record Types
Supported JDBC Features
3 (TRACE(ACCTG) CLASS(1-3))
172 (TRACE(PERFM) CLASS(30-32))