Configure processes metrics

task brazil Updated Sep 10, 2026 1 min read configure-processes-metrics-mecm.md

Configure the top processes by CPU and top processes by memory metrics for Microsoft Endpoint Configuration Manager for Investigation.

About this task

Important:

Starting with the Brazil release, Microsoft Endpoint Configuration Manager for Investigation is being prepared for future deprecation. It will be hidden and no longer installed on new instances but will continue to be supported. For details, see the Deprecation Process [KB0867184] article in the Now Support Knowledge Base.

Before you begin

Role required: sn_cimaf.sn_cimaf_admin

Procedure

Open the Microsoft Endpoint Configuration Manager.
Create a MECM script with the name GetProcess.

For more information, see Create a script in Microsoft Endpoint Configuration Manager.

Provide the following code in the script block.

PowerShell

Param([Parameter(Mandatory=$True)][string]$orderBy,[Parameter(Mandatory=$True)][string]$top)
$processes = get-process
$Total = 0;ForEach ($process in $processes) {    $Total += $process.cpu;}
$processes | Sort-Object $orderBy -Descending | select processname,id,ws,cpu -First $top | select processname,id, @{l="mem"; e={$_.ws}}, @{l="cpu"; e={($_.cpu / $Total) * 100}};

Retrieve and copy the script GUID.
Open the MECM Adapter Configuration [sn_mecm_adapter_config] table.

The MECM Adapter Configuration table displays the list of adapter configurations.
From the list of configurations, select and edit Running processes - CPU%.
In the Action input field, add the script GUID.

[Omitted image "edit-cpu-config.png"] Alt text: Edit running processes CPU
Select Save.
From the list of configurations, select and edit Running processes - MEM.
In the Action input field, add the script GUID.
Select Save.

Result

The top processes by CPU and top processes by memory metrics are displayed on the Investigation tab of the incident record in Service Operations Workspace.

Parent Topic:Configuring CI metrics for Microsoft Endpoint Configuration Manager for Investigation

85 lines · 3.4 KB Wrap lines

---
title: Configure processes metrics
description: Configure the top processes by CPU and top processes by memory metrics for Microsoft Endpoint Configuration Manager for Investigation.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/it-service-management/service-operations-workspace/configure-processes-metrics-mecm.html
release: brazil
product: Service Operations Workspace
classification: service-operations-workspace
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Configuring CI metrics for MECM, Setting up Investigation Framework using Microsoft Endpoint Configuration Manager for Investigation, Setting up Investigation Framework in Service Operations Workspace, Setting up integrations in Service Operations Workspace for ITSM, Configuring Service Operations Workspace for ITSM, Service Operations Workspace for ITSM, IT Service Management]
---

# Configure processes metrics

Configure the top processes by CPU and top processes by memory metrics for Microsoft Endpoint Configuration Manager for Investigation.

## About this task

**Important:**

Starting with the Brazil release, Microsoft Endpoint Configuration Manager for Investigation is being prepared for future deprecation. It will be hidden and no longer installed on new instances but will continue to be supported. For details, see the [Deprecation Process \[KB0867184\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) article in the Now Support Knowledge Base.

## Before you begin

Role required: sn\_cimaf.sn\_cimaf\_admin

## Procedure

1.  Open the Microsoft Endpoint Configuration Manager.

2.  Create a MECM script with the name `GetProcess`.

    For more information, see [Create a script in Microsoft Endpoint Configuration Manager](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/service-operations-workspace/create-mecm-script.md).

3.  Provide the following code in the script block.

    ```
    Param(
    [Parameter(Mandatory=$True)]
    [string]$orderBy,
    [Parameter(Mandatory=$True)]
    [string]$top
    )
    
    $processes = get-process
    
    $Total = 0;
    ForEach ($process in $processes) {
        $Total += $process.cpu;
    }
    
    $processes | Sort-Object $orderBy -Descending | select processname,id,ws,cpu -First $top | select processname,id, @{l="mem"; e={$_.ws}}, @{l="cpu"; e={($_.cpu / $Total) * 100}};
    
    ```

4.  Retrieve and copy the script GUID.

5.  Open the MECM Adapter Configuration \[sn\_mecm\_adapter\_config\] table.

    The MECM Adapter Configuration table displays the list of adapter configurations.

6.  From the list of configurations, select and edit **Running processes - CPU%**.

7.  In the **Action input** field, add the script GUID.

    \[Omitted image "edit-cpu-config.png"\] Alt text: Edit running processes CPU

8.  Select **Save**.

9.  From the list of configurations, select and edit **Running processes - MEM**.

10. In the **Action input** field, add the script GUID.

11. Select **Save**.


## Result

The top processes by CPU and top processes by memory metrics are displayed on the **Investigation** tab of the incident record in Service Operations Workspace.

**Parent Topic:**[Configuring CI metrics for Microsoft Endpoint Configuration Manager for Investigation](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/service-operations-workspace/config-ci-metrics-mecm-adapter.md)