> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sys Admin Dashboard

> Monitor and manage system health, performance, and user activities with the Sys Admin Dashboard.

Zylon comes with a built-in [Kubernetes Dashboard](https://kubernetes.io/docs/tasks/access-application-cluster/web-ui-dashboard/),
which will help you monitor and diagnose issues with your installation.

To enable it, you will need to edit your config file at `/etc/zylon/zylon-conf.yaml` and add the following section:

```yaml theme={null}
adminDashboard:
  enabled: true
  exposeIngress: true
```

Next, update your Zylon system by running:

```bash theme={null}
sudo zylon-cli sync
```

Once the update completes, access the dashboard at:
`https://<zylon.company.com>/kube-dashboard`

To login, you can generate a short-lived token:

```bash theme={null}
kubectl -n zylon create token zylon
```

Or a permanent token:

```bash theme={null}
kubectl get secret zylon-token -n zylon -o jsonpath='{.data.token}' | base64 -d
```

<Warning>
  The permanent token will provide full admin access to your Kubernetes cluster.
  Keep it secret and secure.
</Warning>

<Tip>
  Zylon uses multiple namespaces, you can check the status of each.
  Select the right namespace from the dropdown on the top left corner.

  * zylon: Zylon system components
  * openebs: OpenEBS storage system
  * nvidia: NVIDIA controller and device plugin
</Tip>

After logging in, you will be able to see the status of your Zylon installation, including:

* Pods
* Logs
* Basic metrics regarding CPU and memory usage

## Frequent Questions

This section explains how to navigate the Kubernetes Dashboard to investigate common issues in your Zylon installation.

### ❓ Where do I start when something is not working?

When you first open the Kubernetes Dashboard, you'll see a high-level overview of your workloads and cluster health.
This view shows the current status of running resources such as Pods, Deployments, and basic CPU/memory usage.

<img src="https://mintcdn.com/zylon/J25J8IDOgVs0UO0R/images/operator-manual/k8s-1.png?fit=max&auto=format&n=J25J8IDOgVs0UO0R&q=85&s=8543483645ef100b8e69e3a81ad4d43f" alt="image" width="1920" height="877" data-path="images/operator-manual/k8s-1.png" />

***

### ❓ Which namespace should I select?

Zylon uses multiple namespaces, but most workspace and platform issues will be in the `zylon` namespace.

1. Open the namespace dropdown in the **top-left corner** of the dashboard
2. Select the namespace you want to check
3. The dashboard will refresh and show only that namespace's system components

This helps reduce noise and ensures you are inspecting the correct resources.

<img src="https://mintcdn.com/zylon/J25J8IDOgVs0UO0R/images/operator-manual/k8s-2.png?fit=max&auto=format&n=J25J8IDOgVs0UO0R&q=85&s=be279a6ee4b3e58abc6735327f8c4fa1" alt="image" width="1918" height="479" data-path="images/operator-manual/k8s-2.png" />

***

### ❓ How do I view logs for a Pod?

To inspect logs for a specific Pod:

1. Click on the **Pod name** you want to investigate
2. This opens the Pod details page with:

* Status
* Events
* Resource usage
* Containers

3. In the **top-right corner**, click **Logs**
   <img src="https://mintcdn.com/zylon/J25J8IDOgVs0UO0R/images/operator-manual/k8s-3.png?fit=max&auto=format&n=J25J8IDOgVs0UO0R&q=85&s=35af643efe3276c2b83cc95a86268766" alt="image" width="1912" height="970" data-path="images/operator-manual/k8s-3.png" />
   You can:

* View live logs
* Download logs for offline analysis if your instance is airgap

Logs are usually the fastest way to identify configuration errors, startup failures, or runtime issues.
