new MOLT Replicator metrics page

src/current/_includes/molt/fetch-metrics.md

@@ -17,7 +17,7 @@ Cockroach Labs recommends monitoring the following metrics during data load:
 You can also use the [sample Grafana dashboard](https://molt.cockroachdb.com/molt/cli/grafana_dashboard.json) to view the preceding metrics.
 
 {% if page.name != "migrate-bulk-load.md" %}
-{{site.data.alerts.callout_info}}
-Metrics from the `replicator` process are enabled by setting the `--metricsAddr` [replication flag](#replication-flags), and are served at `http://{host}:{port}/_/varz`. <section class="filter-content" markdown="1" data-scope="oracle">To view Oracle-specific metrics from `replicator`, import [this Grafana dashboard](https://replicator.cockroachdb.com/replicator_oracle_grafana_dashboard.json).</section>
+{{site.data.alerts.callout_success}}
+For details on Replicator metrics, refer to [Replicator Metrics]({% link molt/replicator-metrics.md %}).
 {{site.data.alerts.end}}
 {% endif %}

src/current/_includes/molt/fetch-schema-table-filtering.md

@@ -65,7 +65,7 @@ api.configureSource("molt.migration_schema", {
 });
 ~~~
 
-Pass the userscript to MOLT Replicator with the `--userscript` [flag](#replication-flags):
+Pass the userscript to MOLT Replicator with the `--userscript` [flag](#replicator-flags):
 
 ~~~
 --userscript table_filter.ts
@@ -109,7 +109,7 @@ api.configureSource("molt.public", {
 });
 ~~~
 
-Pass the userscript to MOLT Replicator with the `--userscript` [flag](#replication-flags):
+Pass the userscript to MOLT Replicator with the `--userscript` [flag](#replicator-flags):
 
 ~~~
 --userscript table_filter.ts

src/current/_includes/v23.1/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v23.2/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v24.1/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v24.2/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v24.3/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v25.1/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v25.2/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v25.3/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v25.4/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/_includes/v26.1/sidebar-data/migrate.json

@@ -72,6 +72,12 @@
               "urls": [
                 "/molt/replicator-flags.html"
               ]
+            },
+            {
+              "title": "Metrics",
+              "urls": [
+                "/molt/replicator-metrics.html"
+              ]
             }
           ]
         },

src/current/molt/migrate-failback.md

@@ -95,7 +95,7 @@ When you run `replicator`, you can configure the following options for replicati
 
 - [Connection strings](#connection-strings): Specify URL‑encoded source and target connections.
 - [TLS certificate and key](#tls-certificate-and-key): Configure secure TLS connections.
-- [Replication flags](#replication-flags): Specify required and optional flags to configure replicator behavior.
+- [Replicator flags](#replicator-flags): Specify required and optional flags to configure replicator behavior.
 <section class="filter-content" markdown="1" data-scope="postgres oracle">
 - [Tuning parameters](#tuning-parameters): Optimize failback performance and resource usage.
 </section>
@@ -177,7 +177,7 @@ WITH ...;
 
 For additional details on the webhook sink URI, refer to [Webhook sink]({% link {{ site.current_cloud_version }}/changefeed-sinks.md %}#webhook-sink).
 
-### Replication flags
+### Replicator flags
 
 {% include molt/replicator-flags-usage.md %}
 
@@ -187,7 +187,15 @@ For additional details on the webhook sink URI, refer to [Webhook sink]({% link
 {% include molt/optimize-replicator-performance.md %}
 </section>
 
-{% include molt/replicator-metrics.md %}
+### Replicator metrics
+
+MOLT Replicator metrics are not enabled by default. Enable Replicator metrics by specifying the [`--metricsAddr`]({% link molt/replicator-flags.md %}#metrics-addr) flag with a port (or `host:port`) when you start Replicator. This exposes Replicator metrics at `http://{host}:{port}/_/varz`. For example, the following flag exposes metrics on port `30005`:
+
+~~~ 
+--metricsAddr :30005
+~~~
+
+For guidelines on using and interpreting replication metrics, refer to [Replicator Metrics]({% link molt/replicator-metrics.md %}?filters=cockroachdb).
 
 ## Stop forward replication
 

src/current/molt/migrate-load-replicate.md

@@ -75,7 +75,7 @@ Use [MOLT Verify]({% link molt/molt-verify.md %}) to confirm that the source and
 When you run `replicator`, you can configure the following options for replication:
 
 - [Replication connection strings](#replication-connection-strings): Specify URL-encoded source and target database connections.
-- [Replication flags](#replication-flags): Specify required and optional flags to configure replicator behavior.
+- [Replicator flags](#replicator-flags): Specify required and optional flags to configure replicator behavior.
 <section class="filter-content" markdown="1" data-scope="postgres oracle">
 - [Tuning parameters](#tuning-parameters): Optimize replication performance and resource usage.
 </section>
@@ -127,7 +127,7 @@ For Oracle Multitenant databases, also specify `--sourcePDBConn` with the PDB co
 Follow best practices for securing connection strings. Refer to [Secure connections](#secure-connections).
 {{site.data.alerts.end}}
 
-### Replication flags
+### Replicator flags
 
 {% include molt/replicator-flags-usage.md %}
 
@@ -137,7 +137,25 @@ Follow best practices for securing connection strings. Refer to [Secure connecti
 {% include molt/optimize-replicator-performance.md %}
 </section>
 
-{% include molt/replicator-metrics.md %}
+### Replicator metrics
+
+MOLT Replicator metrics are not enabled by default. Enable Replicator metrics by specifying the [`--metricsAddr`]({% link molt/replicator-flags.md %}#metrics-addr) flag with a port (or `host:port`) when you start Replicator. This exposes Replicator metrics at `http://{host}:{port}/_/varz`. For example, the following flag exposes metrics on port `30005`:
+
+~~~ 
+--metricsAddr :30005
+~~~
+
+<section class="filter-content" markdown="1" data-scope="postgres">
+For guidelines on using and interpreting replication metrics, refer to [Replicator Metrics]({% link molt/replicator-metrics.md %}?filters=postgres).
+</section>
+
+<section class="filter-content" markdown="1" data-scope="mysql">
+For guidelines on using and interpreting replication metrics, refer to [Replicator Metrics]({% link molt/replicator-metrics.md %}?filters=mysql).
+</section>
+
+<section class="filter-content" markdown="1" data-scope="oracle">
+For guidelines on using and interpreting replication metrics, refer to [Replicator Metrics]({% link molt/replicator-metrics.md %}?filters=oracle).
+</section>
 
 ## Start Replicator