Update to markdownlint-cli2 (#2475)

Author: trask

.github/config/.markdownlint-cli2.yaml

@@ -0,0 +1,21 @@
+# See https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+# and https://github.com/DavidAnson/markdownlint-cli2
+
+config:
+  ul-style: false
+  line-length: false
+  no-duplicate-heading:
+    siblings_only: true
+  ol-prefix:
+    style: ordered
+  no-inline-html: false
+  fenced-code-language: false
+  no-trailing-punctuation:
+    punctuation: ".,;:" # allowing exclamation points and question marks at end of sentences
+
+ignores:
+  - "**/build/**"
+  - "**/node_modules/**"
+  - "CHANGELOG.md"
+  - "ibm-mq-metrics/docs/metrics.md"
+  - ".github/pull_request_template.md"

.github/config/markdownlint.yml

@@ -63,4 +63,4 @@ When implementing changes or new features:
 1. Follow all [Style Guide](../docs/style-guide.md) conventions and the Code Review Priorities above
 2. Run tests to ensure they still pass (use `./gradlew test` and `./gradlew integrationTest` as needed)
 3. **Always run `./gradlew spotlessApply`** after making code changes to ensure proper formatting
-4. Run markdown lint to ensure it still passes: `npx markdownlint-cli@0.46.0 -c .github/config/markdownlint.yml **/*.md`
+4. Run markdown lint to ensure it still passes: `npx markdownlint-cli2@0.17.1 --config .github/config/.markdownlint-cli2.yaml "**/*.md"`

.github/copilot-instructions.md

@@ -23,7 +23,7 @@ private admin repo.
 - `GPG_PASSWORD` - stored in OpenTelemetry-Java 1Password
 - `GPG_PRIVATE_KEY` - stored in OpenTelemetry-Java 1Password
 - `NVD_API_KEY` - stored in OpenTelemetry-Java 1Password
-  - Generated at https://nvd.nist.gov/developers/request-an-api-key
+  - Generated at <https://nvd.nist.gov/developers/request-an-api-key>
   - Key is associated with [@trask](https://github.com/trask)'s gmail address
 - `SONATYPE_KEY` - owned by [@trask](https://github.com/trask)
 - `SONATYPE_USER` - owned by [@trask](https://github.com/trask)

.github/repository-settings.md

@@ -14,4 +14,4 @@ jobs:
 
       - name: Run markdownlint
         run: |
-          npx markdownlint-cli@0.46.0 -c .github/config/markdownlint.yml **/*.md
+          npx markdownlint-cli2@0.17.1 --config .github/config/.markdownlint-cli2.yaml "**/*.md"

.github/workflows/reusable-markdown-lint.yml

@@ -1,76 +1,88 @@
 # ActiveMQ Metrics
 
 The JMX Metric Gatherer provides built in ActiveMQ metric gathering capabilities.
-These metrics are sourced from: https://activemq.apache.org/jmx
+These metrics are sourced from: <https://activemq.apache.org/jmx>
 
-### Metrics
+## Metrics
+
+### activemq.consumer.count
 
 * Name: `activemq.consumer.count`
 * Description: The number of consumers currently reading from the broker.
 * Unit: `consumers`
 * Labels: `destination`
 * Instrument Type: ObservableLongUpDownCounter
 
+### activemq.producer.count
 
 * Name: `activemq.producer.count`
 * Description: The number of producers currently attached to the broker.
 * Unit: `producers`
 * Labels: `destination`
 * Instrument Type: ObservableLongUpDownCounter
 
+### activemq.connectin.count
 
 * Name: `activemq.connectin.count`
 * Description: The total number of current connections.
 * Unit: `connections`
 * Instrument Type: ObservableLongUpDownCounter
 
+### activemq.memory.usage
 
 * Name: `activemq.memory.usage`
 * Description: The percentage of configured memory used.
 * Unit: `%`
 * Labels: `destination`
 * Instrument Type: ObservableDoubleValue
 
+### activemq.disk.store_usage
 
 * Name: `activemq.disk.store_usage`
 * Description: The percentage of configured disk used for persistent messages.
 * Unit: `%`
 * Instrument Type: ObservableDoubleValue
 
+### activemq.disk.temp_usage
 
 * Name: `activemq.disk.temp_usage`
 * Description: The percentage of configured disk used for non-persistent messages.
 * Unit: `%`
 * Instrument Type: ObservableDoubleValue
 
+### activemq.message.current
 
 * Name: `activemq.message.current`
 * Description: The current number of messages waiting to be consumed.
 * Unit: `messages`
 * Labels: `destination`
 * Instrument Type: ObservableLongUpDownCounter
 
+### activemq.message.expired
 
 * Name: `activemq.message.expired`
 * Description: The total number of messages not delivered because they expired.
 * Unit: `messages`
 * Labels: `destination`
 * Instrument Type: ObservableLongCounter
 
+### activemq.message.enqueued
 
 * Name: `activemq.message.enqueued`
 * Description: The total number of messages received by the broker.
 * Unit: `messages`
 * Labels: `destination`
 * Instrument Type: ObservableLongCounter
 
+### activemq.message.dequeued
 
 * Name: `activemq.message.dequeued`
 * Description: The total number of messages delivered to consumers.
 * Unit: `messages`
 * Labels: `destination`
 * Instrument Type: ObservableLongCounter
 
+### activemq.message.wait_time.avg
 
 * Name: `activemq.message.wait_time.avg`
 * Description: The average time a message was held on a destination.

jmx-metrics/docs/target-systems/activemq.md

@@ -1,93 +1,123 @@
 # Casandra Metrics
 
 The JMX Metric Gatherer provides built in Cassandra metric gathering capabilities.
-These metrics are sourced from Cassandra's exposed Dropwizard Metrics for each node: https://cassandra.apache.org/doc/latest/cassandra/managing/operating/metrics.html.
+These metrics are sourced from Cassandra's exposed Dropwizard Metrics for each node: <https://cassandra.apache.org/doc/latest/cassandra/managing/operating/metrics.html>.
 
-## Metrics
+## Client Request Metrics
 
-### Client Request Metrics
+### cassandra.client.request.range_slice.latency.50p
 
 * Name: `cassandra.client.request.range_slice.latency.50p`
 * Description: Token range read request latency - 50th percentile
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.range_slice.latency.99p
+
 * Name: `cassandra.client.request.range_slice.latency.99p`
 * Description: Token range read request latency - 99th percentile
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.range_slice.latency.max
+
 * Name: `cassandra.client.request.range_slice.latency.max`
 * Description: Maximum token range read request latency
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.read.latency.50p
+
 * Name: `cassandra.client.request.read.latency.50p`
 * Description: Standard read request latency - 50th percentile
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.read.latency.99p
+
 * Name: `cassandra.client.request.read.latency.99p`
 * Description: Standard read request latency - 99th percentile
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.read.latency.max
+
 * Name: `cassandra.client.request.read.latency.max`
 * Description: Maximum standard read request latency
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.write.latency.50p
+
 * Name: `cassandra.client.request.write.latency.50p`
 * Description: Regular write request latency - 50th percentile
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.write.latency.99p
+
 * Name: `cassandra.client.request.write.latency.99p`
 * Description: Regular write request latency - 99th percentile
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.write.latency.max
+
 * Name: `cassandra.client.request.write.latency.max`
 * Description: Maximum regular write request latency
 * Unit: `µs`
 * Instrument Type: DoubleValueObserver
 
+### cassandra.client.request.count
+
 * Name: `cassandra.client.request.count`
 * Description: Number of requests by operation
 * Labels: `operation`
 * Unit: `1`
 * Instrument Type: LongSumObserver
 
+### cassandra.client.request.error.count
+
 * Name: `cassandra.client.request.error.count`
 * Description: Number of request errors by operation
 * Labels: `operation`, `status`
 * Unit: `1`
 * Instrument Type: LongSumObserver
 
-### Compaction Metrics
+## Compaction Metrics
+
+### cassandra.compaction.tasks.completed
 
 * Name: `cassandra.compaction.tasks.completed`
 * Description: Number of completed compactions since server [re]start
 * Unit: `1`
 * Instrument Type: LongSumObserver
 
+### cassandra.compaction.tasks.pending
+
 * Name: `cassandra.compaction.tasks.pending`
 * Description: Estimated number of compactions remaining to perform
 * Unit: `1`
 * Instrument Type: LongValueObserver
 
-### Storage Metrics
+## Storage Metrics
+
+### cassandra.storage.load.count
 
 * Name: `cassandra.storage.load.count`
 * Description: Size of the on disk data size this node manages
 * Unit: `by`
 * Instrument Type: LongValueObserver
 
+### cassandra.storage.total_hints.count
+
 * Name: `cassandra.storage.total_hints.count`
 * Description: Number of hint messages written to this node since [re]start
 * Unit: `1`
 * Instrument Type: LongSumObserver
 
+### cassandra.storage.total_hints.in_progress.count
+
 * Name: `cassandra.storage.total_hints.in_progress.count`
 * Description: Number of hints attempting to be sent currently
 * Unit: `1`

jmx-metrics/docs/target-systems/cassandra.md

@@ -1,57 +1,76 @@
 # Hadoop Metrics
 
 The JMX Metric Gatherer provides built in Hadoop metric gathering capabilities.
-These metrics are sourced from: https://hadoop.apache.org/docs/r2.7.2/hadoop-project-dist/hadoop-common/Metrics.html
+These metrics are sourced from: <https://hadoop.apache.org/docs/r2.7.2/hadoop-project-dist/hadoop-common/Metrics.html>
+
+## Name Node Metrics
+
+### hadoop.name_node.capacity.usage
 
-### Name Node Metrics
 * Name: `hadoop.name_node.capacity.usage`
 * Description: The current used capacity across all data nodes reporting to the name node.
 * Unit: `by`
 * Labels: `node_name`
 * Instrument Type: LongUpDownCounterCallback
 
+### hadoop.name_node.capacity.limit
+
 * Name: `hadoop.name_node.capacity.limit`
 * Description: The total capacity allotted to data nodes reporting to the name node.
 * Unit: `by`
 * Labels: `node_name`
 * Instrument Type: LongUpDownCounterCallback
 
+### hadoop.name_node.block.count
+
 * Name: `hadoop.name_node.block.count`
 * Description: The total number of blocks on the name node.
 * Unit: `{blocks}`
 * Labels: `node_name`
 * Instrument Type: LongUpDownCounterCallback
 
+### hadoop.name_node.block.missing
+
 * Name: `hadoop.name_node.block.missing`
 * Description: The number of blocks reported as missing to the name node.
 * Unit: `{blocks}`
 * Labels: `node_name`
 * Instrument Type: LongUpDownCounterCallback
 
+### hadoop.name_node.block.corrupt
+
 * Name: `hadoop.name_node.block.corrupt`
 * Description: The number of blocks reported as corrupt to the name node.
 * Unit: `{blocks}`
 * Labels: `node_name`
 * Instrument Type: LongUpDownCounterCallback
 
+### hadoop.name_node.volume.failed
+
 * Name: `hadoop.name_node.volume.failed`
 * Description: The number of failed volumes reported to the name node.
 * Unit: `{volumes}`
 * Labels: `node_name`
 * Instrument Type: LongUpDownCounterCallback
 
+### hadoop.name_node.file.count
+
 * Name: `hadoop.name_node.file.count`
 * Description: The total number of files being tracked by the name node.
 * Unit: `{files}`
 * Labels: `node_name`
 * Instrument Type: LongUpDownCounterCallback
 
+### hadoop.name_node.file.load
+
 * Name: `hadoop.name_node.file.load`
 * Description: The current number of concurrent file accesses.
 * Unit: `{operations}`
 * Labels: `node_name`
 * Instrument Type: LongUpDownCounterCallback
 
+### hadoop.name_node.data_node.count
+
 * Name: `hadoop.name_node.data_node.count`
 * Description: The number of data nodes reporting to the name node.
 * Unit: `{nodes}`