---
title: "Usage Logs"
slug: "usage-logs"
description: "Usage logs provide information on minute-by-minute logs of Flow executions, API calls, job executions, etc. of the Primary instance. This information is in turn used to see the memory usage and what is using the memory in the system. This document shows users where to view these logs, and how to understand them. "
updated: 2024-08-20T15:25:49Z
published: 2024-08-20T15:25:49Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage Logs

## Overview

**Usage Logs** provide information on minute-by-minute Logs of Flow Executions, API calls, Job Executions, etc. of the Primary Instance. This information is used to see how much memory is being used and what is executing and using that memory. Each time frame in the Usage Log shows the different Decision Entities that are being executed and the corresponding amount of memory usage. The following document discusses how to access and view these Usage Logs and the columns found within them.

---

## Location

Usage logs can be found at **C:\Program Files\Decisions\Decisions Server\Logs.**They are called**"Primary.shmcc".**

**![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-01-13_16h13_56.png)**

---

## Example

The image below exemplifies how **Usage****Logs**look in different programs.

Users can use any text editor/google excel to view this file. The images below are on Notepad++ and Google excels view; these represent the same file.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2020-01-31_14h17_36.png)

## ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2020-01-31_15h14_10.png)

---

## Categories

Below is a table that describes the columns within a **Usage Log**file.

| **Column Name** | **Description** |
| --- | --- |
| **WHEN** | Time Frame for the recorded period. |
| **CPU** | The current amount of CPU used. |
| **Flow Start** | The number of topmost Flows started. This count does NOT include Sub Flows that are called from the Parent Flow unless it is called via the Async Linked Flow step which causes them to essentially be topmost Flows themselves. Sub flows are counted as FlowStepStarts. |
| **Flow Step Start** | The number of steps executed in the topmost Flows and all steps in any Sub Flows that are called (regardless of if they are called Sync or Async).**** |
| **API Calls** | The number of API calls made between specified Time. Internal API Calls that are made from UI to SHM are also included in this count. Includes any API calls (generated rest and web service steps, custom coded steps that call APIs)**** |
| **Rule Executions** | The number of Rule Executions that were executed between the specified Time.**** |
| **Job Starts** | The number of Scheduled Jobs that started between the specified Time. This also includes background Jobs that run in Decisions.**** |
| **Thread Job Start** | These are used internally to run procedures. The Amount started between a specified Time.**** |
| **AllocatedMemory** | Memory allocated for processing between specified Time; Currently allocated memory. |
| **Used Memory** | Actual memory usage between specified Time; currently used memory.**** |
| **User Count** | The number of users logged into Decisions between specified Time; Currently Active Sessions. |

---

## Primary.UsageDetails

As an additional method/tool used for troubleshooting **Server**performance issues, the **Logs**Folder provides both the **Primary.UseDetails** and **Primary.Usage.CSV** files. The following files function as such:

- Primary.Usage.CSV file shows execution counts in the form of a spreadsheet, displaying **When**(**Date/Time**) the execution occurs, Count for each **Type****,**and the****amount of**CPU** used.  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-05-05_13h15_36.png)

- Primary.UsageDetails breaks down each execution by displaying the Type of execution, its **N****ame**, its Count, along with the Date/Time execution occurred. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2021-05-05_13h32_10.png)