Azure Docs: Azure Monitor Workbook (#595)

Co-authored-by: Brian Rinaldi <brian.rinaldi@gmail.com>

Author: paolosalvatori

src/content/docs/azure/services/workbook.mdx

@@ -0,0 +1,207 @@
+---
+title: "Workbook"
+description: Get started with Azure Monitor Workbooks on LocalStack
+template: doc
+---
+
+import AzureFeatureCoverage from "../../../../components/feature-coverage/AzureFeatureCoverage";
+
+## Introduction
+
+Azure Monitor Workbooks are interactive reports that combine text, KQL queries, metrics, and visualizations into a single shareable document.
+Workbook templates are Azure Resource Manager resources that package reusable definitions and gallery metadata so teams can publish templates to experiences such as Azure Monitor workbooks galleries.
+They are commonly used to create operational dashboards, cost reports, and compliance summaries that surface data from multiple Azure Monitor sources. For more information, see [Azure Workbooks overview](https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-overview).
+
+LocalStack for Azure provides a local environment for building and testing applications that make use of Azure Monitor Workbooks.
+The supported APIs are available on our [API Coverage section](#api-coverage), which provides information on the extent of Workbooks' integration with LocalStack.
+
+## Getting started
+
+This guide walks you through creating a workbook and a workbook template.
+
+Launch LocalStack using your preferred method. For more information, see [Introduction to LocalStack for Azure](/azure/getting-started/). Once the container is running, enable Azure CLI interception by running:
+
+```bash
+azlocal start-interception
+```
+
+This command points the `az` CLI away from the public Azure management REST API and toward the LocalStack for Azure emulator API.
+To revert this configuration, run:
+
+```bash
+azlocal stop-interception
+```
+
+This reconfigures the `az` CLI to send commands to the official Azure management REST API.
+
+### Create a resource group
+
+Create a resource group to hold all resources created in this guide:
+
+```bash
+az group create --name rg-workbook-demo --location westeurope
+```
+
+```bash title="Output"
+{
+  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-workbook-demo",
+  "location": "westeurope",
+  "name": "rg-workbook-demo",
+  "properties": { "provisioningState": "Succeeded" },
+  "type": "Microsoft.Resources/resourceGroups"
+}
+```
+
+### Create a workbook
+
+Generate a UUID for the workbook name, then create a shared workbook:
+
+```bash
+WORKBOOK_ID=$(python3 -c "import uuid; print(uuid.uuid4())")
+
+az monitor app-insights workbook create \
+  --name "$WORKBOOK_ID" \
+  --resource-group rg-workbook-demo \
+  --display-name "My Workbook" \
+  --kind shared \
+  --category workbook \
+  --version "Notebook/1.0" \
+  --serialized-data '{"version":"Notebook/1.0","items":[{"type":1,"content":{"json":"## My Workbook\nHello, world!"},"name":"text-0"}],"isLocked":false}' \
+  --location westeurope
+```
+
+```bash title="Output"
+{
+  "category": "workbook",
+  "displayName": "My Workbook",
+  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-workbook-demo/providers/Microsoft.Insights/workbooks/de747180-ecea-4b97-bef4-f8376fc72abe",
+  "kind": "shared",
+  "location": "westeurope",
+  "name": "de747180-ecea-4b97-bef4-f8376fc72abe",
+  "serializedData": "{\"version\":\"Notebook/1.0\",\"items\":[{\"type\":1,\"content\":{\"json\":\"## My Workbook\\nHello, world!\"},\"name\":\"text-0\"}],\"isLocked\":false}",
+  "type": "Microsoft.Insights/workbooks",
+  "version": "Notebook/1.0"
+}
+```
+
+### List workbooks
+
+List all workbooks in the resource group filtered by category:
+
+```bash
+az monitor app-insights workbook list \
+  --resource-group rg-workbook-demo \
+  --category workbook
+```
+
+```bash title="Output"
+[
+  {
+    "category": "workbook",
+    "displayName": "My Workbook",
+    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-workbook-demo/providers/Microsoft.Insights/workbooks/de747180-ecea-4b97-bef4-f8376fc72abe",
+    "kind": "shared",
+    "location": "westeurope",
+    "name": "de747180-ecea-4b97-bef4-f8376fc72abe",
+    "serializedData": "...",
+    "type": "Microsoft.Insights/workbooks",
+    "version": "Notebook/1.0"
+  }
+]
+```
+
+### Create a workbook template
+
+Workbook templates are not exposed as a first-party `az monitor app-insights` command group. Use `az rest` against the resource manager endpoint (via your active cloud, which LocalStack updates when interception is enabled):
+
+```bash
+RM=$(az cloud show --query "endpoints.resourceManager" -o tsv | sed 's|/$||')
+
+az rest --method PUT \
+  --url "${RM}/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-workbook-demo/providers/microsoft.insights/workbookTemplates/my-template?api-version=2020-11-20" \
+  --body '{
+    "location": "westeurope",
+    "properties": {
+      "priority": 1,
+      "author": "My Team",
+      "templateData": {
+        "version": "Notebook/1.0",
+        "items": []
+      },
+      "galleries": [
+        {
+          "name": "My Template",
+          "category": "General",
+          "type": "workbook",
+          "order": 100,
+          "resourceType": "Azure Monitor"
+        }
+      ]
+    }
+  }'
+```
+
+```bash title="Output"
+{
+  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-workbook-demo/providers/Microsoft.Insights/workbookTemplates/my-template",
+  "location": "westeurope",
+  "name": "my-template",
+  "properties": {
+    "author": "My Team",
+    "galleries": [
+      {
+        "category": "General",
+        "name": "My Template",
+        "order": 100,
+        "resourceType": "Azure Monitor",
+        "type": "workbook"
+      }
+    ],
+    "priority": 1,
+    "templateData": {
+      "version": "Notebook/1.0",
+      "items": []
+    }
+  },
+  "type": "Microsoft.Insights/workbookTemplates"
+}
+```
+
+### Delete resources
+
+Delete the workbook and workbook template, then delete the resource group. Use the same shell session as earlier steps so `WORKBOOK_ID` and `RM` are still set.
+
+```bash
+az monitor app-insights workbook delete \
+  --name "$WORKBOOK_ID" \
+  --resource-group rg-workbook-demo \
+  --yes
+
+az rest --method DELETE \
+  --url "${RM}/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-workbook-demo/providers/microsoft.insights/workbookTemplates/my-template?api-version=2020-11-20"
+
+az group delete --name rg-workbook-demo --yes
+```
+
+## Features
+
+- **Workbook lifecycle:** Create, read, list, update, and delete workbooks.
+- **Workbook template lifecycle:** Create, read, list, update, and delete workbook templates.
+- **Shared and private workbooks:** The [Workbooks REST API](https://learn.microsoft.com/en-us/rest/api/application-insights/workbooks/create-or-update) defines `kind` values `shared` and `user`. The Azure CLI `workbook create` command currently exposes only `--kind shared` (see [az monitor app-insights workbook create](https://learn.microsoft.com/en-us/cli/azure/monitor/app-insights/workbook#az-monitor-app-insights-workbook-create)).
+- **Category filtering:** For [list by resource group](https://learn.microsoft.com/en-us/rest/api/application-insights/workbooks/list-by-resource-group), the `category` query parameter is one of `workbook`, `TSG`, `performance`, or `retention` (the same set the CLI accepts on `workbook list --category`). The `properties.category` value stored on a workbook resource is a separate string that you set at creation time.
+- **Serialized data storage:** Store the full workbook JSON definition in the `serializedData` field.
+- **Gallery configuration:** Define workbook templates with gallery metadata for easy discovery.
+
+## Limitations
+
+- **No rendering or query execution:** The workbook content is stored as a JSON string but KQL queries within the workbook are not executed.
+- **No Azure Portal integration:** Workbooks cannot be previewed or rendered via LocalStack.
+- **No linked resource validation:** Source ID references to Application Insights components or subscriptions are accepted but not validated.
+
+## Samples
+
+Explore end-to-end examples in the [LocalStack for Azure Samples](https://github.com/localstack/localstack-azure-samples) repository.
+
+## API Coverage
+
+<AzureFeatureCoverage service="Microsoft.Insights" client:load />