Logging

Logging

You can setup logging, if you sign on as a tenant administrator and select settings as described under Settings for tenant.

Under logging you see this:


 

Under logging you have these subjects:

1.Job log settings for tenant. Here you setup for how long you want to keep job logs. Please notice the option for reduced job logging.

2.For Database maintenance you have the options for compressing the internal database.

3.Error report email. Here you can setup one or multiple email address(es) to send error reports to, if errors should occur during processing.

4.Email log setup. Here you can enable the email log and setup for how long you want to keep entries in the email.

Job log settings for tenant

This is related to the job logs tab of InterFormNG2. Here you can setup for how long you want to keep entries in the job log, and if you want to send an email to an administrator if a workflow hits a problem during processing on an input file.

In order to setup the job log, you first need to sign in as described here.

 

Then you click Logging on the left below Other:


 

Then you see this option on the top:

 

Here you can setup how long job log entries should be kept and you also have the option to use reduced job logging.

  1. Delete job log entries older than
    Here you setup for how long the job log entries should be kept - or when the entries are considered to old, that they should be deleted.
    With the setting above the entries are kept for 7 days.

    Above you state the days, hours or minutes. Remember to click Save in the bottom right to save any change you might have done.
  2. Reduced job logging
    If you activate reduced job logging the following rules apply:
         - Parameter values are never stored.
         - Message translation key is never stored.
         - Metadata (key-value) are only stored if the log level of the message is WARN or higher.
         - Caller is only stored if the log level of the message is WARN or higher.
Database maintenance
This section concerns the size of the internal, default database. The database grows in size if it is not regularly compressed.

The database options are these:

Perform automatic daily compression
It is a very good idea to consider to enable this option. If enabled InterFormNG2 will compress the contents of the database daily at the designated time.

Compress Database now
This icon is an alternative to the option above. If you click this icon, then InterFormNG2 will start compressing the database immediately. You should only run this option while no input files are processed.
Error report email

It is possible to setup InterFormNG2 to send an email, if an error should occur. Here you can setup which email address to send to.

Alternatives (or rather additions) to this are the on-error option and error handler in the workflow, where you can setup a workflow to call a specific error workflow, if an error should occur.

 

In order to setup the error report email, you first need to sign in as described here.

Then you click Logging on the left below Other:

 

Then you see this option as the third from the top:

 

Here you have these fields:

(Remember to click Save in the bottom right to save any change you might have done.)

  1. Error report email enabled
    You can activate this option here. On the image above this option has been activated. (It is blue and the switch is on the right).
  2. Email server
    In order for the tenant to be able to send an error email you need to refer to a functioning email server.
  3. Subject
    The subject of the outgoing email.
  4. Recipient
    The receiver of the error report email. If you want to insert multiple receivers, then you need to separate the email addresses with a semicolon e.g. email1@mydomain.com;email2@mydomain.com
Email log setup
Email log setup

In order to use the email log you first need to enable it and set it up. This is covered in this section.

In order to setup the email log, you first need to sign in as described here.

 

Then you click Logging on the left below Other:

 

Then you see this option as the third section from the top:

(Remember to click Save in the bottom right to save any change you might have done.)

 

 

The parameters are:

  1. E-mail logging enabled
    Click on this switch to enable or disable the e-mail log. When the option is shown in blue and the switch on the right, like above, then the option is enabled.
  2. Detele e-mail log entries older than:
    Here you can specify for how long, that you want to keep the entries in the email log. On the screen above we have chosen to keep the entries and the emails for 120 days.

    • Related Articles

    • Logs

      In InterFormNG2 there are 8 types of logs: The job logs. This contains details information of what happened during processing of each input file. This can be used by non-technical users. A system log. The core log of InterFormNG2. This is advanced ...

    • Settings for tenant

      This section covers the settings for one tenant (environment). Another section covers the system settings. In order to get access to the tenant settings you need to sign on as a user with administrator rights for the current tenant. To access the ...

    • To dynamic Windows Share

      The advanced, output workflow component, To dynamic Windows Share can be used if you want to write a file to a dynamic Windows Share, which cannot be configured as a Windows Share connection. The workflow component has these parameters: Mandatory ...

    • Custom log message

      The advanced, other workflow component, Custom log message can be used for adding a user defined log message into the job log of the current workflow. This can e.g. be used in order to report an issue to the job log (so that the relevant user and see ...

    • Windows share connections

      If you want to use windows shares in InterFormNG2 for reading and writing data via such a shared folder, then you first need to define a connection to this share. This link might help you to define a share on the remote server: ...