Activities and events from BlueCat Cisco ACI are logged in two files, stored within the
Gateway logs folder that was configured during installation:
Events for scheduled discoveries are logged to the file
cisco_aci.log.All other BlueCat Cisco ACI events (including those for non-scheduled discoveries) are logged to the general
messages.logfile.
By default, the BlueCat Cisco ACI Plugin logs events at the INFO level.
This level includes warning, error, and non-critical information events.
BlueCat Cisco ACI uses BlueCat Gateway's standard logging features, such as log rotation. New log files are created each time the Apache server is restarted or it exceeds a specified size. If the number of archived log files exceeds a specified value, the oldest log file is deleted. By default, new log files are rotated when a file reaches 10MB, and the last 10 log files are retained, though you can change this in the Logs settings. For more details, see Log rotation in the BlueCat Gateway Administration Guide.
To configure the log level, log rotation logging settings, and other logging behaviour,
go to the Logs section of Gateway's General
configuration page. (From Gateway, click the 
Navigator button if
necessary, then click . Click Logs at the bottom to expand the Logs
settings.)
messages.log and cisco_aci.log files.Downloading BlueCat Cisco ACI logs
To download Cisco ACI logs:
From Cisco ACI, click the
System icon in the page header and select
Download logs. The downloaded log files include
both the messages.logandcisco_aci.logfiles.You must have the appropriate permissions to see the
System icon or the Download logs command. If you do
not see them, this is typically for one of two reasons:The Address Manager BlueCatGateway user was not configured as an
adminuser during installation and setup. Gateway (and BlueCat Cisco ACI) signs in as this user when connecting to Address Manager.For more details on setting up the BlueCatGateway user as an administrator, see Creating a BlueCat Gateway user in Address Manager
The current user logged in to Gateway does not have the Download Logs permission. By default, admin users have access to all permissions, but you can grant non-admin users this permission from the Gateway Permissions page. To do so:
While signed in as an administrator user, open the Permissions page. (Click the
Navigator button if necessary, then
click .)-
In the table of permissions, click the permission you want to assign in the Permission column (in this case, download_logs).
In the details page, click Edit (in the lower right corner).
Edit the list of user groups assigned to the permission as desired. To assign the permission to all users, add the
alluser group.When you're done, click Save.
For more details, see Setting page and REST endpoint permissions in the BlueCat Gateway Administration Guide.
For more details on downloading Gateway (and BlueCat Cisco ACI) log files, see Downloading BlueCat Gateway log files in the BlueCat Gateway Administration Guide.
Logged events and notifications
Within the messages.log and cisco_aci.log files,
logged events from BlueCat Cisco ACI include the creation of all Address Manager
Configurations, Blocks, Networks, and Devices.
Gateway also uses the messages.log file to track its own warnings,
errors, and events. All BlueCat Cisco ACI log messages are preceded with
[ACI Plugin].
On a Linux system, you can use regular expressions with
grep to extract only messages pertaining to BlueCat Cisco
ACI. To do so, use the following command:
$ cat <directory path where message log is located>/<log file name> | grep "ACI Plugin"To further filter the list to see only BlueCat Cisco ACI error messages, use this command instead:
$ cat <directory path where message log is located>/<log file name> | grep "ACI Plugin" | grep "ERROR"