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

CommandDescription
configPrint config
fetch-enrollment-configFetch and install enrollment configuration file
helpHelp about any command
infoPrint agent info

Flags:

FlagDescription
--disable-offsetDisables the randomized call home offset
-h, --helpHelp for o24-agent
--journald-logLog to journal (default true)
--log-level stringLowest log level to capture (default "INFO")
--log-sdadd 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 stringpath to settings file (default "/etc/o24-agent/agent-settings.yml")
--stderr-loglog to stderr
--versionprint 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.