WMI Adapter

You are here:

Overview

This adapter collects values of Windows performance counters when enabled in Sonar monitoring agent for following scenarios with Windows OS version 2008 R2 or above:

  • Servers
  • Windows containers with Hyper-v or process isolation
  • Virtual machines

Configuration

This adapter can be configured in two ways: legacy using Server element and just connection string. To configure adapter, modify Sonar configuration file as follows:

XML
sonar.config

Configuring WinRM

The access to WS-Management endpoint can be enabled using HTTPS or HTTP protocols. Sonar monitoring agent can gather metrics via WS-Management protocol locally or remotely. For development on Windows container, virtual machine or host, execute the following commands from PowerShell:

Shell

HTTP

To allow access to WinRM listener via HTTP, execute the following command from PowerShell and then modify Sonar.config:

Shell
XML
sonar.config(fragment)

HTTPS

To allow access via HTTPS, create X509 certificate, configure WinRM listener and then use Sonar with HTTPS endpoint:

Shell
XML
sonar.config(fragment)

Note that using Negotiate authentication will require Sonar process running under credentials with sufficient permissions to access WinRM listener. For remote access from Sonar deployed on Linux container, VM or host without  integration with Active Directory, Basic authentication can be used by modifying Sonar.config as follows:   

XML
sonar.config(fragment)

To enable Basic authentication for WinRM, execute following command from console or PowerShell on Windows:

Shell

Last Updated On February 24, 2019