Purpose

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

Introduction

The info command retrieves metadata about the agent such as identifiers and timestamps when certain actions were last performed.

Running the Command

Requirements

Linux - ssh console
Windows - command prompt

The `o24-agent` Command

Note

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:

$ o24-agent info | jq

BASH

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"
  }
}

Note

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:

$ o24-agent --help

BASH

_Copyright

_{© 2023 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.}