Viewing logs
You can view audit logs, diagnostic logs, and server output logs from the
page.Audit Logs
The audit log contains entries of user activity. An entry is created whenever a user does one of the following activities:
- Performs an activity that is granted by a security permission, such as creating a
component, or creating an application. These activities include permissions granted by the
server configuration security type, such as managing plug-ins, system properties, and
statuses. Permissions are based on the team roles that are assigned to the user.Note: The audit log shows the installation, upgrade, and deletion of plug-ins as well.
- Modifies security settings, such as creating a role, or assigning a user to a role.
- Performs an authentication activity, such as logging on to the Web UI, or accessing the REST API.
- Review the audit log files by logging in as an administrator and click .
- Filter the log by typing in the fields at the top of each column. For example, to view the admin user's activities, select admin in the User Name filter field.
- View only actions in which an element was created by specifying CREATE in the Event Type filter field.
- Remove old entries from the audit log, click Cleanup Log, specify the date and time, and click Submit. All log entries prior to that date and time are permanently deleted. Deleting audit logs creates a log entry of event type Audit Log Cleanup that are non-deletable.
Diagnostics
- Diagnostics Bundle
- The diagnostics bundle contains information about the recent state of the Deploy server and system settings information. To download a Diagnostics Bundle zip file that contains the diagnostics information, click Download Diagnostics Bundle from the Diagnostics page.
- REST Call Log
- This log shows all the requests that the server receives, including requests from the web interface, the REST API, and the command-line client. You can filter this table by typing values in the fields at the top and then pressing Enter.
- Metadata Indexing
- This page shows the state of the server indexes, which stores information about elements such as components and processes. If indexing is not complete, you might not be able to use certain filters or to open certain processes. Indexing happens after certain server upgrades.
- Database
- On this page, you can analyze database query performance by clicking Test
Database Latency. The test result gives you the following
information:
- Number of queries that were completed.
- Total time to complete all of the queries.
- Total number of failed queries.
- Minimum latency for any single query.
- Maximum latency for any single query.
- Average latency for all of the queries that were completed.
Note that a maximum of 50 queries are run at a time. From the Test Results window, use the show as text/show as table option to send the result in desired format. The result is available in the diagnostics bundle as well.
Output Logs
You can get detailed logs for processes, including the all of the information and logs from each step. To troubleshoot a step, click View Output Log from the options column. The Output Log window opens and displays the output along with the timestamp. To download these logs, open the process request, and click Download All Logs.
To open the server output log file directly from UI, click . In an HA cluster, logs of all servers are downloaded in a zip format.The Deploy server log file is also located in the following directory: server_installation_directory/var/log/deployserver.out.
The information that is written to the log file is determined by the settings in the Logging tab. You can modify the configuration by clicking Add Logger from . See Managing loggers for more information.
{"ts_utc":"2022-07-07T12:13:44.849Z","ts_loc":"2022-07-07T08:13:44.849-0400","lvl":"INFO","thr":"main","log":"com.urbancode.ds.UDeployServer","msg":"License Server URL: "}
{"ts_utc":"2022-07-07T12:13:44.884Z","ts_loc":"2022-07-07T08:13:44.884-0400","lvl":"INFO","thr":"main","log":"com.urbancode.ds.UDeployServer","msg":"Database User name: dbUser"}
2022-07-21 17:31:37,274 IST INFO main com.urbancode.ds.UDeployServer - Cleaning up temp directory
2022-07-21 17:31:37,290 IST INFO main com.urbancode.ds.persistence.database.DerbyHelper - Starting Derby...
2022-07-21 17:31:37,507 IST INFO main com.urbancode.ds.persistence.database.DerbyHelper - Waiting for Derby to start...
2022-07-21 17:31:38,060 IST INFO main com.urbancode.ds.persistence.database.DerbyHelper - The Derby instance on localhost:11377 is started
2022-07-21 17:31:42,585 IST INFO main com.urbancode.ds.UDeployServer - Starting HA Lock Manager...
jq -r '.ts_loc + " " + .lvl + " " + .thr + " " + .log + " - " + .msg' "deployserver.out"
(
{"ex_msg", "ex_trc"}
)