Skip to content

Commit eb958bd

Browse files
jack-bergjack-berg
authored
Update java docs for 1.44.0 release (#5566)
1 parent 7a5a0dd commit eb958bd

File tree

2 files changed

+47
-39
lines changed

2 files changed

+47
-39
lines changed

‎content/en/docs/languages/java/configuration.md

+18-16
Original file line numberDiff line numberDiff line change
@@ -141,13 +141,13 @@ returns a minimally configured instance (for example,
141141

142142
Properties for configuring [resource](../sdk/#resource):
143143

144-
| System property | Description | Default |
145-
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
146-
| `otel.service.name` | Specify logical service name. Takes precedence over `service.name` defined with `otel.resource.attributes`. | `unknown_service:java` |
147-
| `otel.resource.attributes` | Specify resource attributes in the following format: `key1=val1,key2=val2,key3=val3`. | |
148-
| `otel.experimental.resource.disabled-keys` | Specify resource attribute keys to filter. This option is experimental and subject to change or removal. | |
149-
| `otel.java.enabled.resource.providers` | Comma-separated list of `ResourceProvider` fully qualified class names to enable. **[1]** If unset, all resource providers are enabled. | |
150-
| `otel.java.disabled.resource.providers` | Comma-separated list of `ResourceProvider` fully qualified class names to disable. **[1]** | |
144+
| System property | Description | Default |
145+
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
146+
| `otel.service.name` | Specify logical service name. Takes precedence over `service.name` defined with `otel.resource.attributes`. | `unknown_service:java` |
147+
| `otel.resource.attributes` | Specify resource attributes in the following format: `key1=val1,key2=val2,key3=val3`. | |
148+
| `otel.resource.disabled-keys` | Specify resource attribute keys to filter. | |
149+
| `otel.java.enabled.resource.providers` | Comma-separated list of `ResourceProvider` fully qualified class names to enable. **[1]** If unset, all resource providers are enabled. | |
150+
| `otel.java.disabled.resource.providers` | Comma-separated list of `ResourceProvider` fully qualified class names to disable. **[1]** | |
151151

152152
**[1]**: For example, to disable the
153153
[OS resource provider](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/resources/library/src/main/java/io/opentelemetry/instrumentation/resources/OsResourceProvider.java),
@@ -260,12 +260,12 @@ exporters via `otel.logs.exporter`:
260260

261261
Properties for setting exporters:
262262

263-
| System property | Purpose | Default |
264-
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- |
265-
| `otel.traces.exporter` | Comma-separated list of span exporters. Known values include `otlp`, `zipkin`, `console`, `logging-otlp`, `none`. **[1]** | `otlp` |
266-
| `otel.metrics.exporter` | Comma-separated list of metric exporters. Known values include `otlp`, `prometheus`, `none`. **[1]** | `otlp` |
267-
| `otel.logs.exporter` | Comma-separated list of log record exporters. Known values include `otlp`, `console`, `logging-otlp`, `none`. **[1]** | `otlp` |
268-
| `otel.java.experimental.exporter.memory_mode` | If `reusable_data`, enable reusable memory mode (on exporters which support it) to reduce allocations. Known values include `reusable_data`, `immutable_data`. This option is experimental and subject to change or removal. **[2]** | `immutable_data` |
263+
| System property | Purpose | Default |
264+
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
265+
| `otel.traces.exporter` | Comma-separated list of span exporters. Known values include `otlp`, `zipkin`, `console`, `logging-otlp`, `none`. **[1]** | `otlp` |
266+
| `otel.metrics.exporter` | Comma-separated list of metric exporters. Known values include `otlp`, `prometheus`, `none`. **[1]** | `otlp` |
267+
| `otel.logs.exporter` | Comma-separated list of log record exporters. Known values include `otlp`, `console`, `logging-otlp`, `none`. **[1]** | `otlp` |
268+
| `otel.java.exporter.memory_mode` | If `reusable_data`, enable reusable memory mode (on exporters which support it) to reduce allocations. Known values include `reusable_data`, `immutable_data`. **[2]** | `reusable_data` |
269269

270270
**[1]**: Known exporters and artifacts (see
271271
[span exporter](../sdk/#spanexporter),
@@ -277,10 +277,12 @@ Properties for setting exporters:
277277
- `console` configures `LoggingSpanExporter`, `LoggingMetricExporter`,
278278
`SystemOutLogRecordExporter`.
279279
- `logging-otlp` configures `OtlpJsonLogging{Signal}Exporter`.
280+
- `experimental-otlp/stdout` configures `OtlpStdout{Signal}Exporter` (this
281+
option is experimental and subject to change or removal).
280282

281283
**[2]**: Exporters which adhere to
282-
`otel.java.experimental.exporter.memory_mode=reusable_data` are
283-
`OtlpGrpc{Signal}Exporter`, `OtlpHttp{Signal}Exporter`, and
284+
`otel.java.exporter.memory_mode=reusable_data` are `OtlpGrpc{Signal}Exporter`,
285+
`OtlpHttp{Signal}Exporter`, `OtlpStdout{Signal}Exporter`, and
284286
`PrometheusHttpServer`.
285287

286288
Properties for `otlp` span, metric, and log exporters:
@@ -306,7 +308,7 @@ Properties for `otlp` span, metric, and log exporters:
306308
| `otel.exporter.otlp.{signal}.timeout` | The maximum waiting time, in milliseconds, allowed to send each OTLP {signal} batch. | `10000` |
307309
| `otel.exporter.otlp.metrics.temporality.preference` | The preferred output aggregation temporality. Options include `DELTA`, `LOWMEMORY`, and `CUMULATIVE`. If `CUMULATIVE`, all instruments will have cumulative temporality. If `DELTA`, counter (sync and async) and histograms will be delta, up down counters (sync and async) will be cumulative. If `LOWMEMORY`, sync counter and histograms will be delta, async counter and up down counters (sync and async) will be cumulative. | `CUMULATIVE` |
308310
| `otel.exporter.otlp.metrics.default.histogram.aggregation` | The preferred default histogram aggregation. Options include `BASE2_EXPONENTIAL_BUCKET_HISTOGRAM` and `EXPLICIT_BUCKET_HISTOGRAM`. | `EXPLICIT_BUCKET_HISTOGRAM` |
309-
| `otel.experimental.exporter.otlp.retry.enabled` | If `true`, retry on when transient errors occur. **[2]** | `false` |
311+
| `otel.java.exporter.otlp.retry.enabled` | If `true`, retry on when transient errors occur. **[2]** | `true` |
310312

311313
**NOTE:** The text placeholder `{signal}` refers to the supported
312314
[OpenTelemetry Signal](/docs/concepts/signals/). Valid values include `traces`,

0 commit comments

Comments
 (0)