Using the Agent Info Command

^{Last Updated:}^2024-11-22

Purpose

This article describes how to use the agent info command to retrieve metadata.

Introduction

The o24-agent info command is a diagnostic tool in Outpost24 that lets you gather metadata about a deployed agent. When executed on the agent host—whether on Linux via SSH or on Windows via the command prompt—the command returns details like unique agent and tenant IDs, enrollment status, timestamps for when configuration or scan schedules were last fetched, and the status of call-home operations. Having visibility into this information helps administrators confirm that agents are properly enrolled, synchronized with the server, and operating on the current schedules, which is essential for reliable vulnerability management and tracing down issues with scan coverage or agent behavior.

Running the Command

Requirements

Linux - ssh console
Windows - command prompt

The `o24-agent` Command

For windows based agents, use agent.exe in a Windows command prompt.

Available commands in o24-agent:

Command	Description
config	Print config
fetch-enrollment-config	Fetch and install enrollment configuration file
help	Help about any command
info	Print agent info

Flags:

Flag	Description
--disable-offset	Disables the randomized call home offset
-h, --help	Help for o24-agent
--journald-log	Log to journal (default true)
--log-level string	Lowest log level to capture (default "INFO")
--log-sd	add structured data to log (default true)
--priority string	priority to run as: `setting \| posix(nice)` `high \| -16` `above \| -8` `normal \| 0` `below \| 8` `low \| 16` (default "low")
--settings string	path to settings file (default "`/etc/o24-agent/agent-settings.yml`")
--stderr-log	log to stderr
--version	print version and quit

Use "o24-agent [command] --help" for more information about a command.

Using the `info` command

The info command can be executed from a terminal:

Bash

$ o24-agent info | jq

The info command will retrieve the following information.

{
  "agentUuid": "3af112bb-44d9-4ceb-8fa4-c3f1928bff3f",
  "tenantUuid": "ba3d2be5-56ae-454f-bee8-a4b1b023a33e",
  "enrollmentStatus": true,
  "callHome": {
    "postAgent": "2022-03-11T08:09:18.350347112Z",
    "getSettings": "2022-03-11T08:09:18.272644589Z",
    "getSchedules": "2022-03-11T08:09:18.400405208Z"
  },
  "schedules": [
    {
      "uuid": "75551ca2-b9b8-4039-98e2-5dd90fbc1050",
      "lastUpdated": "2022-03-10T12:58:54.900929Z",
      "lastRun": "2022-03-10T10:09:01.21942452Z",
      "modules": {
        "commands": {
          "lastDownloaded": "2022-03-10T10:08:51.971982082Z",
          "lastUploaded": "2022-03-10T10:09:01.22285461Z"
        },
        "psh-commands": {
          "lastDownloaded": "2022-03-10T10:08:51.971982082Z"
        },
        "registry": {
          "lastDownloaded": "2022-03-10T10:08:51.971982082Z"
        }
      }
    },
    {
      "uuid": "ca8c72c1-a5d9-4eea-b504-56cb659f75ee",
      "lastUpdated": "2022-03-10T12:58:54.900929Z",
      "lastRun": "2022-03-10T13:08:59.458141308Z",
      "modules": {
        "commands": {
          "lastDownloaded": "2022-03-10T13:08:55.859837754Z",
          "lastUploaded": "2022-03-10T13:08:59.461690527Z"
        },
        "psh-commands": {
          "lastDownloaded": "2022-03-10T13:08:55.859837754Z"
        },
        "registry": {
          "lastDownloaded": "2022-03-10T13:08:55.859837754Z"
        }
      }
    }
  ],
  "logs": {
    "lastUploaded": "2022-03-11T08:09:19.237524123Z"
  }
}

last uploaded is relevant for all modules but is only visible for the ones that can run on the operating system.

For more information about the o24-agent command type: