feat(aks/iis): add iis-logmonitor AKS example and docs

Author: bobsira

LogMonitor/docs/README.md

@@ -0,0 +1,19 @@
+# escape=`
+FROM mcr.microsoft.com/windows/servercore:ltsc2022
+WORKDIR /LogMonitor
+COPY LogMonitorConfig.json .
+
+# NOTE: replace the version (v2.1.3) in the URL below with the latest
+# LogMonitor release or with the specific version/build you want to use.
+RUN powershell.exe -command `
+    wget `
+        -uri "https://github.com/microsoft/windows-container-tools/releases/download/v2.1.3/LogMonitor.exe" `
+        -outfile "LogMonitor.exe"
+        
+RUN powershell -Command `
+    Add-WindowsFeature Web-Server; `
+    Invoke-WebRequest -UseBasicParsing -Uri "https://github.com/microsoft/IIS.ServiceMonitor/releases/download/v2.0.1.10/ServiceMonitor.exe" -OutFile "C:\ServiceMonitor.exe"
+
+EXPOSE 80
+
+ENTRYPOINT ["C:\\LogMonitor\\LogMonitor.exe", "C:\\ServiceMonitor.exe", "w3svc"]

examples/aks/iis-logmonitor/Dockerfile

@@ -0,0 +1,29 @@
+{
+  "LogConfig": {
+    "logFormat": "json",
+    "sources": [
+      {
+        "type": "File",
+        "directory": "c:\\inetpub\\logs",
+        "filter": "*.log",
+        "includeSubdirectories": true
+      },
+      {
+        "type": "ETW",
+        "eventFormatMultiLine": false,
+        "providers": [
+          {
+            "providerName": "IIS: WWW Server",
+            "providerGuid": "3A2A4E84-4C21-4981-AE10-3FDA0D9B0F83",
+            "level": "Information"
+          },
+          {
+            "providerName": "Microsoft-Windows-IIS-Logging",
+            "providerGuid": "7E8AD27F-B271-4EA2-A783-A47BDE29143B",
+            "level": "Information"
+          }
+        ]
+      }
+    ]
+  }
+}

examples/aks/iis-logmonitor/LogMonitorConfig.json

@@ -0,0 +1,104 @@
+# Setup Guide
+
+## Prerequisites
+
+- The following tools:
+  - [_Docker desktop_](https://docs.docker.com/desktop/install/windows-install/)
+  - [_Azure CLI_](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-windows?tabs=azure-cli)
+  - Azure subscription with a few credits
+
+### Build the images
+
+- Change into the example folder (one-line or step-by-step):
+
+```powershell
+cd .\examples\aks\iis-logmonitor
+```
+
+- Build the Docker image from the Dockerfile in this folder, tag it for Docker Hub, and push:
+
+```powershell
+# build (run from examples/aks/iis-logmonitor)
+docker build -t <dockerhub-username>/iis-logmonitor:latest -f Dockerfile .
+
+# login to Docker Hub (interactive)
+docker login
+
+# push
+docker push <dockerhub-username>/iis-logmonitor:latest
+```
+
+### Create AKS Cluster
+
+> _Run all this from Powershell_
+
+- `az login` (if you have multiple subscriptions, make sure you have the right subscription set as default.)
+- cd into `ps-scripts`
+- Update `vars.txt`
+- Run `./rg-create.ps1` to create the resource group.
+- Run `./aks-create.ps1` - the script creates an AKS cluster, adds a Windows node pool and connects to the cluster.
+
+### Deploy the application
+
+```powershell
+./deploy.ps1
+```
+
+After a few minutes, check the status of the pods
+```powershell
+kubectl get pods
+NAME                            READY   STATUS    RESTARTS   AGE
+iislogmonitor-95c488777-fkhgt   1/1     Running   0          2m5s
+```
+This indicates the pod started successfully — `READY 1/1` and `STATUS Running` show the container is healthy.
+
+Check the service status and external IP, you should get something similar to:
+
+```powershell
+# NAME            TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)        AGE
+# kubernetes      ClusterIP      10.0.0.1      <none>          443/TCP        36m
+# iislogmonitor   LoadBalancer   10.0.191.38   52.188.177.226  80:31349/TCP   2m19s
+```
+
+Access the app using the `http://EXTERNAL-IP` shown in the output, for example:`http://52.188.177.226`
+
+```powershell
+Start-Process "http://52.188.177.226"
+```
+To stream the container logs from that pod, run:
+
+```powershell
+kubectl logs -f iislogmonitor-95c488777-fkhgt
+```
+
+### Configure Azure Monitor (Container Insights)
+
+You can enable AKS monitoring (Container Insights) from the Azure portal. Open the following onboarding view and follow the steps to enable monitoring for this cluster (select or create a Log Analytics workspace, then enable):
+
+After onboarding completes you can view container logs, metrics and insights in Azure Monitor > Container insights for the cluster.
+
+To query container logs (Log Analytics) for IIS entries you can run a KQL query in the Log Analytics `Logs` view. Example:
+
+```kql
+// Find In ContainerLogV2
+ContainerLogV2
+| where LogMessage contains "W3SVC"
+```
+
+This returns container log entries that include IIS/W3SVC messages collected by Container Insights.
+
+The screenshots below show the Azure Monitor onboarding and Log Analytics views for this example.
+
+![iis1.png](images/iis1.png)
+
+![iis2.png](images/iis2.png)
+
+![iis3.png](images/iis3.png)
+
+![iis4.png](images/iis4.png)
+
+![iis5.png](images/iis5.png)
+
+### Clean-up
+
+Clean up by deleting the resource group, in `ps-scripts`, run: `./clean-up.ps1`