# noust monitor

Watch this server and write down what stands out.

```bash
noust monitor [OPTIONS] COMMAND [ARGS]...
```

Subcommands: [`autoenable`](#noust-monitor-autoenable), [`config`](#noust-monitor-config), [`disable`](#noust-monitor-disable), [`enable`](#noust-monitor-enable), [`export`](#noust-monitor-export), [`install`](#noust-monitor-install), [`run`](#noust-monitor-run), [`scan`](#noust-monitor-scan), [`status`](#noust-monitor-status), [`test-email`](#noust-monitor-test-email), [`uninstall`](#noust-monitor-uninstall)

## noust monitor autoenable

Enable the monitor unless it was turned off (what the package runs).

```bash
noust monitor autoenable [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor config

Show the monitor's current settings and where its database lives.

```bash
noust monitor config [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor disable

Stop the monitor and keep it from starting at boot.

```bash
noust monitor disable [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor enable

Start the monitor now and on every boot, installing it if needed.

```bash
noust monitor enable [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor export

Print the newest value of every metric the way a scraper reads it.

```bash
noust monitor export [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--format` | The text format to write. | `prometheus` |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor install

Write the monitor's systemd unit, without starting it.

```bash
noust monitor install [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor run

Scan on a loop in this terminal, until you press Ctrl+C.

```bash
noust monitor run [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor scan

Look at the machine once and print what stands out.

```bash
noust monitor scan [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--force-ai` | Retired. The monitor analyses nothing off this machine; it only reports. |  |
| `--all` | Retired. Every scan already walks the whole process table. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor status

Show whether the monitor is running and what it is watching.

```bash
noust monitor status [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--open` | Print the panel URL for the dashboard, opening it if a display is available. |  |
| `--json` | Print the status as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor test-email

Send one email to the configured recipients to prove the settings work.

```bash
noust monitor test-email [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust monitor uninstall

Remove the monitor's systemd unit from this server.

```bash
noust monitor uninstall [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `-y`, `--yes` | Do not ask for confirmation. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

