> For the complete documentation index, see [llms.txt](https://docs.vergeos-demo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vergeos-demo.com/learn-the-platform/module-9-monitoring-and-troubleshooting/09-monitoring-troubleshooting.md).

# Overview

## Learning Objectives

By the end of this module, you will be able to:

* **Navigate the VergeOS dashboard** for real-time system health monitoring
* **Configure alerts and log forwarding** to proactively detect and respond to issues
* **Diagnose common issues** using system logs, diagnostics, and built-in tools
* **Know when and how to escalate** to Verge support with the right diagnostic information

## Prerequisites

* Completion of [Module 1: Architecture Fundamentals](/learn-the-platform/module-1-architecture-fundamentals/01-architecture.md) -- understanding of VergeOS platform architecture
* Completion of [Module 4: Networking](/learn-the-platform/module-4-networking/04-networking.md) -- understanding of VergeOS networking concepts
* Completion of [Module 5: Storage](/learn-the-platform/module-5-storage/05-storage.md) -- understanding of vSAN/VergeFS storage
* Familiarity with the VergeOS UI dashboard

## Estimated Time

**3 hours** (1.5 hours reading + 1.5 hours lab)

## Topics

* [**Dashboard & System Health**](/learn-the-platform/module-9-monitoring-and-troubleshooting/01-dashboard-health.md) — Navigating the VergeOS dashboard for real-time visibility into node status, resource utilization, and cluster health.
* [**Alerts & Notifications**](/learn-the-platform/module-9-monitoring-and-troubleshooting/02-alerts.md) — Configuring system alerts, notification rules, and email/webhook alerting for proactive issue detection.
* [**Log Management & Forwarding**](/learn-the-platform/module-9-monitoring-and-troubleshooting/03-log-management.md) — System log access, filtering, search, and syslog forwarding to external SIEM and monitoring platforms.
* [**Prometheus & Grafana**](/learn-the-platform/module-9-monitoring-and-troubleshooting/04-prometheus-grafana.md) — Collecting VergeOS metrics via the first-party Prometheus Exporter (ioMetrics) and building Grafana dashboards for advanced monitoring.
* [**Diagnostics Toolkit**](/learn-the-platform/module-9-monitoring-and-troubleshooting/05-diagnostics-toolkit.md) — Built-in diagnostic tools, network troubleshooting utilities, storage health checks, and system diagnostics bundles.
* [**Common Issues & Resolution**](/learn-the-platform/module-9-monitoring-and-troubleshooting/06-common-issues.md) — Troubleshooting runbooks for the most frequently encountered VergeOS issues across compute, storage, and networking.
* [**Support Escalation**](/learn-the-platform/module-9-monitoring-and-troubleshooting/07-support-escalation.md) — Knowing when to escalate issues, gathering the right diagnostic data, and working effectively with Verge support.
* [**Lab: Monitoring & Troubleshooting**](/learn-the-platform/module-9-monitoring-and-troubleshooting/lab.md) — Explore the VergeOS dashboard, configure alerts, analyze logs, and practice diagnosing simulated issues.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vergeos-demo.com/learn-the-platform/module-9-monitoring-and-troubleshooting/09-monitoring-troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.