Using the Log Browser to view, search, and export Logs for troubleshooting
search cancel

Using the Log Browser to view, search, and export Logs for troubleshooting

book

Article ID: 322838

calendar_today

Updated On:

Products

VMware vCenter Server

Issue/Introduction

You can view, search, and export one or more vCenter Server and ESXi log files at a time using the log browser.
You can also export, manage, and view different log types.
 
Note: This is a not a comprehensive guide. For more information, see the vSphere documentation. The documentation contains definitive information. If there is a discrepancy between the documentation and this article, assume that the documentation is correct. Note that as of 6.5U2d and above, this feature has been disabled.


Environment

VMware vCenter Server 6.0.x
VMware vCenter Server 5.1.x
VMware vCenter Server 5.0.x
VMware vCenter Server 6.5.x

Resolution

Log browser is a plug-in to the vSphere Web Client, and is part of the vCenter Server installation package. To use the log browser, you must deploy the log browser plug-in.

If you deploy the log browser plug-in, you can view, search, and export one or more vCenter Server and ESXi log files at a time using the log browser. You can also export, manage, and view different log types.


Log in to vSphere Web Client and provide the credentials. When you are inside the Web Client, you have two ways to navigate to the Log Browser:
  1. Log Browser for a specific host or vCenter Server
  2. Browse Log Files from Different Objects

Log Browser for a specific host or vCenter Server

Procedure:
  1. Navigate to the host or vCenter Server that contain the logs you want to retrieve.
  2. Click the Monitor tab.
  3. Click Log Browser.
  4. (Optional) If no logs for the host or vCenter Server are available, click Retrieve now to retrieve the logs for that object.

    The retrieved logs are based on a current snapshot of the system. Retrieving logs can take a few minutes. You can perform other tasks while the logs are being retrieved.
     
  5. (Optional) Click Refresh to retrieve newer logs.
  6. Select the type of log you want to browse.

    The log displays in the browser.

Browse Log Files from Different Objects

You can browse multiple log files coming from different objects within the Log Browser at the same time. This is helpful if you want to simultaneously compare log files.
 
Procedure:
  1. From the vSphere Web Client home, click Log Browser.
  2. Click the View tab.
  3. Select an object (ESXi host or vCenter Server) to view its logs.
  4. Open a new browser window by selecting Actions > New Browser Window and select another object to view its logs.
There are various options available through Log browser, some are them are mentioned below:
  • Search Log Files
  • Filter Log Files
  • Create Advanced Log Filters
  • Adjust Log Times
  • Export Logs from the Log Browser
  • Manage Logs Using the Log Browser

Search Log Files

You can search the log files by text or by time.
 
Prerequisites
If the log is unavailable, you must retrieve it. click Retrieve now to retrieve the logs for that object.
 
Procedure:
  1. Navigate to the Log Browser.
  2. Select the type of log you want to browse.
  3. In the Actions menu, select either Find by Text or Find by Time.
  4. In the search area at the bottom of the Log Browser type the text or select the time you want to search.
  5. Click Next to view the next line containing the text or time searched or Previous to view the previous line.

    The Log Browser displays the line (in the 3rd row) that contains the text or time you searched.

Filter Log Files

The Log Browser displays filtered searches.
 
Procedure:
  1. Navigate to the Log Browser and select a log file to browse.
  2. Select the number of Adjacent lines you want the Log Browser to display.
  3. Type the text that you want filtered in the search box.
When displaying adjacent lines, groups of consecutive entries are highlighted with a different background color.
 
The log browser displays the lines in the log that contain the word you typed, along with the number of adjacent (before and after) lines.

Create Advanced Log Filters

You can create and save log file filters to your local system.
 
Procedure
  1. Navigate to the Log Browser and retrieve a log file object.
  2. Click Advanced filter.
  3. Enter the conditions you want included in the filter.
  4. Type a filter name.
  5. Click Save to save the filter. The filter is saved on the vSphere Web Client server and is available the next time you start the vSphere Web Client.
  6. Click Filter to view the results in the Log Browser.
What to do next: You can load saved filters from your local system by clicking Save to local system. The filters are saved in XML format. You can also load filters from an XML file from your local system by clicking Load from local system.

Adjust Log Times

You might want to adjust the times in the log files to a different time zone or to compare multiple log files.
 
Procedure
  1. Navigate to the Log Browser and retrieve a log file from an object.
  2. In the Actions menu, select Adjust by Time.
  3. Select Add or Subtract and adjust the days, hours, minutes, seconds, or milliseconds from the original time stamps in the log. The adjusted time stamp appears.
  4. (Optional) Click Reset to adjust the time stamp back to the original times.
  5. Click Apply.

    The log browser displays the log entries with the adjusted times.

Export Logs from the Log Browser

You can export log files using the Log Browser.
 
Procedure
  1. Navigate to the Log Browser and select an object to browse.
  2. Select Action > Export.
  3. Select the type of file that you want to export. Selecting the log file bundle downloads a potentially large file.
  4. Click Export. After a few seconds a new web browser displays.
  5. Enter the location where you want to save the file.
The log file is downloaded to your local machine and you can close the new browser window.

Manage Logs Using the Log Browser

From the Log Browser, you can update, remove, and see a list of available log file bundles. To manage log file bundles, you must access the Log Browser from the vSphere Web Clienthome.
 
Procedure
  1. From the vSphere Web Client home, click Log Browser.
  2. Click the Manage tab.
  3. Select an object's log file in the list of sources.
  4. (Optional) Click Remove to delete the log file bundle. Deleting the log file bundle reclaims disk space on the vSphere Web Client server. All log files generated from that bundle are deleted.
  5. (Optional) Click Update to update the list of log file bundles. You can view the log bundles created by other vSphere Web Client sessions.
The log does not appear in the retrievable objects list.


Additional Information

ログ ブラウザを使用したトラブルシューティングのためのログの確認、検索およびエクスポート
使用日志浏览器查看、搜索和导出日志以进行故障排除