---
title: "System dump"
weight: 1
description: "Learn how to collect system dumps."
---

Before you report a problem, make sure to retrieve the necessary information
from your cluster.

Tetragon's bugtool captures potentially useful information about your
environment for debugging. The tool is meant to be used for debugging a single
Tetragon agent node but can be run automatically in a cluster. Note that in the
context of Kubernetes, the command needs to be run from inside the Tetragon
Pod's container.

Key information collected by bugtool:
- Tetragon configuration
- Network configuration
- Kernel configuration
- eBPF maps
- Process traces (if tracing is enabled)

## Automatic Kubernetes cluster sysdump

You can collect information in a Kubernetes cluster using the Cilium CLI:

```shell
cilium sysdump
```

More details can be found in the [Cilium docs](https://docs.cilium.io/en/stable/operations/troubleshooting/#automatic-log-state-collection).
The Cilium CLI `sysdump` command will automatically run `tetra bugtool` on each
nodes where Tetragon is running.

## Manual single node sysdump

It's also possible to run the bug collection tool manually with the scope of a
single node using `tetra bugtool`.

### Kubernetes installation

1. Identify the Tetragon Pod (`<tetragon-namespace>` is likely to be `kube-system`
   with the default install):

   ```bash
   kubectl get pods -n <tetragon-namespace> -l app.kubernetes.io/name=tetragon
   ```

2. Execute tetra bugtool within the Pod:

   ```bash
   kubectl exec -n <tetragon-namespace> <tetragon-pod-name> -c tetragon -- tetra bugtool
   ```

3. Retrieve the created archive from the Pod's filesystem:

   ```bash
   kubectl cp -c tetragon <tetragon-namespace>/<tetragon-pod-name>:tetragon-bugtool.tar.gz tetragon-bugtool.tar.gz
   ```

### Container installation

1. Enter the Tetragon Container:

   ```bash
   docker exec -it <tetragon-container-id> tetra bugtool
   ```

2. Retrieve the archive using docker cp:

   ```bash
   docker cp <tetragon-container-id>:/tetragon-bugtool.tar.gz tetragon-bugtool.tar.gz
   ```

### Systemd host installation

1. Execute tetra bugtool with Elevated Permissions:

   ```bash
   sudo tetra bugtool
   ```
