DBZ-2741 Remove obsolete monitoring content from /partials
directory
This commit is contained in:
parent
347009e474
commit
d17f354d4f
@ -1,17 +0,0 @@
|
|||||||
:context: debezium
|
|
||||||
|
|
||||||
[id="enabling-jmx-docker"]
|
|
||||||
= Enabling JMX in Docker
|
|
||||||
|
|
||||||
If you are running Zookeeper, Kafka, and Kafka Connect in Docker containers,
|
|
||||||
enabling JMX requires several additional environment variables that are not typically needed when running on a local machine.
|
|
||||||
This is because the JVM requires the host name to which it will advertise itself to JMX clients.
|
|
||||||
Thus, {prodname}'s Docker images for Zookeeper, Kafka, and Kafka Connect use several environment variables to enable and configure JMX.
|
|
||||||
Most of the environment variables are the same for all of the images,
|
|
||||||
but there are some minor differences.
|
|
||||||
|
|
||||||
include::{partialsdir}/modules/monitoring/ref-zookeeper-jmx-environment-variables-docker.adoc[leveloffset=+1]
|
|
||||||
|
|
||||||
include::{partialsdir}/modules/monitoring/ref-kafka-jmx-environment-variables-docker.adoc[leveloffset=+1]
|
|
||||||
|
|
||||||
include::{partialsdir}/modules/monitoring/ref-kafka-connect-jmx-environment-variables-docker.adoc[leveloffset=+1]
|
|
@ -1,13 +0,0 @@
|
|||||||
:context: debezium
|
|
||||||
|
|
||||||
[id="enabling-jmx-local-installation"]
|
|
||||||
= Enabling JMX in local installations
|
|
||||||
|
|
||||||
With Zookeeper, Kafka, and Kafka Connect,
|
|
||||||
you enable JMX by setting the appropriate environment variables when you start each service.
|
|
||||||
|
|
||||||
include::{partialsdir}/modules/monitoring/ref-zookeeper-jmx-environment-variables.adoc[leveloffset=+1]
|
|
||||||
|
|
||||||
include::{partialsdir}/modules/monitoring/ref-kafka-jmx-environment-variables.adoc[leveloffset=+1]
|
|
||||||
|
|
||||||
include::{partialsdir}/modules/monitoring/ref-kafka-connect-jmx-environment-variables.adoc[leveloffset=+1]
|
|
@ -1,16 +0,0 @@
|
|||||||
|
|
||||||
[id="metrics-monitoring-connectors"]
|
|
||||||
= Metrics for monitoring {prodname} connectors
|
|
||||||
|
|
||||||
In addition to the built-in support for JMX metrics in Kafka, Zookeeper, and Kafka Connect,
|
|
||||||
each connector provides additional metrics that you can use to monitor their activities.
|
|
||||||
|
|
||||||
* {link-prefix}:{link-mysql-connector}#mysql-monitoring[MySQL connector metrics]
|
|
||||||
* {link-prefix}:{link-mongodb-connector}#mongodb-monitoring[MongoDB connector metrics]
|
|
||||||
* {link-prefix}:{link-postgresql-connector}#postgresql-monitoring[PosgreSQL connector metrics]
|
|
||||||
* {link-prefix}:{link-sqlserver-connector}#sqlserver-monitoring[SQL Server connector metrics]
|
|
||||||
* {link-prefix}:{link-db2-connector}#db2-monitoring[Db2 connector metrics]
|
|
||||||
ifdef::community[]
|
|
||||||
* {link-prefix}:{link-oracle-connector}#oracle-monitoring[Oracle connector metrics]
|
|
||||||
* {link-prefix}:{link-cassandra-connector}#cassandra-monitoring[Cassandra connector metrics]
|
|
||||||
endif::community[]
|
|
@ -1,10 +0,0 @@
|
|||||||
[id="using-prometheus-grafana"]
|
|
||||||
= Using Prometheus and Grafana
|
|
||||||
|
|
||||||
The metrics exposed by {prodname} and Kafka can be exported and displayed with https://prometheus.io/[Prometheus] and https://grafana.com/[Grafana].
|
|
||||||
You can find an example for the required configuration and example dashboards for different connectors in the https://github.com/debezium/debezium-examples/tree/master/monitoring[Debezium examples repository].
|
|
||||||
|
|
||||||
[NOTE]
|
|
||||||
====
|
|
||||||
These dashboards are not part of {prodname} itself and are maintained on a best-effort basis.
|
|
||||||
====
|
|
@ -1,51 +0,0 @@
|
|||||||
[id="kafka-connect-jmx-environment-variables-docker"]
|
|
||||||
= Kafka Connect JMX environment variables in Docker
|
|
||||||
|
|
||||||
The `debezium/connect` image recognizes the following JMX-related environment variables:
|
|
||||||
|
|
||||||
`JMXPORT` (Required)::
|
|
||||||
The port number that will be used for JMX.
|
|
||||||
The value is used to specify the following JVM parameters:
|
|
||||||
+
|
|
||||||
** `-Dcom.sun.management.jmxremote.port=$JMXPORT`
|
|
||||||
** `-Dcom.sun.management.jmxremote.rmi.port=$JMXPORT`
|
|
||||||
|
|
||||||
`JMXHOST` (Required)::
|
|
||||||
The IP address or resolvable host name of the Docker host,
|
|
||||||
which JMX uses to construct a URL sent to the JMX client.
|
|
||||||
A value of `localhost` or `127.0.0.1` will not work.
|
|
||||||
Typically, `0.0.0.0` can be used.
|
|
||||||
The value is used to specify the JVM parameter `-Djava.rmi.server.hostname=$JMXHOST`.
|
|
||||||
|
|
||||||
`JMXAUTH`::
|
|
||||||
Whether JMX clients must use password authentication when connecting.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `false`.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.authenticate=$JMXAUTH`.
|
|
||||||
|
|
||||||
`JMXSSL`::
|
|
||||||
Whether JMX clients connect using SSL/TLS.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `false`.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.ssl=$JMXSSL`.
|
|
||||||
|
|
||||||
.Enabling JMX in a Kafka Connect Docker container
|
|
||||||
====
|
|
||||||
The following example Docker command starts a container using the `debezium/connect` image with values for the `JMXPORT` and `JMXHOST` environment variables,
|
|
||||||
and maps the Docker host's port 9012 to the container's JMX port:
|
|
||||||
|
|
||||||
[source,shell,options="nowrap"]
|
|
||||||
----
|
|
||||||
$ docker run -it --rm --name connect \
|
|
||||||
-p 8083:8083 -p 9012:9012 \
|
|
||||||
-e JMXPORT=9012 -e JMXHOST=10.0.1.10 \
|
|
||||||
-e GROUP_ID=1 \
|
|
||||||
-e CONFIG_STORAGE_TOPIC=my_connect_configs \
|
|
||||||
-e OFFSET_STORAGE_TOPIC=my_connect_offsets \
|
|
||||||
-e STATUS_STORAGE_TOPIC=my_connect_statuses \
|
|
||||||
--link zookeeper:zookeeper \
|
|
||||||
--link kafka:kafka \
|
|
||||||
--link mysql:mysql \
|
|
||||||
debezium/connect:latest
|
|
||||||
----
|
|
||||||
====
|
|
@ -1,17 +0,0 @@
|
|||||||
[id="kafka-connect-jmx-environment-variables"]
|
|
||||||
= Kafka Connect JMX environment variables
|
|
||||||
|
|
||||||
When running Kafka using a local installation,
|
|
||||||
the `connect-distributed.sh` script recognizes the following environment variables:
|
|
||||||
|
|
||||||
`JMX_PORT`::
|
|
||||||
Enables JMX and specifies the port number that will be used for JMX.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.port=$JMX_PORT`.
|
|
||||||
|
|
||||||
`KAFKA_JMX_OPTS`::
|
|
||||||
The JMX options, which are passed directly to the JVM during startup.
|
|
||||||
The default options are:
|
|
||||||
+
|
|
||||||
** `-Dcom.sun.management.jmxremote`
|
|
||||||
** `-Dcom.sun.management.jmxremote.authenticate=false`
|
|
||||||
** `-Dcom.sun.management.jmxremote.ssl=false`
|
|
@ -1,41 +0,0 @@
|
|||||||
[id="kafka-jmx-environment-variables-docker"]
|
|
||||||
= Kafka JMX environment variables in Docker
|
|
||||||
|
|
||||||
The `debezium/kafka` image recognizes the following JMX-related environment variables:
|
|
||||||
|
|
||||||
`JMXPORT` (Required)::
|
|
||||||
The port number that will be used for JMX.
|
|
||||||
The value is used to specify the following JVM parameters:
|
|
||||||
+
|
|
||||||
** `-Dcom.sun.management.jmxremote.port=$JMXPORT`
|
|
||||||
** `-Dcom.sun.management.jmxremote.rmi.port=$JMXPORT`
|
|
||||||
|
|
||||||
`JMXHOST` (Required)::
|
|
||||||
The IP address or resolvable host name of the Docker host,
|
|
||||||
which JMX uses to construct a URL sent to the JMX client.
|
|
||||||
A value of `localhost` or `127.0.0.1` will not work.
|
|
||||||
Typically, `0.0.0.0` can be used.
|
|
||||||
The value is used to specify the JVM parameter `-Djava.rmi.server.hostname=$JMXHOST`.
|
|
||||||
|
|
||||||
`JMXAUTH`::
|
|
||||||
Whether JMX clients must use password authentication when connecting.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `false`.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.authenticate=$JMXAUTH`.
|
|
||||||
|
|
||||||
`JMXSSL`::
|
|
||||||
Whether JMX clients connect using SSL/TLS.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `false`.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.ssl=$JMXSSL`.
|
|
||||||
|
|
||||||
.Enabling JMX in a Kafka Docker container
|
|
||||||
====
|
|
||||||
The following example Docker command starts a container using the `debezium/kafka` image with values for the `JMXPORT` and `HOST_NAME` environment variables,
|
|
||||||
and maps the Docker host's port 9011 to the container's JMX port:
|
|
||||||
|
|
||||||
[source,shell,options="nowrap"]
|
|
||||||
----
|
|
||||||
$ docker run -it --rm --name kafka -p 9092:9092 -p 9011:9011 -e JMXPORT=9011 -e JMXHOST=10.0.1.10 --link zookeeper:zookeeper debezium/kafka:latest
|
|
||||||
----
|
|
||||||
====
|
|
@ -1,17 +0,0 @@
|
|||||||
[id="kafka-jmx-environment-variables"]
|
|
||||||
= Kafka JMX environment variables
|
|
||||||
|
|
||||||
When running Kafka using a local installation,
|
|
||||||
the `kafka-server-start.sh` script recognizes the following environment variables:
|
|
||||||
|
|
||||||
`JMX_PORT`::
|
|
||||||
Enables JMX and specifies the port number that will be used for JMX.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.port=$JMX_PORT`.
|
|
||||||
|
|
||||||
`KAFKA_JMX_OPTS`::
|
|
||||||
The JMX options, which are passed directly to the JVM during startup.
|
|
||||||
The default options are:
|
|
||||||
+
|
|
||||||
** `-Dcom.sun.management.jmxremote`
|
|
||||||
** `-Dcom.sun.management.jmxremote.authenticate=false`
|
|
||||||
** `-Dcom.sun.management.jmxremote.ssl=false`
|
|
@ -1,47 +0,0 @@
|
|||||||
[id="zookeeper-jmx-environment-variables-docker"]
|
|
||||||
= Zookeeper JMX environment variables in Docker
|
|
||||||
|
|
||||||
The `debezium/zookeeper` image recognizes the following JMX-related environment variables:
|
|
||||||
|
|
||||||
`JMXPORT` (Required)::
|
|
||||||
The port number that will be used for JMX.
|
|
||||||
The value is used to specify the following JVM parameters:
|
|
||||||
+
|
|
||||||
** `-Dcom.sun.management.jmxremote.port=$JMXPORT`
|
|
||||||
** `-Dcom.sun.management.jmxremote.rmi.port=$JMXPORT`
|
|
||||||
|
|
||||||
`JMXHOST` (Required)::
|
|
||||||
The IP address or resolvable host name of the Docker host,
|
|
||||||
which JMX uses to construct a URL sent to the JMX client.
|
|
||||||
A value of `localhost` or `127.0.0.1` will not work.
|
|
||||||
Typically, `0.0.0.0` can be used.
|
|
||||||
The value is used to specify the JVM parameter `-Djava.rmi.server.hostname=$JMXHOST`.
|
|
||||||
|
|
||||||
`JMXAUTH`::
|
|
||||||
Whether JMX clients must use password authentication when connecting.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `false`.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.authenticate=$JMXAUTH`.
|
|
||||||
|
|
||||||
`JMXSSL`::
|
|
||||||
Whether JMX clients connect using SSL/TLS.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `false`.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.ssl=$JMXSSL`.
|
|
||||||
|
|
||||||
`JMXLOG4J`::
|
|
||||||
Whether the Log4J JMX MBeans should be disabled.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `true`.
|
|
||||||
The value is used to specify the JVM parameter `-Dzookeeper.jmx.log4j.disable=$JMXLOG4J`.
|
|
||||||
|
|
||||||
.Enabling JMX in a Zookeeper Docker container
|
|
||||||
====
|
|
||||||
The following example Docker command starts a container using the `debezium/zookeeper` image with values for the `JMXPORT` and `JMXHOST` environment variables,
|
|
||||||
and maps the Docker host's port 9010 to the container's JMX port:
|
|
||||||
|
|
||||||
[source,shell,options="nowrap"]
|
|
||||||
----
|
|
||||||
$ docker run -it --rm --name zookeeper -p 2181:2181 -p 2888:2888 -p 3888:3888 -p 9010:9010 -e JMXPORT=9010 -e JMXHOST=10.0.1.10 debezium/zookeeper:latest
|
|
||||||
----
|
|
||||||
====
|
|
@ -1,28 +0,0 @@
|
|||||||
[id="zookeeper-jmx-environment-variables"]
|
|
||||||
= Zookeeper JMX environment variables
|
|
||||||
|
|
||||||
Zookeeper has built-in support for JMX.
|
|
||||||
When running Zookeeper using a local installation,
|
|
||||||
the `zkServer.sh` script recognizes the following environment variables:
|
|
||||||
|
|
||||||
`JMXPORT`::
|
|
||||||
Enables JMX and specifies the port number that will be used for JMX.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.port=$JMXPORT`.
|
|
||||||
|
|
||||||
`JMXAUTH`::
|
|
||||||
Whether JMX clients must use password authentication when connecting.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `false`.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.authenticate=$JMXAUTH`.
|
|
||||||
|
|
||||||
`JMXSSL`::
|
|
||||||
Whether JMX clients connect using SSL/TLS.
|
|
||||||
Must be either `true` or `false`.
|
|
||||||
The default is `false`.
|
|
||||||
The value is used to specify the JVM parameter `-Dcom.sun.management.jmxremote.ssl=$JMXSSL`.
|
|
||||||
|
|
||||||
`JMXLOG4J`::
|
|
||||||
Whether the Log4J JMX MBeans should be disabled.
|
|
||||||
Must be either `true` (default) or `false`.
|
|
||||||
The default is `true`.
|
|
||||||
The value is used to specify the JVM parameter `-Dzookeeper.jmx.log4j.disable=$JMXLOG4J`.
|
|
Loading…
Reference in New Issue
Block a user