windowsWindows

Monitor IIS runtime traffic by installing the Alma Windows Sensor.

Deploy Alma on Windows to monitor IIS runtime traffic with zero app code changes.

The Alma Windows Sensor instruments IIS and exports telemetry to your Alma collector endpoint.

If you’re new to Alma, start with Alma Overview.

Prerequisites

  • Ensure outbound TCP port 4317 is open (gRPC).

  • Confirm outbound firewall rules allow egress from:

    • the Windows host

    • your cloud/network perimeter (if applicable)

  • Local admin access on the Windows host.

Install

1

1) Extract the sensor files

Unzip the package and place these files in one folder:

  • AlmaWindowsSensor.psm1

  • AlmaSensor.dll

2

2) Open PowerShell as Administrator

Open an elevated PowerShell session.

Then cd into the folder that contains the extracted files.

3

3) Import the module

Import-Module .\AlmaWindowsSensor.psm1 -Force
4

4) Install the sensor

Install-AlmaSensor
5

5) Register the sensor

Register-Sensor

You will be prompted for:

  • Alma collector endpoint

  • Service name suffix

  • SSL verification option

PowerShell output for Install-AlmaSensor and Register-Sensor, showing the interactive prompts.
Example output for installation + registration prompts.
6

6) Instrument IIS

Instrument all IIS sites:

Enable-GlobalInstrumentation

Instrument a single site:

Enable-WebsiteInstrumentation -WebsiteName "YourSiteName"
circle-exclamation
PowerShell output for Enable-GlobalInstrumentation.
Example output for global IIS instrumentation.
7

7) Verify installation

Check IIS Manager → Modules for AlmaWindowsSensor.

Or run:

Show-AlmaSensorStatus
PowerShell output for Show-AlmaSensorStatus.
Example output for Show-AlmaSensorStatus.
IIS Manager showing Modules with AlmaWindowsSensor installed.
IIS Manager → Modules showing AlmaWindowsSensor.
8

8) Uninstall (if needed)

Run in PowerShell as Administrator:

Disable-GlobalInstrumentation
Unregister-Sensor
Uninstall-AlmaSensor

Last updated