UIM / DX IM robot audit options

book

Article ID: 196484

calendar_today

Updated On:

Products

NIMSOFT PROBES DX Infrastructure Management

Issue/Introduction

This document provides some insight into the use of the robot audit option. 

Environment

Release :8.x, 9, 20.x

Component : UIM - ROBOT

Resolution

Via raw configure the audit key can be added to robot.cfg which sets when and where to send audit messages. 

To add go to controller > raw configure > select controller > New Key > 
Key: audit 
Value: 
optional values:
post – Send audit message on controller events, this is used in conjuction with the audit probe
yes – Log controller events to controller_audit.txt located in the robot folder 
post_detail – Send audit event on controller events and configuration file changes
file_detail – Log controller events and file change events to controller_audit.txt

Also available:  
audit_checkpoint_count  Number of versions of configuration files to retain. 
audit_max_config_size  Maximum size, in bytes, of the configuration file for content comparison.
 
controller_audit.txt examples with audit = yes
2020-08-03 12:37:20    controller Audit - full reset (index file not accessible) 0
2020-08-03 12:37:21    controller Hub 902-P-H(10.74.241.234) contact established 0  
2020-08-03 12:38:21 administrator 10.74.241.234 probe_activate aws  0                 < change made via IM  
2020-08-03 12:43:14 administrator 10.74.241.234 probe_config_set aws As pds 0
2020-08-03 12:43:14 administrator 10.74.241.234 probe_activate aws  0
2020-08-03 12:47:18 aws (probe) 10.74.89.78 probe_config_set aws As pds 0                 < change made via AC
2020-08-03 12:49:55 aws (probe) 10.74.89.78 probe_config_set aws As pds 0
2020-08-03 12:50:44 wasp (probe) 10.74.241.234 probe_config_set aws As pds 0         < raw config change made via AC
2020-08-03 12:51:42 administrator 10.74.241.234 probe_config_set aws As pds 0         < raw config change made via IM 
2020-08-03 12:51:42 administrator 10.74.241.234 probe_activate aws  0
2020-08-03 13:02:15 administrator 10.74.241.234 inst_pkg_remove ad_server ad_server 0 < delete probe

deployed older version of cdm via IM
2020-08-03 13:03:25 distsrv (probe) 10.74.241.234 inst_execute  Package vs2017_vcredist_x64, section win64 0
2020-08-03 13:03:35 distsrv (probe) 10.74.241.234 inst_execute  Package cdm, section win64 0
2020-08-03 13:03:36 distsrv (probe) 10.74.241.234 inst_execute  Package cdm, section locales 0

deployed newer version of cdm via AC
2020-08-03 13:06:07 automated_deployment_engine (probe) 10.74.241.234 inst_execute  Package vs2017_vcredist_x64, section win64 0
2020-08-03 13:06:14 automated_deployment_engine (probe) 10.74.241.234 inst_execute  Package cdm, section win64 0
2020-08-03 13:06:15 automated_deployment_engine (probe) 10.74.241.234 inst_execute  Package cdm, section locales 0

10.74.241.234 IP of hub where IM is running
10.74.89.78 IP of robot with aws probe 

additionial controller_audit.txt examples with audit = file_detail
2020-08-03 13:12:21    controller Audit initiated 0
2020-08-03 13:12:21    spooler Audit initiated 0
2020-08-03 13:12:21    hdb Audit initiated 0
2020-08-03 13:12:21    hyperv Audit initiated 0
2020-08-03 13:12:21    net_connect Audit initiated 0
2020-08-03 13:12:21    ibmvm_rest Audit initiated 0

2020-08-03 13:19:50    hp_3par File changes detected 0 < hp_3par.cfg manually changed

audit_checkpoint_count
When set this folder is created: 
$\Nimsoft\robot\cfgs
In the folder is a copy of each probe cfg and a subfolder for each probe with the copy of the prior cfg versions. 

Additional Information

At hub level
Audit Settings for Robots - specify the recording of important events, such as starting and stopping the robot. The setting is used for all hub robots. Select one of the following options:
Override: audit off
Override: audit on
Use audit settings from robot