Share via


hpcazurelog

 

Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2

Manages the trace log files for Windows Azure node deployments from HPC Pack.

Note

This command was introduced in HPC Pack 2012 with Service Pack 1 (SP1) and is not supported in previous versions.

Important

This command can only be run on the head node of the Windows HPC cluster.

Syntax

hpcazurelog SetComponentTracingLevel /template:<nodeTemplateName>
/level:{off|admin|debug}
[/component:{AzureNodeManagerTracing|
AzureFileStagingWorkerTracing|
AzureNodeCountersTracing|
AzureSoaDiagMonTracing|
AzureHostsFileDistributionTracing|
AzureSchedulerProxyTracing|
AzureBrokerProxyTracing|
AzureDataProxyTracing|
AzureFileStagingProxyTracing}]


hpcazurelog ListComponentTracingLevel /template:<nodeTemplateName>
[/component:{AzureNodeManagerTracing|
AzureFileStagingWorkerTracing|
AzureNodeCountersTracing|
AzureSoaDiagMonTracing|
AzureHostsFileDistributionTracing|
AzureSchedulerProxyTracing|
AzureBrokerProxyTracing|
AzureDataProxyTracing|
AzureFileStagingProxyTracing}]


hpcazurelog GetNodeLogs /template:<nodeTemplateName>
/nodeName:{<node1,node2,...>|all}
/instanceName:{<instance1,instance2,...>|all}
[/startDate:<"yyyy/mm/dd hh:mm:ss">]
[/endDate:<"yyyy/mm/dd hh:mm:ss">]
[/UTC]
[/Y]


hpcazurelog GetProxyLogs /template:<nodeTemplateName>
[/instanceName:<instance1,instance2,...>]
[/startDate:<"yyyy/mm/dd hh:mm:ss">]
[/endDate:<"yyyy/mm/dd hh:mm:ss">]
[/UTC]


hpcazurelog GetBlobLogs
/storageAccount:{<storageAccountName>:<storageKey>|<nodeTemplateName>|<storageAccountName>:<SAStoken>}
{/latest:dd|/startDate:<"yyyy/mm/dd">
[/endDate:<"yyyy/mm/dd">]}
/nodes:{proxy|all}
[/deploymentId:<deploymentID>]
[/headNode:<headNodeName>]
[/allHeadNodes]
[/localPath:<path>]
[/UTC]
[/Y]


hpcazurelog DeleteBlobLogs
/storageAccount:{<storageAccountName>:<storageKey>|<nodeTemplateName>|<storageAccountName>:<SAStoken>}
{/olderThan:dd|[/startDate:<"yyyy/mm/dd">]/endDate:<"yyyy/mm/dd">|/all}
[/deploymentId:<deploymentID>]
[/headNode:<headNodeName>]
[/allHeadNodes]
[/UTC]
[/Y]


hpcazurelog CreateBlobSAS
/storageAccount:{<storageAccountName>:<storageKey>|<nodeTemplateName>}
[/fullAccess]


hpcazurelog SetTracingLevel /template:<nodeTemplateName>
/level:{off|admin|debug}
[/Y]


hpcazurelog ListTracingLevel /template:<nodeTemplateName>


hpcazurelog GetTracingLogs
{/template:<nodeTemplateName>|/storageAccount:<nodeTemplateName>}
/outputfile:<filename>
[/deploymentId:<deploymentID>]


hpcazurelog DeleteTracingLogs
{/template:<nodeTemplateName>|/storageAccount:<nodeTemplateName>}
[/deploymentId:<deploymentID>]
[/Y]

hpcazurelog {/? | /help}

Subcommands

Subcommand

Description

hpcazurelog SetComponentTracingLevel

Sets the logging level of HPC components that are running on Windows Azure nodes that are deployed with a specified node template. If /component is not specified, the level is set for all HPC components.

hpcazurelog ListComponentTracingLevel

Lists the logging level set for HPC components that are running on Windows Azure nodes that are deployed with a specified node template. If /component is not specified, the level of all HPC components is listed.

hpcazurelog GetNodeLogs

Downloads to the current folder the log files that are stored in Windows Azure nodes that are deployed with a specified node template and are currently running. If “all” is specified for node or instance name, log files for all nodes are downloaded. If /startDate is specified, but /endDate is not specified, all files from the start date or newer are downloaded. If /UTC is not specified, dates and times are based on the local time zone.

hpcazurelog GetProxyLogs

Downloads to the current folder the log files that are stored in Windows Azure proxy nodes that are deployed with a specified node template. If an instance name is not specified, log files for all proxy nodes are downloaded. If /startDate is specified, but /endDate is not specified, all files from the start date or newer are downloaded. If /UTC is not specified, dates and times are based on the local time zone.

hpcazurelog GetBlobLogs

Downloads the log files that are stored in blob storage in the specified storage account, for the specified time period. Specify a storage account by a storage key, a node template name, or a Shared Access Signature (SAS) URL with read and write permissions for the hpclogs container. Specify either a number of past days from the current date, or a range of dates. Also specify if you want log files only for Proxy nodes or for all nodes. If /startDate is specified but /endDate is not specified, log files from the start date or later are downloaded. If /UTC is not specified, dates are based on the local time zone. If /deployment ID is specified, only the log files for that deployment are downloaded. If the name of a head node (or the name of the failover cluster, for a head node configured for high availability), is specified, only log files for that head node are downloaded. You can use /localPath to specify where the log files should be downloaded (default is the current folder).

hpcazurelog DeleteBlobLogs

Deletes the log files that are stored in blob storage in the specified storage account, for the specified time period. Specify a storage account by a storage key, a node template name, or a SAS URL with read, write, and delete permissions for the hpclogs container.

If /olderThan is specified, only log files that contain entries written earlier than the specified number of days (from the current date) are deleted. Alternatively, specify a range of dates, or specify /all to delete all log files. If /endDate is specified but /startDate is not specified, log files from the end date or older are deleted. If /UTC is not specified, dates are based on the local time zone. If the name of a head node (or the name of the failover cluster, for a head node configured for high availability), is specified, only log files for that head node are deleted.

Warning

This subcommand will delete log files in the storage account. Before deleting log files, consider downloading them by using the GetBlobLogs subcommand.

hpcazurelog CreateBlobSAS

Generates a read-only Shared Access Signature (SAS) URL, valid for 72 hours, for the hpclogs container in the specified storage account. You can then share the SAS with someone assisting you with log analysis. Specify a storage account by a storage key or a node template name. Optionally, specify /fullAccess to grant read, write, delete, and list permissions (required by some hpcazurelog commands or other tools).

hpcazurelog SetTracingLevel

Sets the logging level of HPC tracing information stored in the WADLogsTable in the storage account of an existing deployment of Windows Azure nodes with the specified node template.

hpcazurelog ListTracingLevel

Lists the current logging level set for HPC tracing information stored in the WADLogsTable in the storage account of an existing deployment of Windows Azure nodes with the specified node template.

hpcazurelog GetTracingLogs

Downloads to a specified output file the information in the WADLogsTable in the storage account of an existing deployment of Windows Azure nodes with the specified node template. If /deploymentID is specified, only the information for that deployment is downloaded.

hpcazurelog DeleteTracingLogs

Deletes the WADLogsTable in the storage account of an existing deployment of Windows Azure nodes with the specified node template.

Warning

This subcommand will delete the data and the WADLogsTable in the storage account. Before deleting the WADLogsTable, consider downloading it by using the GetTracingLogs subcommand.

hpcazurelog /?

Displays Help at the command prompt.

hpcazurelog /help

Displays Help at the command prompt.

Parameters

Parameter

Description

/all

Specifies HPC trace log files from all dates in a Windows Azure storage account. Applies only to the DeleteBlobLogs subcommand.

/allHeadNodes

Optionally specifies HPC trace log files from all head nodes in a Windows Azure storage account. Applies only to the GetBlobLogs and DeleteBlobLogs subcommands.

/component

Specifies the HPC component for managing trace log levels. Applies only to the SetComponentTracingLevel and ListComponentTracingLevel subcommands. If not specified, trace logs are managed for all HPC components.

/deploymentID

Optionally specifies a Windows Azure deployment ID for a set of Windows Azure nodes to select trace log information in Windows Azure storage. Applies only to the GetBlobLogs, DeleteBlobLogs, GetTracingLogs, and DeleteTracingLogs subcommands.

/endDate

Specifies an end date in the format yyyy/mm/dd (for GetBlobLogs and DeleteBlobLogs) or yyyy/mm/dd hh:mm:ss (for GetProxyLogs and GetNodeLogs) to select log files in Windows Azure storage by date.

/fullAccess

Specifies that the SAS URL created by the CreateBlobSAS subcommand has read, write, delete, and list permissions for the hpclogs container in a specified storage account. By default the SAS URL created by CreateBlobSAS has read-only permissions.

/headNode

Optionally specifies the name of the cluster head node or, in the case of a head node configured for high availability, the name of the failover cluster to select trace log files. Applies only to the GetBlobLogs and DeleteBlobLogs subcommands.

/instanceName

Specifies the name of one or more Windows Azure role instances for which trace logs are selected. Applies only to the GetNodeLogs and GetProxyLogs subcommands.

/latest

Specifies a number of days up to and including the current date to select log files in Windows Azure storage by date. Applies only to the GetBlobLogs subcommand.

/level

Specifies the levels of the events in HPC trace logs (if present) that are selected to be stored in Windows Azure storage. Applies only to the SetComponentTracingLevel and SetTracingLevel subcommands. The available levels are:

off

No events

admin

Selects Warning, Error, and Critical events only

debug

All: Selects Verbose, Info, Warning, Error, and Critical events

/localPath

Optionally specifies a path to download files (default is the current folder). Applies only to the GetBlobLogs subcommand.

/nodeName

Specifies the name in the HPC cluster of one or more Windows Azure nodes for which trace logs are selected. Applies only to the GetNodeLogs and GetProxyLogs subcommands.

/nodes

Specifies whether to select log files from only proxy nodes or all nodes. Applies only to the GetBlobLogs and DeleteBlobLogs subcommands.

/olderThan

Specifies a minimum number of days before the current date to select log files in Windows Azure storage by date. Applies only to the DeleteBlobLogs subcommand.

/outputFile

Specifies a path to which information in the WADSLogsTable of a specified storage account will be downloaded. Applies only to the GetTracingLogs subcommand.

/startDate

Specifies a start date in the format yyyy/mm/dd (for GetBlobLogs and DeleteBlobLogs) or yyyy/mm/dd hh:mm:ss (for GetProxyLogs and GetNodeLogs) to select log files in Windows Azure storage by date.

/storageAccount

Specifies a Windows Azure storage account that is used to store HPC trace log information or files. Applies only to the subcommands listed below. You can specify the storage account as follows:

Name of a Windows Azure node template

GetTracingLogs, DeleteTracingLogs, GetBlobLogs, DeleteBlobLogs, CreateBlobSAS

Storage account name with the storage account key, separated by “:”

GetBlobLogs, DeleteBlobLogs, CreateBlobSAS

Storage account name with a SAS URL (token) with permissions for the hpclogs container of a storage account, separated by “:”

Note

You should enclose the SAS token in double quotes.

GetBlobLogs, DeleteBlobLogs

/template

Specifies the name of a node template used for the deployment of Windows Azure nodes. Applies only to the SetComponentTracingLevel, ListComponentTracingLevel, GetNodeLogs, GetProxyLogs, SetTracingLevel, ListTracingLevel, GetTracingLogs, and DeleteTracingLogs subcommands.

/UTC

When a time period is used to select log information, optionally specifies that times and dates are in Universal Coordinated Time instead of the local time zone. Applies only to the GetNodeLogs, GetProxyLogs, GetBlobLogs, and DeleteBlobLogs subcommands.

/Y

Optionally suppresses an interactive prompt from the command and forces the command to complete. Applies only to the GetNodeLogs, GetBlobLogs, and DeleteBlobLogs, SetTracingLevel, and DeleteTracingLogs subcommands.

See Also

hpctrace