|
| 1 | +:_mod-docs-content-type: REFERENCE |
| 2 | + |
| 3 | +[id="ref-controller-log-files"] |
| 4 | + |
| 5 | += Access {ControllerName} logfiles |
| 6 | + |
| 7 | +In the `/var/log/tower/` directory, you can view logfiles captured by: |
| 8 | + |
| 9 | +* *tower.log:* Captures the log messages such as runtime errors that occur when the job is executed. |
| 10 | +* *callback_receiver.log:* Captures callback receiver logs that handles callback events when running ansible jobs. |
| 11 | +* *dispatcher.log:* Captures log messages for the {ControllerName} dispatcher worker service. |
| 12 | +* *job_lifecycle.log:* Captures details of the job run, whether it is blocked, and what condition is blocking it. |
| 13 | +* *management_playbooks.log:* Captures the logs of management playbook runs, and isolated job runs such as copying the metadata. |
| 14 | +* *rsyslog.err:* Captures rsyslog errors authenticating with external logging services when sending logs to them. |
| 15 | +* *task_system.log:* Captures the logs of tasks that {ControllerName} is running in the background, such as adding cluster instances and logs related to information gathering or processing for analytics. |
| 16 | +* *tower_rbac_migrations.log:* Captures the logs for rbac database migration or upgrade. |
| 17 | +* *tower_system_tracking_migrations.log:* Captures the logs of the controller system tracking migration or upgrade. |
| 18 | +* *wsbroadcast.log:* Captures the logs of websocket connections in the controller nodes. |
| 19 | + |
| 20 | +In the `/var/log/supervisor/` directory, you can view logfiles captured by: |
| 21 | + |
| 22 | +* *awx-callback-receiver.log:* Captures the log of callback receiver that handles callback events when running ansible jobs, managed by `supervisord`. |
| 23 | +* *awx-daphne.log:* Captures the logs of Websocket communication of WebUI. |
| 24 | +* *awx-dispatcher.log:* Captures the logs that occur when dispatching a task to an {ControllerName} instance, such as when running a job. |
| 25 | +* *awx-rsyslog.log:* Captures the logs for the `rsyslog` service. |
| 26 | +* *awx-uwsgi.log:* Captures the logs related to uWSGI, which is an application server. |
| 27 | +* *awx-wsbroadcast.log:* Captures the logs of the websocket service that is used by {ControllerName}. |
| 28 | +* *failure-event-handler.stderr.log:* Captures the standard errors for `/usr/bin/failure-event-handler` supervisord's subprocess. |
| 29 | +* *supervisord.log:* Captures the logs related to `supervisord` itself. |
| 30 | +* *wsrelay.log:* Captures the communication logs within the websocket relay server. |
| 31 | +* *ws_heartbeat.log:* Captures the periodic checks on the health of services running on the host. |
| 32 | +* *rsyslog_configurer.log:* Captures rsyslog configuration activity associated with authenticating with external logging services. |
| 33 | + |
| 34 | +The `/var/log/supervisor/` directory includes `stdout` files for all services as well. |
| 35 | + |
| 36 | +You can expect the following log paths to be generated by services used by {ControllerName} (and {PlatformNameShort}): |
| 37 | + |
| 38 | +* */var/log/nginx/* |
| 39 | +* */var/lib/pgsql/data/pg_log/* |
| 40 | +* */var/log/redis/* |
| 41 | + |
| 42 | +.Troubleshooting |
| 43 | + |
| 44 | +Error logs can be found in the following locations: |
| 45 | + |
| 46 | +* {ControllerNameStart} server errors are logged in `/var/log/tower`. |
| 47 | +* Supervisors logs can be found in `/var/log/supervisor/`. |
| 48 | +* Nginx web server errors are logged in the httpd error log. |
| 49 | +* Configure other {ControllerName} logging needs in `/etc/tower/conf.d/`. |
| 50 | + |
| 51 | +Explore client-side issues using the JavaScript console built into most browsers and report any errors to Ansible through the Red Hat Customer portal at: https://access.redhat.com/. |
0 commit comments