> For the complete documentation index, see [llms.txt](https://docs.rumi.systems/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rumi.systems/rumi-management/reference/agent/configuration.md).

# Configuration

This page provides a reference for Rumi Agent configuration properties.

## Agent Properties

### REST API

| Property             | Description                       | Default |
| -------------------- | --------------------------------- | ------- |
| `nv.agent.http.port` | Port for the REST API HTTP server | 7778    |

### Telemetry Storage

| Property               | Description                                         | Default |
| ---------------------- | --------------------------------------------------- | ------- |
| `nv.agent.point.store` | Storage backend: `influx`, `fake_influx`, or `none` | —       |
| `nv.agent.influx.url`  | InfluxDB HTTP endpoint URL                          | —       |

### Embedded Controller

| Property                      | Description                             | Default |
| ----------------------------- | --------------------------------------- | ------- |
| `nv.agent.controller.factory` | Controller implementation factory class | —       |

### Runtime

| Property              | Description                                           | Default |
| --------------------- | ----------------------------------------------------- | ------- |
| `nv.agent.jvm.params` | JVM parameters for the embedded runtime               | —       |
| `nv.agent.acceptor`   | Messaging acceptor descriptor for heartbeat reception | —       |

## Application Configuration (config.xml)

The Agent runs as a Rumi AEP application defined in `config.xml`.

### Application Definition

* **Application name:** `rumi-agent-1`
* **Container name:** `rumi-agent-vm`

### Statistics Collection

The following statistics are configurable in `config.xml`:

| Setting       | Description                                                        |
| ------------- | ------------------------------------------------------------------ |
| Memory stats  | Entity counts, pool allocation, heap/non-heap usage                |
| Latency stats | Messaging waypoint latencies                                       |
| Series stats  | Latency time-series with configurable sample size (default: 10240) |

### Heartbeat Settings

| Setting            | Description                               | Default      |
| ------------------ | ----------------------------------------- | ------------ |
| Heartbeat interval | Frequency of container heartbeat emission | 5 seconds    |
| Thread stats       | Collect per-thread metrics                | Configurable |
| Pool stats         | Collect memory pool utilization           | Configurable |
| GC stats           | Collect non-ZGC garbage collection data   | Configurable |

### Profiles

Configuration profiles provide environment-specific overrides:

| Profile     | Description                      |
| ----------- | -------------------------------- |
| `dev`       | Development environment settings |
| `neeve-lab` | Neeve lab environment settings   |

## Technology Stack

| Component           | Version                         |
| ------------------- | ------------------------------- |
| Jetty (HTTP server) | 9.4.54                          |
| Jersey (JAX-RS)     | 2.35                            |
| Swagger/OpenAPI     | 2.2.8                           |
| Google Guice (DI)   | —                               |
| InfluxDB client     | Compatible with InfluxDB 1.8.10 |