Introduction
This article details log files and locations that are used within FlexNet Manager Suite. Information about beacon and agent logging is also applicable to these components when used in a Flexera One ITAM environment.
If you see a log file that you're not expecting or are having trouble finding a log file on a particular computer, make sure you have considered the following key points:
- The web, batch, and inventory server components may be installed all on one server or installed across two, three, or more servers.
- It's possible to install beacon components on the batch server.
- Some components and associated logs are shared between the beacon and inventory agent. Shared components are fully detailed below.
- The inventory agent components may be installed on any of the servers.
Application and beacon server logging
Logging location
The default logging base directory containing both configuration and log files for FlexNet Manager Suite application and beacon server components is C:\ProgramData\Flexera Software\Compliance\Logging\.
This default base directory may be changed by setting the following registry entry: HKLM\SOFTWARE\WOW6432Node\ManageSoft Corp\ManageSoft\Compliance\CurrentVersion\LoggingBaseDirectory.
Logging configuration
Logging for most application and beacon server components is configured in configuration files named *.config stored in the logging base directory. These configuration files can be edited using a text editor to adjust the logging level and other details.
The specific details in these configuration files depend on the version of FlexNet Manager Suite in use.
FlexNet Manager Suite 2022 R2 and newer
The NLog logging framework is used with these versions of FlexNet Manager Suite. The logging configuration files store Nlog configuration settings.
See the following FlexNet Manager Suite online help page for guidance on configuring logging levels: Configure logging levels with Nlog.
FlexNet Manager Suite 2022 R1 and older
The log4net logging framework is used with these versions of FlexNet Manager Suite. The logging configuration files store log4net configuration settings.
The minimum logging level used by a component can be configured by opening the relevant configuration file, finding the <root> element, and adjusting the <level value="INFO"/> line to the desired logging level. Typical logging levels are ERROR, WARN, INFO, and DEBUG.
Logging from application server components
The following table provides default logging configuration details for various application server components and subsystems.
| Component / Subsystem | Location under C:\ProgramData\Flexera Software\Compliance\Logging | Application server type(s) |
|---|---|---|
|
Web UI Events from core parts of the web interface. Typically contains details from red error bars that appear in the UI with an error ID in the log matching the ID shown in the UI. | WebUI\WebUI.log | Web |
|
Batch processor service Events from the "FlexNet Manager Suite Batch Processor" Windows service. The batch processor service receives jobs from the scheduler, runs the job and then sends a message to indicate success back to the scheduler. This log shows details of tasks being run by the batch processor, including what command line is used to launch the task. |
BatchProcessScheduler\ BatchProcessor.log | Batch |
|
Batch process scheduler service Events from the "FlexNet Manager Suite Batch Process Scheduler" Windows service. The scheduler service picks up messages from Microsoft Message Queue queues to trigger tasks add tasks to a queue, and then sends the tasks to the batch processor service for processing. Logging shows when a task is received and sent for processing and when the batch processor indicates the task has been completed. |
BatchProcessScheduler\ BatchProcessScheduler.log | Batch |
|
Batch process task execution Events from the BatchProcessTask*.exe executables. Rarely useful but should be checked when troubleshooting batch processor issues. Logs when a task is queued with the batch processor and also logs the output when you run BatchProcessTaskConsole.exe manually to list tasks. |
BatchProcessTask\ BatchProcessTask.log | Batch |
|
Compliance import Import of inventory from data sources into the compliance database and license reconcile operations. The compliance import process can create folders on the batch server with a GUID name and containing an import log file. These log folders and files are normally deleted before the associated import process completes. However, sometimes this cleanup is not performed (like when an import is terminated prematurely), and the folder is left behind. It is generally safe to delete such folders if they're about seven days old or more. |
ComplianceReader\ importer-[ddmmyyyy]-[pid].log <GUID>\ importer-[ddmmyyyy]-[pid].log | Batch |
|
Beacon services Logs events relating to beacons that report to this server (through the inventory-beacons virtual directory in IIS). Not to be confused with logging from locally installed beacon components. Some examples of information captured in these logs are:
|
InventoryBeacons\ | Batch |
|
Content library updates (2018 R2 and later) Logging from content library update processes. Details the steps taken to download and update content. |
Content\mgsImportRecognition.log, recognition.log and importPURL.log | Batch |
|
Content library updates (prior to 2018 R2) Log files for library update processes are stored in the %TEMP% folder of the user who launched MgsImportRecognition.exe. To determine where logs will be stored, identify which user account launched the MgsImportRecognition.exe process. If the library update has been triggered by the scheduled task on the batch server, this will typically be the account used to run the "FlexNet Manager Suite Batch Processor" Windows service. If MgsImportRecognition.exe is executed manually, then the log will be in the temp folder of the running user. |
C:\Windows\Temp for processes invoked using the SYSTEM identity OR %TEMP% of the service account | Batch |
|
Web resolver dispatcher This log captures events from the web resolvers about the import into the database of various data files that are uploaded from beacons. The most common types of files processed include ActionStatus, ActiveDirectory, ActivityStatus, BeaconStatus, ClientAccess, Discovery, Inventories, Logs, and Usage Data. This does not include uploads of third-party inventory (like SCCM) or business adapter imports. |
WebResolvers\dispatcher.log | Inventory |
|
Web resolver activity status Similar to the dispatcher log, this log captures events from the web resolver about the import of information into the database. This log is specifically for .activity files. Activity files form a lot of the information you see on the System Tasks page in the UI. If you're troubleshooting a problem with the System Tasks page, this log may be useful. |
WebResolvers\activitystatus.log | Inventory |
|
Beacon status Similar to the dispatcher log, this log captures events from the web resolver about the import of information into the database. This log is specifically for .bstat files. |
WebResolvers\beaconstatus.log | Inventory |
|
FlexNet Manager Suite precalc data maintenance This log captures events related to maintenance of precalculated data for display in the web UI. |
Maintenance\Maintenance.log | Batch |
|
FlexNet Manager Suite to ServiceNow Export logs The path for this log file is configured in the file <InstallDir>\DotNet\bin\ ServiceNowExport\ fnmp_servicenow_export.exe.config. |
C:\Temp\Log\log.log | |
|
SAP reader Captures information about the import of SAP inventory. On the batch server, generally, a zip file containing SAP inventory is uploaded from a beacon, which is then unzipped and imported into the FlexNet Manager Suite database. Be sure to also check SAPReader.log on the beacon. |
SAPReader\SAPReader.log | Batch |
|
SAP reconciliation Logging from the batch process that recalculates a SAP license position. | SAPReconciliation\ SAPReconciliation.log | Batch |
|
SAP portal Events from the SAP Portal UI. | SAPPortalUI\SAPPortalUI.log | Web |
|
Single sign-on SAML or OAuth 2.0 single sign-on (SSO) logging. Logging related to requests to the identity provider can be used in conjunction with the WebUI log for troubleshooting SSO issues. | OAuth\sso.log | Web |
|
Compliance API Logging from an internal SOAP web API service. This web service is used for various integrations between Flexera products. | FNMSWebAPI\fnmswebapi.log | Web |
|
Baseline imports Logs from baseline purchase import operations. |
BaselineImport\<GUID>\ BaselinePurchaseCreation.log | Batch |
|
Business data imports Logs from business adapter imports. Typically, a business adapter will run on a beacon, which will read information from the source and create a zip file with the data, which is uploaded to the batch server. Then the batch server unzips this file and processes the information into the compliance database. Be sure to check beacon logs when troubleshooting business adapters. |
BatchDataImport\ BusinessImport.log [AdapterName]-[GUID].log | Batch |
|
Shadow host process launcher Instead of the batch processor launching executables directly, it actually launches ShadowHost.exe, which launches the target executables. This logging captures information from ShadowHost processes. Examples of tasks captured include:
ShadowHost logging also enables some interesting logging from both batch process services. For example, you can see database queries made by these services. TIP: ShadowHost logging can be enabled by adding a new DWORD registry entry HKLM\SOFTWARE\WOW6432Node\ ManageSoft Corp\ManageSoft\Compliance\ CurrentVersion\ ShadowHostTracingEnabled with the value "1". |
ShadowHost\*.log | All |
|
Cognos package import Importing the Cognos/Flexera Analytics package is a one-off configuration task. Results are logged in this file. |
CognosPackageImport\ CognosPackageImport.log | Batch |
Logging from beacon server components
The following table provides default logging configuration details for various beacon server components and subsystems.
| Component / Subsystem |
Location under C:\ProgramData\Flexera Software\Compliance\Logging |
|---|---|
|
Active Directory import This log captures the execution of Active Directory imports which are configured on the Active Directory Imports page in the Beacon UI. This log captures the LDAP connection being established with the domain controller and the import of Active Directory information. The import produces an .actdir file which is uploaded to the inventory server. Be sure to also check the Dispatcher log on the inventory server to make sure the data is successfully processed into the database. |
ActiveDirectoryImport\ ADImport.log |
|
Beacon engine service This log captures events from the Beacon Engine Service. This is one of the main log files on a beacon server and captures information about a lot of the background activities performed by a beacon. An example of some of the main events that are captured include downloading and loading beacon policy, downloading updates to discovery and inventory rules, downloading discovery export files, and downloading updated importer XML files. |
BeaconEngine\ BeaconEngine.log |
|
Beacon IIS app Captures events from the beacon's web server component. The beacon web server generates and serves agent policy, settings, and upgrade files and accepts incoming files from agents. |
BeaconIIS\ BeaconIIS.log |
|
Compliance Reader logs Captures the import of inventory from a data source into the FNMSCompliance database (compliance import) and the license reconcile. This log file tracks several different processes. The most important one is the reconciliation. Each process will be contained in its own log file. To see the configured imports on a beacon, you can look at the Inventory Systems page in the Beacon UI. |
ComplianceReader\importer-[ddmmyyyy]-[pid].log |
|
Compliance upload Logs events about the upload of inventory extracted from external databases and business adapter data. ComplianceUpload.exe is launched by the "Upload third party inventory data" scheduled task. This process does not include the upload of files received from FlexNet inventory agents (such as inventory NDI files and others). |
ComplianceUpload\ upload.log |
|
Discovery and inventory rules Logs events from the execution of Discovery & Inventory rules. You can see the configured rules in the Beacon UI on the Rules page. Each rule execution will generate a new GUID (the task's unique SessionUID) which is used in the directory path when storing the log files. TIP: When troubleshooting, sort the InventoryRule logging folder by the last modified date to find the most recently created folder after triggering rule execution manually in the Beacon UI. | InventoryRule\<GUID>\*.log |
|
Inventory Beacon UI and processes Captures events from the BeaconUI and various other tasks performed by the local inventory beacon. The BeaconEngine.log will generally be the main log to look at when troubleshooting a beacon, but it's worth checking this too. |
InventoryBeacon\ inventorybeacon.log |
|
Package retriever Downloads of upgrade and adoption packages. Log file location configured through the registry entry: HKLM\SOFTWARE\WOW6432Node\ManageSoft Corp\ManageSoft\PackageRetriever\CurrentVersion\LogFile |
%TEMP%\ManageSoft\ packageretriever.log %TEMP% is the temporary directory of the user running the process or C:\WINDOWS\Temp for SYSTEM-run processes. |
The beacon also shares a number of components with the agent. See the FlexNet inventory agent logging section below for details of logging from these components.
Other server logging
Internet Information Services logs
Internet Information Services (IIS) logs all incoming and outgoing web requests. The logs show the resource that was requested, the requestor IP, the HTTP status code, etc. See ASP.NET : Troubleshooting Applications with IIS Logs for more information.
Location: Typically %SystemDrive%\inetpub\logs\LogFiles\W3SVC1\u_ex[yymmdd].log
The location can be configured by navigating to the Default Web Site node in IIS Manager, then double click on Logging on the right page.
Windows Event Viewer
Various components involved in the operation of the FlexNet Manager Suite system create entries in Windows Event Viewer, which can be relevant and helpful for troubleshooting.
FlexNet inventory agent logging
Logging location
FlexNet inventory agent logs are typically stored at:
- On Windows: C:\Windows\Temp\ManageSoft for processes invoked using the SYSTEM identity, or C:\Users\<username>\AppData\Local\Temp\ManageSoft for processes invoked as a named user
TIP: When connecting to a computer using a remote desktop, watch out for temporary session folders that may contain logs, for example, C:\Users\TonyM\AppData\Local\Temp\6\ManageSoft. RDP generates a temporary session folder by default for %TEMP%. Make sure you are looking at the correct log by checking the timestamps.
- On Unix-like operating systems:
- /var/opt/managesoft/log (for processes executed by an installed agent)
- /var/tmp/flexera*/log (for processes executed by the inventory scanner or zero-touch inventory gathering)
Logging configuration
Agent log file locations can be overridden by specifying the LogFile agent preference for different agent components.
On Windows:
- These preferences are stored in the registry under HKLM\SOFTWARE\WOW6432Node\ManageSoft Corp\ManageSoft\<Component>\CurrentVersion.
- LogFile preference values usually include a reference to a variable like $(TempDirectory), which expands to the system temporary directory for the user that the associated process is running as. This is why you may see the location of files change depending on the user who ran a process. Under normal operating conditions, agent processes typically run as the local SYSTEM account whose $(TempDirectory) is C:\Windows\Temp. When an agent process is invoked manually, it will run as your own user account.
On Unix-like operating systems:
- The preferences are stored in a virtual registry in the /var/opt/managesoft/etc/config.ini file.
Logging from inventory agent components
The following table provides default logging configuration details for various inventory agent components.
| Component | Log file |
|---|---|
|
Inventory (ndtrack.exe) Captures events from the inventory gathering process, including hardware and software inventory details. | tracker.log |
|
Inventory (flxfsscan- Unix-like operating systems) Captures events related to scanning the filesystem on Unix-like operating systems during the inventory gathering process. Applies to agent versions 2023 R1 (20.1) and newer. | flxfsscan.log |
|
Inventory (flxoracleinv- Unix-like operating systems) Captures events related to gathering data related to various products related to Oracle Database on Unix-like operating systems during the inventory gathering process. Applies to agent versions 2023 R1 (20.1) and newer. | flxoracleinv.log |
|
Inventory (ndtrack - Unix-like operating systems) Captures events from the inventory gathering process executed at the time the FlexNet inventory agent is initially installed. | mgs1-tracker.log |
|
Configuration (flxconfig.exe) Captures events relating to the agent downloading and applying configuration details such as client settings, schedule, failover settings, and update packages. Applies to agent versions 2024 R1.2 (22.2) and newer. | agent_configuration.log |
|
Installation (ndlaunch.exe) Captures events relating to the agent downloading and applying policy, client settings, schedule, failover settings, and update packages. Applies to agent versions 2024 R1.1 (22.1) and earlier. |
installation.log |
|
Policy (mgspolicy.exe) Log file for the download and application of agent policy. Applies to agent versions 2024 R1.1 (22.1) and earlier. | policy.log |
|
Scheduling (ndschedag.exe) Log file for the application and execution of agent schedule events. | schedule.log |
|
Security service (mgssecsvc.exe) Captures events from the "Flexera Inventory Manager security service" Windows Service. This service has two plugins: the usage agent and the VDI endpoint plugin. NOTE: This log file is difficult to relocate and has no registry preference. Configuration may be possible with a configuration file alongside mgssecsvc.exe. |
securityservice.log |
|
Upload (ndupload.exe) Captures events from the ndupload process, which are used to upload all types of files that can generated by the agent. Upload logging associated with an inventory gathering (ndtrack) process appears in the tracker log. If an upload by the tracker process fails, logging from subsequent upload attempts of the same inventory file will appear in the upload agent log. The upload agent is heavily used by beacons as well as managed devices. Inspecting upload agent logs on beacons is often useful for troubleshooting upload problems. |
uploader.log |
|
Docker monitor (fnms-docker-monitor.exe) Monitors Docker to identify containers from which inventory should be gathered. NOTE: The path and filename of this log file cannot be modified from its default value. |
fnms-docker-monitor.log |
|
Podman monitor (fnms-podman-monitor.exe) Monitors Podman to identify containers from which inventory should be gathered. Applies to agent versions 2024 R2 (23.0) and newer. |
fnms-podman-monitor.log |
|
Usage Captures events from the usage agent which meters running applications. The usage agent runs under the "Flexera Inventory Manager security service" Windows service. |
usageagent.log |
|
VDI Captures events from the VDI endpoint agent. Only relevant on Citrix XenDesktop devices (Windows only). |
vdi.log |
Other specialized agent logs
Adoption logs
Logging from the initial installation of an agent when a device is being adopted through execution of a Discovery & Inventory rule. Adoption logs may be useful when valid credentials have been provided for the beacon, and it's managed to connect to the device successfully, but the installation subsequently fails.
Location:
- C:\Windows\Temp\adoption.log (Windows)
- /var/tmp/flexera/log/ndinstlr.log and ndinstlrsh.log (Unix-like operating systems)
Windows Installer log from the agent installation
This is the Windows Installer log file for the agent install. Created by default only when using the setup.exe to install the agent.
Location: %TEMP%\FlexNet Inventory Agent.msi.log (Windows only)
TIP: To generate a Windows Installer log file if you are invoking msiexec directory to install the agent, you can use a command line like the following: msiexec.exe /i "FlexNet Inventory Agent.msi" /l*v "%TEMP%\FlexNet Inventory Agent.msi.log"
If you want to capture a Windows Installer log for an adoption or other automated install, you can enable Windows Installer logging system-wide on a device by adding the following registry entry (you may need to create the key):
HKLM\Software\Policies\Microsoft\Windows\Installer\Logging = voicewarmupx
Related articles
Related Articles
How to enable FlexNet Manager Suite diagnostic tracing 270Number of Views [FNMS SAML Setup] WebUI configuration guide to enable SSO / SAML in FlexNet Manager Suite 23Number of Views Troubleshoot problems with CLR and SqlProceduresClr assembly configuration in FlexNet Manager Suite databases 33Number of Views Adding Files to Components 3Number of Views Install the SAP connector libraries for SAP integration with FlexNet Manager Suite versions 2023 R1 or above 37Number of Views
Hi, I am Reva - Ask me anything.
No new updates
Thanks for the feedback!
Your feedback has been saved.Rate this response:
Add Additional feedback ( Optional )
Are you sure you want to cancel
the case creation?
Are you sure you want to cancel the case creation?
Are you sure you want to close this case
| Products | Region | Phone Numbers |
|---|---|---|
| FlexNet Operations FlexNet Embedded FlexNet Publisher FlexNet Connect FlexNet Code Insight InstallAnywhere InstallShield |
North America * |
+1 630-332-2513 (toll) +1 877-279-2853 (toll-free in North America) |
| Europe * |
+44 1925 944367 (toll) +44 800 047 8642 (toll-free in Europe) |
|
| Japan * | +81 3-4540-5335 (select option 2) | |
| Australia * |
+61 3 9895 2177 +61 1800 560 603 (toll-free in Australia) |
|
|
Usage Intelligence (formerly
Revulytics) Compliance Intelligence |
Please use the Case Portal to submit your support ticket or reach out to your Revenera contact. | |
Case id: 00001065
Activity: Status change: 2 hours ago