Edit

Troubleshoot: Failure to connect to a cluster in Azure Data Explorer

  • Article

If you're not able to connect to a cluster in Azure Data Explorer, follow these steps.

  1. Ensure the connection string is correct. It should be in the form: https://<ClusterName>.<Region>.kusto.windows.net, such as the following example: https://docscluster.westus.kusto.windows.net.

  2. Ensure you have adequate permissions. If you don't, you'll get a response of unauthorized.

    For more information about permissions, see Manage database permissions. If necessary, work with your cluster administrator so they can add you to the appropriate role.

  3. If you are connecting from an external tenant, ensure the cluster has correct permissions.

    For more information about cross tenant scenarios, see Allow cross-tenant queries and commands.

  4. Verify that the cluster hasn't been deleted: review the activity log in your subscription.

  5. Check the Azure service health dashboard. Look for the status of Azure Data Explorer in the region where you're trying to connect to a cluster.

    If the status isn't Good (green check mark), try connecting to the cluster after the status improves.

  6. If you still need assistance solving your issue, please open a support request in the Azure portal.