Using the Agent Info Command

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

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: