hpcazurelog
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. Caution: 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. Caution: 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 “:” - GetBlobLogs, DeleteBlobLogs Note: You should enclose the SAS token in double quotes. |
| /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. |