# OSHI

<!-- llms-txt-link: /llms.txt -->

> OpenTelemetry Java agent instrumentation

When the OSHI library is detected on the classpath, this instrumentation enables system metrics for memory, disk, and network operations.

- **Name**: `oshi-5.0`
- **Scope**: `io.opentelemetry.oshi`
- **Target versions**: `com.github.oshi:oshi-core:[5.0.0,)`
- **Library**: https://github.com/oshi/oshi/

## Telemetry

- **Metrics**: `system.disk.io`, `system.disk.operations`, `system.memory.usage`, `system.memory.utilization`, `system.network.errors`, `system.network.io`, `system.network.packets`, `runtime.java.cpu_time`, `runtime.java.memory`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.oshi.experimental-metrics.enabled` | boolean | false | Enable the experimental `runtime.java.memory` and `runtime.java.cpu_time` metrics. |

## Data

- **JSON**: [/data/javaagent/instrumentations/oshi-5.0/oshi-5.0-734c32477115.json](/data/javaagent/instrumentations/oshi-5.0/oshi-5.0-734c32477115.json)
- **Explore**: [/java-agent/instrumentation/oshi-5.0](/java-agent/instrumentation/oshi-5.0)