Skip to main content
Skip table of contents

Using the Agent Info Command

Purpose

This document 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.

CODE
{
  "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:

BASH
$ o24-agent --help




Copyright

© 2025 Outpost24® All rights reserved. This document may only be redistributed unedited and unaltered. This document may be cited and referenced only if clearly crediting Outpost24® and this document as the source. Any other reproduction and redistribution in print or electronically is strictly prohibited without explicit permission.

Trademark

Outpost24® and OUTSCAN™ are trademarks of Outpost24® and its affiliated companies. All other brand names, product names or trademarks belong to their respective owners.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.