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

NameTypeDescription
_thisManagedObjectReference A reference to the LogCollector used to make the method call.
logCollectorTaskIdListLogCollectorTaskId[]



Return Value

Type Description
None

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
PartialFailureFault
  • Contains null for which the request is processed successfully.
  • LogCollectorFault for failed ones.
UnexpectedFaultThrown 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



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

NameTypeDescription
_thisManagedObjectReference A reference to the LogCollector used to make the method call.
logCollectorSpecListLogCollectorSpec[]



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
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
PartialFailureFault
UnexpectedFaultThrown 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



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

NameTypeDescription
_thisManagedObjectReference A reference to the LogCollector used to make the method call.
logCollectorTaskIdListLogCollectorTaskId[]



Return Value

Type Description
LogCollectorDownloadURLInfo[]Array of LogCollectorDownloadURLInfo

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
PartialFailureFault
UnexpectedFaultThrown 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



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

NameTypeDescription
_thisManagedObjectReference A reference to the LogCollector used to make the method call.
logCollectorComponentIdLogCollectorComponentIdentifier



Return Value

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

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
LogCollectorFaultThrown if the getLogLevels fails for the given component.
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Show WSDL type definition



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

NameTypeDescription
_thisManagedObjectReference 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
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
PartialFailureFault
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Show WSDL type definition



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

NameTypeDescription
_thisManagedObjectReference A reference to the LogCollector used to make the method call.
logCollectorTaskIdListLogCollectorTaskId[]

- A unique task identifier generated from log collect request for monitoring the status.

Return Value

Type Description
LogCollectorTaskInfo[]Array of LogCollectorTaskInfo

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
PartialFailureFault
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Show WSDL type definition



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

NameTypeDescription
_thisManagedObjectReference A reference to the LogCollector used to make the method call.
userOrGroupIdUserOrGroupId

- 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
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
LogCollectorFault
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Show WSDL type definition



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

NameTypeDescription
_thisManagedObjectReference A reference to the LogCollector used to make the method call.
componentIdentifiersLogCollectorComponentIdentifier[]



Return Value

Type Description
LogCollectorTaskInfo[]Array of LogCollectorTaskInfo

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
PartialFailureFault
UnexpectedFaultThrown 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



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

NameTypeDescription
_thisManagedObjectReference A reference to the LogCollector used to make the method call.
logLevelSpecLogLevelSpec

Log level spec to update new log levels for a component.

Return Value

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

Faults

Type Description
EntityNotFoundThrown if any specified entity cannot be found.
InsufficientPermissionThrown if the user does not have sufficient permission to perform the operation.
InvalidArgumentThrown if any specified argument is invalid.
InvalidTypeThrown if the type of any specified argument is invalid.
LogCollectorFaultThrown if the getLogLevels fails for the given component.
UnexpectedFaultThrown if an unexpected error occurs while performing the operation.

Show WSDL type definition