Configure automatic Azure Stack diagnostic log collection

Applies to: Azure Stack integrated systems

We recommend configuring the automatic diagnostic log collection feature to streamline your log collection and customer support experience. If system health conditions need to be investigated, the logs can be uploaded automatically for analysis by Microsoft Customer Support Services (CSS).

Create an Azure blob container SAS URL

Before you can configure automatic log collection, you'll need to get a shared access signature (SAS) for a blob container. A SAS lets you grant access to resources in your storage account without sharing your account keys. You can save Azure Stack log files to a blob container in Azure, and then provide the SAS URL where CSS can collect the logs.

Prerequisites

You can use a new or existing blob container in Azure. To create a blob container in Azure, you need at least the storage blob contributor role or the specific permission. Global administrators also have the necessary permission.

For best practices about choosing parameters for the automatic log collection storage account, see Best practices for automatic Azure Stack log collection. For more information about types of storage accounts, see Azure storage account overview

Create a blob storage account

  1. Sign in to the Azure portal.

  2. Click Storage accounts > Add.

  3. Create a blob container with these settings:

    • Subscription: Choose your Azure subscription
    • Resource group: Specify a resource group
    • Storage account name: Specify a unique storage account name
    • Location: Choose a datacenter in accordance with your company policy
    • Performance: Choose Standard
    • Account kind Choose StorageV2 (general purpose v2)
    • Replication: Choose Locally-redundant storage (LRS)
    • Access tier: Choose Cool

    Screenshot showing the blob container properties

  4. Click Review + create and then click Create.

Create a blob container

  1. After the deployment succeeds, click Go to resource. You can also pin the storage account to the Dashboard for easy access.
  2. Click Storage Explorer (preview), right-click Blob containers, and click Create blob container.
  3. Enter a name for the new container and click OK.

Create a SAS URL

  1. Right-click the container, click Get Shared Access Signature.

    Screenshot showing how to get the shared access signature of a blob container

  2. Choose these properties:

    • Start time: You can optionally move the start time back
    • Expiry time: Two years
    • Time zone: UTC
    • Permissions: Read, Write, and List

    Screenshot showing shared access signature properties

  3. Click Create.

Copy the URL and enter it when you configure automatic log collection. For more information about SAS URLs, see Using shared access signatures (SAS).

Steps to configure automatic log collection

Follow these steps to add the SAS URL to the log collection UI:

  1. Sign in to the Azure Stack administrator portal.

  2. Open Help and support Overview.

  3. Click Automatic collection settings.

    Screenshot shows where to enable log collection in Help and support

  4. Set Automatic log collection to Enabled.

  5. Enter the shared access signature (SAS) URL of the storage account blob container.

    Screenshot shows blob SAS URL

Note

Automatic log collection can be disabled and re-enabled anytime. The SAS URL configuration won't change. If automatic log collection is re-enabled, the previously entered SAS URL will undergo the same validation checks, and an expired SAS URL will be rejected.

View log collection

The history of logs collected from Azure Stack appears on the Log collection page in Help and Support, with the following dates and times:

  • Collection time: When the log collection operation began
  • From Date: Start of the time period for which you want to collect
  • To Date: End of the time period

Screenshot shows log collections

If diagnostic log collection fails, verify the SAS URL is valid. If failure persists or you see multiple failures, call Microsoft CSS for help.

Operators can also check the storage account for automatically collected logs. For example, this screenshot shows log collections by using the Storage Explorer preview from the Azure portal:

Screenshot shows log collections

Automatic diagnostic log collection alerts

If enabled, automatic diagnostic log collection occurs only when necessary. Only the alerts in the following table trigger collection.

For example, Update failed is an alert that triggers automatic diagnostic log collection. If automatic collection is enabled, diagnostic logs will be proactively captured during an update failure to help CSS troubleshoot the problem. The diagnostic logs are only collected when the alert for Update failed is raised.

Alert Title FaultIdType
Unable to connect to the remote service UsageBridge.NetworkError
Update failed Urp.UpdateFailure
Storage Resource Provider infrastructure/dependencies not available StorageResourceProviderDependencyUnavailable
Node not connected to controller ServerHostNotConnectedToController
Route publication failure SlbMuxRoutePublicationFailure
Storage Resource Provider internal data store unavailable StorageResourceProvider. DataStoreConnectionFail
Storage device failure Microsoft.Health.FaultType.VirtualDisks.Detached
Health controller cannot access storage account Microsoft.Health.FaultType.StorageError
Connectivity to a physical disk has been lost Microsoft.Health.FaultType.PhysicalDisk.LostCommunication
The blob service isn't running on a node StorageService.The.blob.service.is.not.running.on.a.node-Critical
Infrastructure role unhealthy Microsoft.Health.FaultType.GenericExceptionFault
Table service errors StorageService.Table.service.errors-Critical
A file share is over 80% utilized Microsoft.Health.FaultType.FileShare.Capacity.Warning.Infra
Scale unit node is offline FRP.Heartbeat.PhysicalNode
Infrastructure role instance unavailable FRP.Heartbeat.InfraVM
Infrastructure role instance unavailable FRP.Heartbeat.NonHaVm
The infrastructure role, Directory Management, has reported time synchronization errors DirectoryServiceTimeSynchronizationError
Pending external certificate expiration CertificateExpiration.ExternalCert.Warning
Pending external certificate expiration CertificateExpiration.ExternalCert.Critical
Unable to provision virtual machines for specific class and size due to low memory capacity AzureStack.ComputeController.VmCreationFailure.LowMemory
Node inaccessible for virtual machine placement AzureStack.ComputeController.HostUnresponsive
Backup failed AzureStack.BackupController.BackupFailedGeneralFault
The scheduled backup was skipped due to a conflict with failed operations AzureStack.BackupController.BackupSkippedWithFailedOperationFault

See also

Azure Stack log and customer data handling

Using shared access signatures (SAS)

Best practices for automatic Azure Stack log collection