Deploying Microsoft Sentinel workbooks with Azure blueprints

Dimuthu De Silva 1 Reputation point

Dear Support,

As part of the Blueprint deployment process to deploy MS sentinel as a whole, would like to verify whether workbooks and notebooks can be included as json artefacts.
Appreciate if you could point me to any reference documentation.


Azure Blueprints
Azure Blueprints
An Azure service that provides templates for quick, repeatable creation of fully governed cloud subscriptions.
70 questions
Microsoft Sentinel
Microsoft Sentinel
A scalable, cloud-native solution for security information event management and security orchestration automated response. Previously known as Azure Sentinel.
998 questions
{count} votes

1 answer

Sort by: Most helpful
  1. JamesTran-MSFT 36,476 Reputation points Microsoft Employee

    @Dimuthu De Silva
    Thank you for your post and I apologize for the delayed response!

    I'm not too familiar with including Microsoft Sentinel Workbooks or Notebooks as Artifacts within Azure Blueprints. However, I'll do my best to point you in the right direction, and I've also reached out to our Microsoft Sentinel SMEs to see if they can share any additional inputs.

    Microsoft Sentinel Workbooks:
    After referencing the Define and assign a blueprint in the portal documentation, Azure Sentinel All In One GitHub Repo, and the Application Insights Workbooks GitHub Repo. If you're deploying your Blueprint via ARM template, from my understanding, you should be able to link or nest templates when deploying Azure resources. You can link a template by adding a deployments resource to your main template. In the templateLink property, specify the URI of the template to include.

    Azure Monitor Workbook Templates
    Because Microsoft Sentinel adopts the use of Azure Monitor Workbooks to visualize and monitor the data, you should be able to use these ARM Templates to link to your Blueprint. For more info.

    Linked template:
    Note: The following example links to a template that is in a storage account.

      "$schema": "",  
      "contentVersion": "",  
      "parameters": {},  
      "variables": {},  
      "resources": [  
          "type": "Microsoft.Resources/deployments",  
          "apiVersion": "2021-04-01",  
          "name": "linkedTemplate",  
          "properties": {  
            "mode": "Incremental",  
            "templateLink": {  
      "outputs": {  

    Additional Links:
    How to deploy Azure Sentinel ARM template using Azure Blueprints?
    Application Insights Workbooks


    Microsoft Sentinel Notebooks:
    Because Microsoft Sentinel Notebooks are run on an Azure Machine Learning (Azure ML) platform, you'll have to Create the Azure ML workspace prior to leveraging Sentinel Notebooks. Similar to Sentinel Workbooks, you should be able to link the Azure Resource Manager template to create a workspace for Azure Machine Learning to your Blueprint deployment as well.

    Once your Azure Machine Learning Workspace is created, you should be able to Set a Default ML Workspace within Microsoft Sentinel. If you have Custom Notebooks, since these are .ipynb files, you should be able to upload them to the ML Workspace directly. For more info - How to create and manage files in your workspace.

    Additional Links:
    Azure Sentinel Notebooks

    If any of these features aren't what you're looking for I'd recommend leveraging our Microsoft Sentinel User Voice forum and creating a feature request, so our engineering team can look into implementing this.

    I hope this helps!

    If you have any other questions, please let me know.
    Thank you for your time and patience throughout this issue.


    Please remember to "Accept Answer" if any answer/reply helped, so that others in the community facing similar issues can easily find the solution.

    1 person found this answer helpful.