Service - LogCollector

Class: VMware.Hv.LogCollector
See also: LogCollectorComponentIdentifier, LogCollectorDownloadURLInfo, LogCollectorSpec, LogCollectorTaskId, LogCollectorTaskInfo, LogLevelInfo, LogLevelSpec, UserOrGroupId
Since: Horizon 7.10

Service Description

Service Interface for collecting DCT bundle from Connector Server.

Methods

Methods defined in this Service
LogCollector_Clean, LogCollector_Collect, LogCollector_GetDownloadURL, LogCollector_GetLogLevels, LogCollector_GetTaskInfo, LogCollector_GetTaskInfoById, LogCollector_List, LogCollector_Purge, LogCollector_SetLogLevels

LogCollector_Clean

A finish acknowledgement to notify the connection server for cleanup of collect complete log bundles or to terminate the collect operation if is in progress of collecting logs bundle.

Privileges

Privilege	Description
LOG_COLLECTION	Log collection privilege is required to perform log collection operations.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the LogCollector used to make the method call.
logCollectorTaskIdList	LogCollectorTaskId[]

Return Value

Type	Description
None

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
PartialFailureFault	Contains null for which the request is processed successfully. LogCollectorFault for failed ones.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Events

Event	Description
VLSI_LOG_COLLECTION_PURGE_TASK_SUCCESS	- Generated for each of the log component type when the log purge request is successfully submitted
VLSI_LOG_COLLECTION_ABORT_TASK_SUCCESS	- Generated for each of the log component type when the log abort request is successfully submitted

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_Clean" type="vdi:LogCollector_CleanRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_CleanResponse">
            <complexType/>
         </element>

LogCollector_Collect

Sends the log collection request for the set of targets

Privileges

Privilege	Description
LOG_COLLECTION	Log collection privilege is required to perform log collection operations.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the LogCollector used to make the method call.
logCollectorSpecList	LogCollectorSpec[]

Return Value

Type	Description
LogCollectorTaskInfo[]	Array of LogCollectorTaskInfo - A unique task id is returned as part of each LogCollectorTaskInfo. It is responsibility of the caller to keep track of it for using it later for fetching the status of it.

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
PartialFailureFault	Contains array of LogCollectorTaskInfo for which the request is processed successfully. LogCollectorFault for failed ones.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Events

Event	Description
VLSI_LOG_COLLECTION_INITIATE_TASK_SUCCESS	- Generated for each of the log component type when the log collect request is successfully submitted

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_Collect" type="vdi:LogCollector_CollectRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_CollectResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:LogCollectorTaskInfo" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

LogCollector_GetDownloadURL

Retrieves Download URL for each of specified LogCollectorTaskId

Privileges

Privilege	Description
LOG_COLLECTION	Log collection privilege is required to perform log collection operations.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the LogCollector used to make the method call.
logCollectorTaskIdList	LogCollectorTaskId[]

Return Value

Type	Description
LogCollectorDownloadURLInfo[]	Array of LogCollectorDownloadURLInfo

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
PartialFailureFault	Contains array of LogCollectorTaskInfo for which the request is processed successfully. LogCollectorFault for failed ones.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Events

Event	Description
VLSI_LOG_COLLECTION_DOWNLOAD_TASK_SUCCESS	- Generated for each of the log component type when log download URL is retrieved successfully

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_GetDownloadURL" type="vdi:LogCollector_GetDownloadURLRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_GetDownloadURLResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:LogCollectorDownloadURLInfo" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

LogCollector_GetLogLevels

Fetches feature wise log level information for a component.

Privileges

Privilege	Description
LOG_COLLECTION	Log collection privilege is required to perform log collection operations.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the LogCollector used to make the method call.
logCollectorComponentId	LogCollectorComponentIdentifier

Return Value

Type	Description
LogLevelInfo	LogLevelInfo - Contains feature-wise log level information for a component

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
LogCollectorFault	Thrown if the getLogLevels fails for the given component.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_GetLogLevels" type="vdi:LogCollector_GetLogLevelsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_GetLogLevelsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:LogLevelInfo"/>
               </sequence>
            </complexType>
         </element>

LogCollector_GetTaskInfo

Retrieves log collection task information for current logged-in user.

Privileges

Privilege	Description
LOG_COLLECTION	Log collection privilege is required to perform log collection operations.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the LogCollector used to make the method call.

Return Value

Type	Description
LogCollectorTaskInfo[]	Array of LogCollectorTaskInfo - Log collector task information for current user is returned.

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
PartialFailureFault	Contains array of LogCollectorTaskInfo for which the request is processed successfully. LogCollectorFault for failed ones.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_GetTaskInfo" type="vdi:LogCollector_GetTaskInfoRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_GetTaskInfoResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:LogCollectorTaskInfo" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

LogCollector_GetTaskInfoById

Retrieves log collection task information for specified task identifiers. Only the task identifiers owned by the current user are returned.

Privileges

Privilege	Description
LOG_COLLECTION	Log collection privilege is required to perform log collection operations.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the LogCollector used to make the method call.
logCollectorTaskIdList	LogCollectorTaskId[]	- A unique task identifier generated from log collect request for monitoring the status.

Return Value

Type	Description
LogCollectorTaskInfo[]	Array of LogCollectorTaskInfo

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
PartialFailureFault	Contains array of LogCollectorTaskInfo for which the request is processed successfully. LogCollectorFault for failed ones.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_GetTaskInfoById" type="vdi:LogCollector_GetTaskInfoByIdRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_GetTaskInfoByIdResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:LogCollectorTaskInfo" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

LogCollector_List

Retrieves all the log collector task information.

Privileges

Privilege	Description
ADMINISTRATOR	Administrator privilege is required along with LOG_COLLECTION privilege to perform list operation.
LOG_COLLECTION	Log collection privilege is required along with ADMINISTRATOR privilege to perform list operation.

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the LogCollector used to make the method call.

userOrGroupId

UserOrGroupId

- Optional field to filter the task information based on the user or group.

Optional parameter. If not specifing any value, this should be set to null.

Return Value

Type	Description
LogCollectorTaskInfo[]	Array of LogCollectorTaskInfo All available log collector task information is returned if no parameter used. Log collector task information for specified user returned if parameter used.

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
LogCollectorFault
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_List" type="vdi:LogCollector_ListRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_ListResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:LogCollectorTaskInfo" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

LogCollector_Purge

Purges the log collection bundle for the provided list of targets.

Privileges

Privilege	Description
ADMINISTRATOR	Administrator privilege is required along with LOG_COLLECTION privilege to perform log collection purge operation.
LOG_COLLECTION	Log collection privilege is required along with ADMINISTRATOR privilege to perform log collection purge operation.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the LogCollector used to make the method call.
componentIdentifiers	LogCollectorComponentIdentifier[]

Return Value

Type	Description
LogCollectorTaskInfo[]	Array of LogCollectorTaskInfo

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
PartialFailureFault	Contains array of LogCollectorTaskInfo for which the request is processed successfully. LogCollectorFault for failed ones.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Events

Event	Description
VLSI_LOG_COLLECTION_PURGE_TASK_SUCCESS	- Generated for each of the log component type when the log purge request is successfully submitted

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_Purge" type="vdi:LogCollector_PurgeRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_PurgeResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:LogCollectorTaskInfo" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

LogCollector_SetLogLevels

Updates feature specific log level for a component.

Privileges

Privilege	Description
LOG_COLLECTION	Log collection privilege is required to perform log level operations.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the LogCollector used to make the method call.
logLevelSpec	LogLevelSpec	Log level spec to update new log levels for a component.

Return Value

Type	Description
LogLevelInfo	LogLevelInfo - Contains updated feature-wise log level information for a component

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
LogCollectorFault	Thrown if the getLogLevels fails for the given component.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_SetLogLevels" type="vdi:LogCollector_SetLogLevelsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="LogCollector_SetLogLevelsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:LogLevelInfo"/>
               </sequence>
            </complexType>
         </element>