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

# Healthcheck (InfluxDB + Telegraf)

> Monitor endpoint and SIEM health signals via Telegraf metrics stored in InfluxDB.

# Healthcheck (InfluxDB + Telegraf)

**Menu:** Healthcheck

**Best for:** Admin / Engineer (primary) + Operator (awareness)

CoPilot’s Healthcheck ties into **InfluxDB** to surface health signals collected by **Telegraf**.

Typical signals include:

* CPU consumption
* memory consumption
* disk space utilization

This is useful for detecting spikes, capacity issues, and “slow burn” failures before they impact your SIEM.

<img src="https://mintcdn.com/socfortressllc/ZF3TjekosrsQhf-4/assets/ui/healthcheck.png?fit=max&auto=format&n=ZF3TjekosrsQhf-4&q=85&s=30cee63b7b6cc5732f9d5a5993b82f63" alt="Healthcheck" width="1558" height="918" data-path="assets/ui/healthcheck.png" />

***

## How it works (high level)

1. **Telegraf** runs on endpoints/servers and collects metrics (cpu/mem/disk)
2. Metrics land in **InfluxDB** (CoPilot queries the InfluxDB `_monitoring` bucket)
3. Health checks and thresholds create alert states (ok/info/warn/crit)
4. CoPilot displays the resulting alerts in the Healthcheck UI

***

## What you can do in CoPilot

### Review active alerts

<img src="https://mintcdn.com/socfortressllc/ZF3TjekosrsQhf-4/assets/ui/healthcheck-overview.png?fit=max&auto=format&n=ZF3TjekosrsQhf-4&q=85&s=cb40e34652cc3d0fe56c6defddfddd67" alt="Healthcheck overview (placeholder)" width="1554" height="912" data-path="assets/ui/healthcheck-overview.png" />

Use this to quickly see:

* what is currently broken / at risk
* which systems are trending toward failure

### Triage by severity

Healthcheck alerts are categorized by severity (for example: **Critical**, **Warning**, **Info**, **Ok**).

<img src="https://mintcdn.com/socfortressllc/ZF3TjekosrsQhf-4/assets/ui/healthcheck-alerts.png?fit=max&auto=format&n=ZF3TjekosrsQhf-4&q=85&s=f19ef22c3c5ce4c13b072760902bee7d" alt="Healthcheck alerts (placeholder)" width="1554" height="912" data-path="assets/ui/healthcheck-alerts.png" />

***

## What to monitor (recommended)

### CPU

* sustained high CPU on Graylog/Wazuh components can cause ingestion/alerting lag

### Memory

* memory pressure can lead to OOM kills and unstable services

### Disk

* disk thresholds are the most common SIEM failure mode (indexes stop accepting writes)

***

## Practical runbook (when something trips)

1. Identify what triggered (disk vs cpu vs mem)
2. Identify the system/host
3. Decide whether this is:
   * a transient spike
   * a sustained capacity issue
   * a misconfiguration (wrong retention / noisy ingestion)
4. Take action:
   * disk: snapshot/restore + retention tuning + index cleanup
   * cpu/mem: scale resources, tune ingestion, investigate heavy queries

Related pages:

* [Index management (Wazuh Indexer)](/user/ui/indices-management)
* [Snapshot & restore (cold storage)](/user/ui/indices-snapshots)

***

## Advanced: check names and thresholds

Depending on your deployment, Influx may expose many checks.

<img src="https://mintcdn.com/socfortressllc/ZF3TjekosrsQhf-4/assets/ui/healthcheck-check-names.png?fit=max&auto=format&n=ZF3TjekosrsQhf-4&q=85&s=38b5db825ccffe419faede0a5782e633" alt="Check names (placeholder)" width="1556" height="352" data-path="assets/ui/healthcheck-check-names.png" />

If you want to standardize what shows up in CoPilot, define consistent Telegraf inputs and consistent alert thresholds.

<img src="https://mintcdn.com/socfortressllc/ZF3TjekosrsQhf-4/assets/ui/healthcheck-thresholds.png?fit=max&auto=format&n=ZF3TjekosrsQhf-4&q=85&s=3e9dfc679aef549870b4014ee3e2a423" alt="Thresholds (placeholder)" width="1796" height="704" data-path="assets/ui/healthcheck-thresholds.png" />

***

## Common gotchas

### “Healthcheck is empty”

Common causes:

* Telegraf isn’t deployed or isn’t shipping metrics
* InfluxDB connector isn’t configured in CoPilot
* wrong org/bucket configuration (CoPilot expects `_monitoring`)

### “Alerts are noisy”

Tune thresholds to avoid flapping (especially CPU) and focus on sustained conditions.
