License logging

Transact automatically logs license information to provide an at-a-glance view of current server licensing and configured feature flags. The following is an overview of the information logged, and at what time:

All license information (including ID Extraction license expiration date, if applicable) is logged each time the Transact server is started, as well as daily according to a cron job. For more information, see Configuring warning logs.
A warning will be logged when you use 90% of your allotted images. You can configure this threshold in the dcma-core.properties file. For more information, see Configuring warning logs.
A warning will be logged daily starting 30 days before the Transact license expiration date.

Logging process

Once a day at the scheduled time, as well as each time the Transact server is started, the license status is checked and written to the dcma-monitor.log file. The data is returned in JSON.

If the license is near expiring (< 30 days), it is also written to the dcma-all.log file, located at <Transact Folder>\Application\logs\dcma-all.log, at a warning level.
If the license is expired, it is also written to the dcma-all.log file at the error level.

Logging properties

The following table outlines the key license properties logged in the dcma-monitor.log file, located at<Transact Folder>\Application\logs\, upon startup. The second column lists the label in the License Details page, if applicable.

JSON Key Name	Transact Label	Description
version	Application Version	The Transact version that is installed on the host environment. This field might contain a software version that is more recent than the original software version when the license was purchased.
os	Operating System	The computer operating system: Windows Linux
level	N/A	The level at which the entry is logged. The log levels are the following: INFO: Default logging level. ERROR: Logs if the license is expired. WARNING: Logs if the license is close to expiring.
timestamp	N/A	When the event that triggered the log occurred.
event	N/A	The start and end of the event are indicated by curly brackets { }.
Transact_Monitor_Codes	N/A	An array of all the current statuses. Each consists of a Transact_Monitoring_Code and a Transact_Monitoring_Code_Value.
Transact_Monitoring_Code	N/A	Numeric code indicating the current state of the license. See License monitoring codes for details.
Transact_Monitoring_Code_Value	N/A	The name of the code indicating the current state of the license. See License monitoring codes for details.
Expiry_message_will_be_shown_before	License Expiration Display Message	The number of days before license expiration. On this day, the system will start warning you that your license is about to expire. For example, 30 days before your license expires, you will begin to receive warning messages.
IDE_Remaining_Number_Of_Images	Identification Extraction Remaining Number of Images	The remaining number of images that you can process with the ID Extraction plugin given the current license.
Last_Accessed	N/A	When Transact was last accessed.
License_Version	License Version	The license version based on the license generation tool.
IDE_Image_Count_Consumed	N/A	The number of images processed using the ID Extraction plugin since the license was installed.
High_Performance_Switch	High Performance Switch	Displays whether the High Performance Switch is enabled (ON) or disabled (OFF). For information about licensing requirements, see the Ephesoft Transact Technical Specifications.
IDE_Switch	Identification Extraction Switch	Indicates the status of the Identification Extraction plugin. This will be logged as true or false but will display as ON or OFF in the user interface, respectively.
MAC-Address	MAC-Address	Lists the MAC address(es) associated with this installation. If there are multiple cores, each MAC address is separated by the pipe ( \| ) symbol.
IP_Address	N/A	The IP Address of the host computer.
License_expiry_date	License Expiry Date	The date on which this Transact license expires.
Reset_Date	N/A	Related to subscription, core-based licenses. Not applicable for monitoring.
Image_Count_Consumed	N/A	The number of images processed by Transact since the license was installed.
Reporting_License_Type	Reporting License Type	Identifies the type of reporting functions that are supported in this license. For information about licensing requirements, see the Ephesoft Transact Technical Specifications.
License_Id	License ID	The unique identifier that is assigned to each Transact instance.
Remaining_Number_Of_Images	Remaining Number of Images	The remaining number of images that can be processed if the license is image count-based.
OCR_Languages	Additional OCR Language Pack	Lists the language packs that are supported by OCR engines in this installation.
Annual_Overage_Image_Count	Overage Image Count	The number of images that a user can process after they've exceeded the image count specified in their contract.
Verify_Platinum_Switch	Verify Platinum Switch	Indicates whether this installation includes multi-server connectivity (YES) or single-server deployment (NO).
License_Model_Type	Sales Model	The license model type. This will be logged as 1 (Core) 2 (Consumption) For consumption-based models refer to License Consumption Report.
License_Type	N/A	For Transact use only.
Web_service_switch	Web Service Switch	Indicates whether web service API calls are enabled for service. This value is set to ON if this installation supports using API service calls. This value is set to OFF if this installation does not use API service calls.
Web_Service_License_Type	Web Service License Type	Identifies the web service license type as either: 1 (Image Count) 2 (Service Hits Per Day)
Web_Service_Hits_Per_Day	Web Service Hits Per Day	If the web service license type is Hits Per Day, this will log the total number of hits allowed in a day.
Hostname	N/A	The AWS hostname of the Transact instance.
IDE_Annual_Image_Count	Identification Extraction Annual Image Count	The image count for the Identification Extraction license, which may be one of the following: An annual total. A subscription total for the life of the subscription, if different than an annual total. Unlimited.
License_Environment_Type	Server Type	The environment type. This is logged as: 1 (Production) 2 (Non-Production)
Operating_System	Operating System	Identifies the operating system for Transact for which the license is issued.
IDE_Expiry_Date	Identification Extraction Expiry Date	The date on which this Identification Extraction license expires.
Number_of_Cores	Number of Cores	Cites the number of cores for this licensed installation.
License_Scope	N/A	Displays whether the license is internal or external. Can have a value of 0 (Internal) 1 (External)
Days_Until_Expiring	N/A	The number of days until License_expiry_date.
Annual_Image_Count	Image Count	The image count for this license, which may be one of the following: An annual total. A subscription total for the life of the subscription, if different than an annual total. Unlimited.
License_Account_Name	Account Name	The name of the company on the license.

JSON is written to the dcma-monitor.log. A sample is provided below.

{
    "version":"2020.1.04", 
    "os":"Windows Server 2016", 
    "level":"INFO", 
    "timestamp":"2021-02-26T21:47:17,407",
    "thread":"pool-dcma-workflows-4-thread-1", 
    "event":{
        "Transact_Monitor_Codes":[
            {
            "Transact_Monitoring_Code":"LIC_VALID",
            "Transact_Monitoring_Code_Value":800000
            }
        ],
        "Expiry_message_will_be_shown_before":"30 days of expiry",
        "Last_Accessed":"2021-02-26",
        "License_Version":"2020.1.04",
        "IDE_Image_Count_Consumed":0,
        "High_Performance_Switch":false,
        "IDE_Switch":false,
        "MAC-Address":"02-78-E3-FA-86-03",
        "IP_Address":"172.31.29.243",
        "License_expiry_date":"2021-06-26",
        "Reset_Date":"2022-02-26",
        "Image_Count_Consumed":0,
        "Reporting_License_Type":"Advanced",
        "License_Id":"ab2a82c0-2101-4103-9623-5c2e33ff6f60",
        "Remaining_Number_Of_Images":120,
        "OCR_Languages":"0;1",
        "Annual_Overage_Image_Count":20,
        "Verify_Platinum_Switch":false,
        "License_Model_Type":"2",
        "License_Type":"Subscription",
        "ICRPlus_Switch":false,
        "Web_service_switch":false,
        "Web_Service_License_Type":"Image Count",
        "Hostname":"EC2AMAZ-F9F8VBG",
        "IDE_Annual_Image_Count":0,
        "License_Environment_Type":"1",
        "Operating_System":"Windows",
        "Number_of_Cores":4,
        "License_Scope":"1",
        "Days_Until_Expiring":120,
        "Annual_Image_Count":120,
        "License_Account_Name":"as_win_lic_a"
    }
}

Configuring warning logs

This topic describes how to configure certain aspects of the license logging.

Both of the properties listed below are configurable in the dcma-core.properties file, located at <Transact Folder>\Application\WEB-INF\classes\META-INF\dcma-core.

For Transact Cloud customers, contact Support to make any changes to properties files.

Property	Description
license.near.expiring.percentage	The remaining number of images warning threshold. By default, this is set to 90%. This means that once 90% of the image count limit set in your Transact license is used, a warning will be logged in the dcma-monitor.log file. This property should be formatted as a decimal. For example, 90% is .90.
license.monitor.cronjob.expression	The schedule of when to check the license status. By default, this cron job is set to 1:00 AM (0 0 1 ? * *). For more information on configuring cron jobs, see Cron expressions.