Skip to content

feat(agent): Agent UUID and config file#24

Open
kox13 wants to merge 12 commits intodevelfrom
agent/feat/uuid-and-config
Open

feat(agent): Agent UUID and config file#24
kox13 wants to merge 12 commits intodevelfrom
agent/feat/uuid-and-config

Conversation

@kox13
Copy link
Collaborator

@kox13 kox13 commented Feb 3, 2026

Refs #16

Most of the work for this issue is completed. The remaining gap is extending the config file to support metrics (currently only collectors are configurable).

This PR introduces a persistent agent UUID and extends the configuration file with new runtime options.


UUID

A UUID is generated on startup only if the file agent.uuid does not already exist (typically on the first launch).
Once created, the UUID is persisted and reused across subsequent restarts.

Currently, the UUID is generated using a custom GenerateUUIDv4 function from the utils namespace.
In the future, this may be replaced with a dedicated UUID library.


Configuration File

The configuration file has been extended with the following new options:

  • interval
  • server_address
  • server_port
  • collectors

Options Overview

  • interval (uint32)
    Interval between metric collections, in milliseconds.

  • server_address (string)
    Central server address (IP address or hostname).

  • server_port (uint16)
    Central server port. Must be non-zero.

  • collectors
    Section defining enabled collectors.
    Each key contains an array of strings specifying collector backends.

Supported Collectors

  • cpu

    • proc_stat
    • cpu_freq
    • rapl
    • zenpower
    • pmu
  • gpu

    • nvml
    • dcgm
    • rocm
    • level_zero
  • ram

    • mem_info
    • vm_stat
  • io

    • disk_stats
    • net_dev

Notes

At this stage, only collectors are configurable.
Metrics associated with individual collectors will be exposed and configurable in a future update.

@kox13 kox13 self-assigned this Feb 3, 2026
@kox13 kox13 added the enhancement New feature or request label Feb 3, 2026
@kox13 kox13 added this to volta Feb 3, 2026
@kox13 kox13 moved this to In review in volta Feb 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

Status: In review

Development

Successfully merging this pull request may close these issues.

1 participant