Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

jvm-observ-lib: Add java_micrometer_with_suffixes option #1351

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions jvm-observ-lib/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ Supports the following sources:
- `prometheus` (https://prometheus.github.io/client_java/instrumentation/jvm/#jvm-memory-metrics). This also works for jmx_exporter (javaagent mode) starting from 1.0.1 release.
- `otel` (https://github.com/open-telemetry/opentelemetry-java-contrib/blob/main/jmx-metrics/docs/target-systems/jvm.md)
- `otel_with_suffixes` same as otel with add_metric_suffixes=true in otelcollector
- `java_micrometer` (springboot) (https://github.com/micrometer-metrics/micrometer/blob/main/micrometer-core/src/main/java/io/micrometer/core/instrument/binder/jvm/JvmMemoryMetrics.java)
- `java_micrometer` (springboot) (https://github.com/micrometer-metrics/micrometer/blob/main/micrometer-core/src/main/java/io/micrometer/core/instrument/binder/jvm/JvmMemoryMetrics.java). Can be seen when Micrometer to OTEL bridge is used.
- `java_micrometer_with_suffixes` (springboot) same, but with prometheus suffixes
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From a readability perspective, could you rename this to java_micrometer_bridge_prom and java_micrometer_bridge_otel or similar? I think it'd be a fair bit cleaner

- `prometheus_old` client_java instrumentation prior to 1.0.0 release: (https://github.com/prometheus/client_java/releases/tag/v1.0.0-alpha-4). This also works for jmx_exporter (javaagent mode) prior to 1.0.1 release.
- `jmx_exporter`. Works with jmx_exporter (both http and javaagent modes) and the folllowing snippet:

Expand Down Expand Up @@ -45,7 +46,7 @@ local jvm =
uid: 'jvm-sample',
dashboardNamePrefix: 'JVM',
dashboardTags: ['java', 'jvm'],
metricsSource: 'java_micrometer', // or java_otel, prometheus,
metricsSource: 'java_micrometer_with_suffixes', // or java_otel, prometheus,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See above comment, where at first read it can be confusing what exactly the source is here. Additionally would be good to mention the otel bridge option

}
);
jvm.asMonitoringMixin()
Expand Down
3 changes: 2 additions & 1 deletion jvm-observ-lib/main.libsonnet
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ local processlib = import 'process-observ-lib/main.libsonnet';
filteringSelector: this.config.filteringSelector,
groupLabels: this.config.groupLabels,
instanceLabels: this.config.instanceLabels,
uid: this.config.uid,
uid: this.config.uid - '-jvm',
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wouldn't this be a breaking change for any customer bookmarks etc?

dashboardNamePrefix: this.config.dashboardNamePrefix,
dashboardTags: this.config.dashboardTags,
metricsSource:
Expand All @@ -25,6 +25,7 @@ local processlib = import 'process-observ-lib/main.libsonnet';
+ (if std.member(this.config.metricsSource, 'prometheus') then ['prometheus'] else [])
+ (if std.member(this.config.metricsSource, 'jmx_exporter') then ['jmx_exporter'] else [])
+ (if std.member(this.config.metricsSource, 'prometheus_old') then ['prometheus'] else [])
+ (if std.member(this.config.metricsSource, 'java_micrometer_with_suffixes') then ['java_micrometer_with_suffixes'] else [])
+ (if std.member(this.config.metricsSource, 'java_micrometer') then ['java_micrometer'] else []),
}
),
Expand Down
17 changes: 15 additions & 2 deletions jvm-observ-lib/signals/buffers.libsonnet
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,11 @@ function(this)
aggLevel: 'group',
aggFunction: 'avg',
discoveryMetric: {
java_micrometer: 'jvm_buffer_memory_used_bytes', // https://github.com/micrometer-metrics/micrometer/blob/main/micrometer-core/src/main/java/io/micrometer/core/instrument/binder/jvm/JvmMemoryMetrics.java
prometheus: 'jvm_buffer_pool_used_bytes', // https://prometheus.github.io/client_java/instrumentation/jvm/#jvm-buffer-pool-metrics
java_micrometer: 'jvm_buffer_memory_used', // can be seen when otel micrometer bridge is used
java_micrometer_with_suffixes: 'jvm_buffer_memory_used_bytes', // https://github.com/micrometer-metrics/micrometer/blob/main/micrometer-core/src/main/java/io/micrometer/core/instrument/binder/jvm/JvmMemoryMetrics.java
otel: 'process_runtime_jvm_buffer_usage',
otel_with_suffixes: 'process_runtime_jvm_buffer_usage_bytes',
prometheus: 'jvm_buffer_pool_used_bytes', // https://prometheus.github.io/client_java/instrumentation/jvm/#jvm-buffer-pool-metrics
prometheus_old: 'jvm_buffer_pool_used_bytes',
},
signals: {
Expand All @@ -23,6 +24,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_buffer_memory_used{%(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_buffer_memory_used_bytes{%(queriesSelector)s}',
},
prometheus: {
Expand All @@ -47,6 +51,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_buffer_total_capacity{%(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_buffer_total_capacity_bytes{%(queriesSelector)s}',
},
prometheus: {
Expand All @@ -71,6 +78,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_buffer_memory_used{%(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_buffer_memory_used_bytes{%(queriesSelector)s}',
},
prometheus: {
Expand All @@ -95,6 +105,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_buffer_total_capacity{%(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_buffer_total_capacity_bytes{%(queriesSelector)s}',
},
prometheus: {
Expand Down
10 changes: 7 additions & 3 deletions jvm-observ-lib/signals/classes.libsonnet
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,9 @@ function(this)
aggLevel: 'group',
aggFunction: 'avg',
discoveryMetric: {
java_micrometer: 'jvm_classes_loaded_classes', // https://github.com/micrometer-metrics/micrometer/blob/main/micrometer-core/src/main/java/io/micrometer/core/instrument/binder/jvm/ClassLoaderMetrics.java
prometheus: 'jvm_classes_loaded', // https://prometheus.github.io/client_java/instrumentation/jvm/#jvm-class-loading-metrics
java_micrometer: 'jvm_classes_loaded', // https://github.com/micrometer-metrics/micrometer/blob/main/micrometer-core/src/main/java/io/micrometer/core/instrument/binder/jvm/ClassLoaderMetrics.java
java_micrometer_with_suffixes: 'jvm_classes_loaded_classes',
prometheus: 'jvm_classes_loaded_total', // https://prometheus.github.io/client_java/instrumentation/jvm/#jvm-class-loading-metrics
otel: 'process_runtime_jvm_classes_loaded',
otel_with_suffixes: 'process_runtime_jvm_classes_loaded_total',
prometheus_old: 'jvm_classes_loaded',
Expand All @@ -23,10 +24,13 @@ function(this)
unit: 'short',
sources: {
java_micrometer: {
expr: 'jvm_classes_loaded{%(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_classes_loaded_classes{%(queriesSelector)s}',
},
prometheus: {
expr: 'jvm_classes_loaded{%(queriesSelector)s}',
expr: 'jvm_classes_loaded_total{%(queriesSelector)s}',
},
otel: {
expr: 'process_runtime_jvm_classes_loaded{%(queriesSelector)s}',
Expand Down
70 changes: 69 additions & 1 deletion jvm-observ-lib/signals/gc.libsonnet
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@ function(this)
aggLevel: 'group',
aggFunction: 'avg',
discoveryMetric: {
java_micrometer: 'jvm_memory_used_bytes',
java_micrometer: 'jvm_memory_used',
java_micrometer_with_suffixes: 'jvm_memory_used_bytes',
prometheus: 'jvm_memory_used_bytes', // https://prometheus.github.io/client_java/instrumentation/jvm/#jvm-memory-metrics
prometheus_old: 'jvm_memory_bytes_used',
otel: 'process_runtime_jvm_memory_usage', //https://opentelemetry.io/docs/specs/semconv/runtime/jvm-metrics/
Expand All @@ -28,6 +29,14 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_gc_pause_count{%(queriesSelector)s}',
aggKeepLabels: ['action', 'cause'],
legendCustomTemplate: '%(aggLegend)s',
exprWrappers: [
actionLabelPrettify,
],
},
java_micrometer_with_suffixes: {
expr: 'jvm_gc_pause_seconds_count{%(queriesSelector)s}',
aggKeepLabels: ['action', 'cause'],
legendCustomTemplate: '%(aggLegend)s',
Expand Down Expand Up @@ -63,6 +72,13 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'avg by (action,cause, %(agg)s) (rate(jvm_gc_pause_max{%(queriesSelector)s}[$__rate_interval]))',
legendCustomTemplate: '{{ %(agg)s }}: {{ action }} ({{ cause }}) (max)',
exprWrappers: [
actionLabelPrettify,
],
},
java_micrometer_with_suffixes: {
expr: 'avg by (action,cause, %(agg)s) (rate(jvm_gc_pause_seconds_max{%(queriesSelector)s}[$__rate_interval]))',
legendCustomTemplate: '{{ %(agg)s }}: {{ action }} ({{ cause }}) (max)',
exprWrappers: [
Expand All @@ -79,6 +95,19 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: |||
avg by (%(agg)s, action, cause) (
rate(jvm_gc_pause_sum{%(queriesSelector)s}[$__rate_interval])
/
rate(jvm_gc_pause_count{%(queriesSelector)s}[$__rate_interval])
)
|||,
legendCustomTemplate: '{{ %(agg)s }}: {{ action }} ({{ cause }}) (avg)',
exprWrappers: [
actionLabelPrettify,
],
},
java_micrometer_with_suffixes: {
expr: |||
avg by (%(agg)s, action, cause) (
rate(jvm_gc_pause_seconds_sum{%(queriesSelector)s}[$__rate_interval])
Expand Down Expand Up @@ -138,6 +167,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_gc_memory_promoted{%(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_gc_memory_promoted_bytes_total{%(queriesSelector)s}',
},
},
Expand All @@ -151,6 +183,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_gc_memory_allocated{%(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_gc_memory_allocated_bytes_total{%(queriesSelector)s}',
},
prometheus: {
Expand Down Expand Up @@ -192,6 +227,9 @@ function(this)
java_micrometer: {
expr: 'jvm_memory_used_bytes{id=~"(G1 |PS )?Eden Space", area="heap", %(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_used{id=~"(G1 |PS )?Eden Space", area="heap", %(queriesSelector)s}',
},
prometheus: {
expr: 'jvm_memory_pool_used_bytes{pool=~"(G1 |PS )?Eden Space", %(queriesSelector)s}',
},
Expand Down Expand Up @@ -223,6 +261,12 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_memory_max{id=~"(G1 )?Eden Space", area="heap", %(queriesSelector)s}',
exprWrappers: [
['', ' != -1'],
],
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_max_bytes{id=~"(G1 )?Eden Space", area="heap", %(queriesSelector)s}',
exprWrappers: [
['', ' != -1'],
Expand Down Expand Up @@ -255,6 +299,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_memory_committed{id=~"(G1 |PS )?Eden Space", area="heap", %(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_committed_bytes{id=~"(G1 |PS )?Eden Space", area="heap", %(queriesSelector)s}',
},
prometheus: {
Expand Down Expand Up @@ -283,6 +330,9 @@ function(this)
sources: {
//spring
java_micrometer: {
expr: 'jvm_memory_used{id=~"(G1 |PS )?Survivor Space", area="heap", %(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_used_bytes{id=~"(G1 |PS )?Survivor Space", area="heap", %(queriesSelector)s}',
},
prometheus: {
Expand Down Expand Up @@ -316,6 +366,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_memory_max{id=~"(G1 |PS )?Survivor Space", area="heap", %(queriesSelector)s} != -1',
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_max_bytes{id=~"(G1 |PS )?Survivor Space", area="heap", %(queriesSelector)s} != -1',
},
prometheus: {
Expand All @@ -342,6 +395,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_memory_committed{id=~"(G1 |PS )?Survivor Space", area="heap", %(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_committed_bytes{id=~"(G1 |PS )?Survivor Space", area="heap", %(queriesSelector)s}',
},
prometheus: {
Expand Down Expand Up @@ -369,6 +425,9 @@ function(this)
sources: {
//spring
java_micrometer: {
expr: 'jvm_memory_used{id="Tenured Gen", area="heap", %(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_used_bytes{id="Tenured Gen", area="heap", %(queriesSelector)s}',
},
prometheus: {
Expand Down Expand Up @@ -402,6 +461,12 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_memory_max{id="Tenured Gen", area="heap", %(queriesSelector)s}',
exprWrappers: [
['', ' != -1'],
],
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_max_bytes{id="Tenured Gen", area="heap", %(queriesSelector)s}',
exprWrappers: [
['', ' != -1'],
Expand Down Expand Up @@ -440,6 +505,9 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: 'jvm_memory_committed{id="Tenured Gen", area="heap", %(queriesSelector)s}',
},
java_micrometer_with_suffixes: {
expr: 'jvm_memory_committed_bytes{id="Tenured Gen", area="heap", %(queriesSelector)s}',
},
prometheus: {
Expand Down
30 changes: 30 additions & 0 deletions jvm-observ-lib/signals/hikari.libsonnet
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ function(this)
expr: 'hikaricp_connections{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
},
java_micrometer_with_suffixes: self.java_micrometer,
otel: {
expr: 'hikaricp_connections{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
Expand All @@ -42,6 +43,10 @@ function(this)
expr: 'hikaricp_connections_timeout_total{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
},
java_micrometer_with_suffixes: {
expr: 'hikaricp_connections_timeout{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
},
},
},
connectionsActive: {
Expand All @@ -55,6 +60,7 @@ function(this)
expr: 'hikaricp_connections_active{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
},
java_micrometer_with_suffixes: self.java_micrometer,
otel: {
expr: 'hikaricp_connections_active{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
Expand All @@ -73,6 +79,7 @@ function(this)
expr: 'hikaricp_connections_idle{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
},
java_micrometer_with_suffixes: self.java_micrometer,
otel: {
expr: 'hikaricp_connections_idle{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
Expand All @@ -91,6 +98,7 @@ function(this)
expr: 'hikaricp_connections_pending{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
},
java_micrometer_with_suffixes: self.java_micrometer,
otel: {
expr: 'hikaricp_connections_pending{%(queriesSelector)s}',
aggKeepLabels: ['pool'],
Expand All @@ -107,12 +115,20 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: |||
rate(hikaricp_connections_creation_sum{%(queriesSelector)s}[$__rate_interval])
/rate(hikaricp_connections_creation_count{%(queriesSelector)s}[$__rate_interval])
|||,
aggKeepLabels: ['pool'],
},
java_micrometer_with_suffixes: {
expr: |||
rate(hikaricp_connections_creation_seconds_sum{%(queriesSelector)s}[$__rate_interval])
/rate(hikaricp_connections_creation_seconds_count{%(queriesSelector)s}[$__rate_interval])
|||,
aggKeepLabels: ['pool'],
},

},
},
connectionsUsageDurationAvg: {
Expand All @@ -123,6 +139,13 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: |||
rate(hikaricp_connections_usage_sum{%(queriesSelector)s}[$__rate_interval])
/rate(hikaricp_connections_usage_count{%(queriesSelector)s}[$__rate_interval])
|||,
aggKeepLabels: ['pool'],
},
java_micrometer_with_suffixes: {
expr: |||
rate(hikaricp_connections_usage_seconds_sum{%(queriesSelector)s}[$__rate_interval])
/rate(hikaricp_connections_usage_seconds_count{%(queriesSelector)s}[$__rate_interval])
Expand All @@ -139,6 +162,13 @@ function(this)
optional: true,
sources: {
java_micrometer: {
expr: |||
rate(hikaricp_connections_acquire_sum{%(queriesSelector)s}[$__rate_interval])
/rate(hikaricp_connections_acquire_count{%(queriesSelector)s}[$__rate_interval])
|||,
aggKeepLabels: ['pool'],
},
java_micrometer_with_suffixes: {
expr: |||
rate(hikaricp_connections_acquire_seconds_sum{%(queriesSelector)s}[$__rate_interval])
/rate(hikaricp_connections_acquire_seconds_count{%(queriesSelector)s}[$__rate_interval])
Expand Down
Loading
Loading