Using DiagnosticManager

The vSphere API provides access to the DiagnosticManager, the service interface for obtaining information from the log files and for generating diagnostic bundles. The logs are populated based on configuration settings, such as info, trivia, and so on.

The DiagnosticManager is a managed object that works service-wide, rather than on a per-session basis. The DiagnosticManager has no properties, but provides operations for these tasks:

  • Obtaining information about the logs and how they have been defined.
  • Generating a diagnostic bundle that can be sent to VMware support for analysis.

DiagnosticManager Managed Object and Associated Data Objects shows a UML class diagram for DiagnosticManager, which is available on ESXi and vCenter Server systems.

Figure 1. DiagnosticManager Managed Object and Associated Data Objects

As shown in DiagnosticManager Managed Object and Associated Data Objects, DiagnosticManager supports these methods:

  • BrowseDiagnosticLog
  • GenerateLogBundleTask
  • QueryDescriptions

The DiagnosticManagerLogDescriptor.creator property contains the creator of the log, which is the system or subsystem that controls a specific log.

The creator value is populated from the DiagnosticManagerLogCreator enumeration. The following table lists all string values currently available from the DiagnosticManagerLogCreator enumeration that can populate the creator property of the DiagnosticManagerLogDescriptor data object.

Name Description
hostd Host daemon
install Installation
recordLog System record log
serverd Host server agent
vpxa vCenter agent
vpxClient vSphere Client
vpxd vCenter service
Creator File Name Format Info.label Info.summary Key Mime Type
hostd /var/log/vmware/hostd.log plain ESX Log ESX log in plain format hostd text/plain
hostd /var/log/messages plain ESX Log ESX log in plain format messages text/plain
hostd /var/log/vmkernel plain ESX Log ESX log in plain format vmkernel text/plain
hostd /var/log/vmksummary.txt plain ESX Log ESX log in plain format vmksummary text/plain
hostd /var/log/vmkwarning plain ESX Log ESX log in plain format vmkwarning text/plain
vpxa /var/log/vmware/vpx/vpxa.log plain vCenter Agent Log vCenter agent log in plain format vpxa text/plain