This article describes the Integration log module within RecMan BI.
The Integration log is a module within RecMan BI that provides logs related to your integrations, such as invoices, payroll, and other third-party systems. This enables you to review the data flow and troubleshoot errors.
Activation
To access RecMan BI and utilize the integration log, you require permissions enabled in the co-worker settings, as illustrated below. The first permission grants access to the RecMan BI application, where the Integration log may be located, and the second one to the integration log itself.
Filtering
In this module, multiple filters allow you to search for almost anything. For example, if you have an invoice integration that encountered an error, you can search by invoice number. If you have an integration that transfers employee data, you can search by employee number or name, or by various other values. You can also filter logs that are assigned to you and don’t yet have any other responsible co-worker assigned. This becomes important because there’s a widget that assigns logs to individuals. Once assigned, that person becomes responsible for fixing the issue.
For example, if there's an error with an invoice that needs to be sent to the accounting software, the person responsible for that project will be responsible for resolving the error. Similarly, if there's an employee data transfer where a social security number is missing, the integration may fail to transfer the employee to the payroll system. In that case, the person responsible on the employment will be assigned the log and will need to correct the issue so the integration can flow properly.
The system classifies logs into different response statuses: successful transitions, errors, successful transitions with warnings, and unknown. You can filter based on these response types.
Logs overview
In the center of this module, you review the logs. If you find a specific log entry interesting or relevant, you can simply click on it. To the right, you’ll see general information, such as the customer it relates to. Clicking the customer name will open the customer card in a new window. The same goes for the invoice number — clicking it will take you directly to the invoice module with that invoice highlighted.
You’ll also see any errors listed, and you can add a note if you've solved the issue manually. After doing so, you can mark it as 'resolved.' You also have the option to inspect the data involved in the integration, which is especially useful for troubleshooting.
Troubleshooting
If needed, you can copy the log content and paste it into another tool for easier review. You’ll also be able to see every step in the request timeline, as each integration or transition may include multiple steps. These steps are fully visible for each log.
If there's an error that you can’t resolve or don’t understand, you have the option to create a support ticket. For example, if the error message is unclear, you can click the Create a ticket button. This will generate a support request with a ticket number, which will be handled via email from support@recman.io. We will follow up with you directly.
This is a great tool for tracking issues, communicating with support, and getting assistance. In many cases, if the error message is clear, you may be able to resolve the issue on your own.
If you do resolve it yourself, you can select multiple logs at once by holding the Shift key and clicking the top and bottom of the list. This lets you mark or download them as a spreadsheet, or assign them to a responsible person. Assigning logs to people is important because there's a dedicated widget for tracking responsibility.
Integration log widget
Next, we’ll move over to the dashboards, where you can manage and monitor integrations.
Here, you can create an integration dashboard or use the existing one and add the Integration log widget — possibly more than one if you want to monitor different types of logs. For example, this is useful if you're responsible for specific areas or want to track logs from multiple perspectives.
When viewing the dashboard, you'll see the logs assigned to you, giving you a clear overview of the total logs you’re responsible for. Once you've set it up, you can hit Save changes. Then, on your home screen, you'll have the integration log widget available.
If there's an error listed, you can click on it to open the log entry. Clicking the log opens the same view as in the main integrations log — it's just embedded in your dashboard. It appears as a side panel (or drawer) where you can review the log in detail.
From there, you can click on related items like the employee, customer, or invoice to get more context. You then have the option to either resolve the issue or request assistance.
Summary
The Integration log tool is a great way to manage your integrations and follow up on any issues that arise— especially when your integrations have been automated. It makes it easy to spot errors, understand them, and either fix them directly or start the process to resolve them efficiently.