Created 13 Jul 2021 , Updated 16 May 2022
Properties can be provided via JVM properties or a mounted configuration file.
You may provide the necessary configuration via system properties. Simply set the required properties with the -D
flag after the image name. Any value that exists in the configuration file can be set this way.
Example: Start Irontap with Instana integration
Use the following docker command to start IronTap with Instana integration:
docker run \
--name irontap \
mainstorconcept.jfrog.io/ziris-docker-release/irontap:latest-kafka-instana \
-Dirontap.apm.instana.connection.hostname="localhost" \
-Dirontap.apm.instana.connection.port="42699"
CODE
Example: Start Irontap with OpenTelemetry integration
An OTLP endpoint needs to be set for OpenTelemetry integration
Use the following docker command to start IronTap with OpenTelemetry integration:
docker run \
--name irontap \
mainstorconcept.jfrog.io/ziris-docker-release/irontap:latest-kafka-otel \
-Dirontap.apm.otel.exporter.otlp.endpoint="http://collector:4317"
CODE
Example: Start Irontap with Datadog integration
A Datadog agent endpoint needs to be set for Datadog integration
Use the following docker command to start IronTap with Datadog integration including event propagation and required prefixes for metrics:
docker run
--name irontap \
mainstorconcept.jfrog.io/ziris-docker-release/irontap:latest-kafka-datadog \
-Dirontap.apm.datadog.agent.url="http://agent:8126/v0.3/traces" \
-Dirontap.apm.datadog.events.site="https://api.datadoghq.com/api/v1/events" \
-Dirontap.apm.datadog.events.apiKey="908fb9eaa85bfb05189925e0b337ac50" \
-Dirontap.zos.connect.telemetry.measurement.prefix="mainstorconcept.zos.connect" \
-Dirontap.zos.rmf.telemetry.measurement.prefix="mainstorconcept.zos.rmf" \
-Dirontap.zos.mq.telemetry.measurement.prefix="mainstorconcept.zos.mq"
CODE
For more information on how to integrate IronTap containers with APMs, refer to the following documentation:
>> Instana APM integration
>> OpenTelemetry integration
>> Datadog integration
>> Configure IronTap server
A configuration file can be mounted instead of using system properties to provide the necessary configuration for the IronTap container.
Example: Start Irontap with Instana integration
Use the following docker command to start IronTap with Instana integration:
docker run \
--name irontap \
--mount type=bind,source=/host/path/to/application.conf,target=/opt/mainstorconcept/irontap/application.conf,readonly \
mainstorconcept.jfrog.io/ziris-docker-release/irontap:latest-kafka-instana
CODE
Example: Start Irontap with OpenTelemetry integration
An OTLP endpoint needs to be set for OpenTelemetry integration.
Use the following docker command to start IronTap with OpenTelemetry integration:
docker run \
--name irontap \
--mount type=bind,source=/host/path/to/application.conf,target=/opt/mainstorconcept/irontap/application.conf,readonly \
mainstorconcept.jfrog.io/ziris-docker-release/irontap:latest-kafka-otel
CODE
>> Configuring IronTap container logging
>> Configure IronTap server