Skip to content

Commit 0ce49a4

Browse files
committed
Update k8s.md
1 parent 745159d commit 0ce49a4

File tree

1 file changed

+54
-0
lines changed
  • docs/_include/general-shipping

1 file changed

+54
-0
lines changed

docs/_include/general-shipping/k8s.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -253,7 +253,61 @@ For example, for a parameter called `someField` in the `logzio-apm-collector`'s
253253
```
254254

255255
</TabItem>
256+
<TabItem value="obi-ebpf-instrumentation" label="OBI ebpf instrumentation" default>
256257

258+
## Enable eBPF Auto-instrumentation (OBI)
259+
260+
Avilable from `logzio-monitoring` version `7.9.2`
261+
262+
OpenTelemetry eBPF Instrumentation (OBI) provides zero-code auto-instrumentation for Kubernetes applications using eBPF technology. It automatically captures HTTP/S requests, gRPC calls, and database queries without requiring code changes or application restarts.
263+
264+
### Prerequisites
265+
266+
- Kubernetes 1.19+
267+
- Linux kernel 5.8+ (for full eBPF support)
268+
- Privileged security context with specific capabilities
269+
- Container runtime: containerd, CRI-O, or Docker
270+
271+
### Enable OBI
272+
273+
To enable OBI with the logzio-monitoring chart:
274+
275+
```shell
276+
helm install logzio-monitoring logzio-helm/logzio-monitoring \
277+
--set obi.enabled=true \
278+
--set logzio-apm-collector.enabled=true \
279+
--set global.logzioTracesToken="<<TRACES-SHIPPING-TOKEN>>" \
280+
--set global.logzioRegion="<<LOGZIO-REGION>>"
281+
```
282+
283+
OBI will automatically send traces to the `logzio-apm-collector` service within the cluster.
284+
285+
### Service Discovery
286+
By default, OBI instruments all applications in all namespaces. Customize via `config.discovery`:
287+
288+
```yaml
289+
config:
290+
discovery:
291+
instrument:
292+
- k8s_namespace: "production"
293+
exclude_instrument:
294+
- k8s_namespace: "kube-system"
295+
```
296+
297+
### Configuration Options
298+
299+
Override OBI settings:
300+
301+
```shell
302+
--set obi.hostNetwork=true \
303+
--set obi.network.enabled=true
304+
```
305+
306+
> [!WARNING]
307+
> OBI has limitations with gRPC and HTTP/2 protocols. See [Context Propagation Guide](https://github.com/logzio/logzio-helm/blob/master/charts/obi/CONTEXT_PROPAGATION.md) for details.
308+
309+
310+
</TabItem>
257311
<TabItem value="k8s-obj-data" label="K8S Objects" default>
258312

259313

0 commit comments

Comments
 (0)