browse
Overview
There may be times during troubleshooting with the Umbrella Chromebook Client (UCC) that diagnostic logs are required to analyse issues further. Since there is no Umbrella Diagnostic Utility for Chromebook OS, this article is an overview of how to provide Support with information to help troubleshoot Umbrella Chromebook Client issues.
Solution
Here are the instructions to collect logs for both Umbrella Chromebook Client Extension (UCC Ext) and Umbrella Chromebook Client App (UCC App):
- Open chrome extension page by browsing chrome://extensions/ and ensure "Developer mode" is on at the top right corner.
- Make sure both Cisco Umbrella Chromebook Client Extension and Cisco Umbrella Chromebook Client App are enabled.
- Open the console window by
- Selecting on “background page” on the UCC Ext/App OR
- Selecting on the "Details" button of UCC Ext/App, navigating to “Inspect views” and selecting on “background page”.
- It should open a new window
- Select the “Console” tab in the above new window.
- Select the "Preserve log" option.
- Make sure all the log levels are selected in “Verbose” drop down.
- Clear console by running "Ctrl + L" before reproducing the issue.
- Enable logging by typing “enableLogging = true” or "enableLogs(true)" in the console window. (case sensitive)
- Turn off and turn on back the Wifi, so the UCC App logs will get collected.
- Reproduce the issue in the Chrome browser window while keeping the Console window open. It will be helpful if other tabs in chrome are closed so as to collect only the issue logs.
- Right click on the console logs and “Save as” the file in a folder with a proper name including Ext. e.g. UCC_EXT.log
- Disable logging by typing “enableLogging = false” or "enableLogs(false)" in the console window.
- Open background page of the UCC App by selecting on the “Cisco Umbrella Chromebook client (App)” and then repeat the above steps to collect logs and save the file with a proper name E.g. UCC_APP.log
Note:
By default (or commonly, as is best practice) the background page is not available for app/ext that have been pushed from the Google Admin console. Navigate to Device Management --> Chrome --> User Settings --> Select 'Always allow use of built-in developer tools' --> Click 'save' Update policy on the Chromebook and it should now display the link for the background page.
"enableLogging = true" : logging is enabled for the given session, reboot or user logout will disable the logging.
"enableLogs(true)" : logging will be enabled across reboots and user login/logout
What do the logs look like?
The App logs look like this:
They contain details on the state of the Chromebook client service.
The Extension logs look like this:
They contain the domains being queried by the Chromebook and how they are resolving (cache, redirect to block page, IP answer, etc).