Skip to content

Commit efd83f7

Browse files
Add documentation on filter configuration
Signed-off-by: Karsten Schnitter <k.schnitter@sap.com>
1 parent 5c965d3 commit efd83f7

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

  • cf-java-logging-support-opentelemetry-agent-extension

cf-java-logging-support-opentelemetry-agent-extension/README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,21 @@ java -javaagent:/path/to/opentelemetry-javaagent-<version>.jar \
142142

143143
The [OpenTelemetry Java Instrumentation project](https://github.com/open-telemetry/opentelemetry-java-instrumentation) provides detailed documentation on the configuration properties for [Logback](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-appender-1.0/javaagent) and [Log4j](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-appender-2.17/javaagent).
144144

145+
### Filtering Metrics
146+
147+
_This feature was introduced with version 4.1.0 of the extension._
148+
149+
You can filter which metrics are exported to Cloud Logging or Dynatrace by name using the following properties:
150+
151+
| Property | Description |
152+
|--------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
153+
| `otel.exporter.cloud-logging.metrics.include.names` or `otel.exporter.dynatrace.metrics.include.names` | A comma-separated list of metric names to be forwarded. This may include a wild card "*" at the end of the name. |
154+
| `otel.exporter.cloud-logging.metrics.exclude.names` or `otel.exporter.dynatrace.metrics.exclude.names` | A comma-separated list of metric names to be rejected. This may include a wild card "*" at the end of the name. |
155+
156+
Note, that the `include` filter is applied before the `exclude` filter.
157+
That means, if a metric matches both filters, it will be excluded.
158+
The configuration applies to both the `cloud-logging` and `dynatrace` exporters independently.
159+
145160
## Using User-Provided Service Instances
146161

147162
### SAP Cloud Logging

0 commit comments

Comments
 (0)