# Logs

The Logs and Results can be accessed in two ways:

1. From the Integrations page: Click on **View Logs** under the Sync Now/ Copy URL button
2. From the Projects Navigation Menu: Click on the **Logs icon.**<img src="https://2655769465-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjVABEcCgwItwY4IEAD%2Fuploads%2FpCIBFdXRcr3zpxgv2DS6%2Fimage.png?alt=media&#x26;token=07e9f35b-6872-4b78-a823-55e755c5701d" alt="" data-size="line">&#x20;
3. If a sync fails, then the "Synchronized (with error)" icon will also redirect to the Logs page.

<figure><img src="https://2655769465-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjVABEcCgwItwY4IEAD%2Fuploads%2FVWUoAbUksK3HQcO8UyMD%2FProperty%201%3DVariant5.jpg?alt=media&#x26;token=9c3bbd05-8c84-4998-9dbd-403cb4913999" alt="" width="375"><figcaption></figcaption></figure>

The Logs page displays the following fields in tabular form:&#x20;

<figure><img src="https://2655769465-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjVABEcCgwItwY4IEAD%2Fuploads%2F0fRi5W8qXCalsCt2bIpD%2FLogs.jpg?alt=media&#x26;token=4729d58f-c5c2-4209-aaaf-1eb2f4e200cb" alt=""><figcaption></figcaption></figure>

| Field name                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Pipe Name/Workflow Name    | The Integration name                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Total                      | Total number of records processed in that sync                                                                                                                                                                                                                                                                                                                                                                                                   |
| Succeeded                  | Number of records processed successfully                                                                                                                                                                                                                                                                                                                                                                                                         |
| Failed                     | Number of records that were not processed                                                                                                                                                                                                                                                                                                                                                                                                        |
| [Duration](#logs-duration) | Time taken for the sync to complete.                                                                                                                                                                                                                                                                                                                                                                                                             |
| API Time                   | Time taken for an API call in a synchronization                                                                                                                                                                                                                                                                                                                                                                                                  |
| Started At                 | Time when the sync was started                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Finished At                | Time when the sync process ended                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Status                     | Status of the sync                                                                                                                                                                                                                                                                                                                                                                                                                               |
| View Console button        | The Console Log file can be downloaded from here. (The Console Log is defined by the 'Console' statement in the Flow)                                                                                                                                                                                                                                                                                                                            |
| Action                     | <ul><li><p>Reprocess: To reprocess the synchronization with the same data</p><ul><li>For Batch Processing: Reprocess uses the same date as the data that failed to sync</li></ul></li><li><p>View Detailed Logs: </p><p>Displays either</p><ul><li>A general log message (as a popup), defined by the 'Logger' statement in the Flow</li><li>An entity level log message, defined by the 'Step Logger' statement in the Flow</li></ul></li></ul> |

<figure><img src="https://2655769465-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjVABEcCgwItwY4IEAD%2Fuploads%2FaOiGviFzaOhnO2LydsLn%2FView%20Console.jpg?alt=media&#x26;token=64e71cbb-3fd8-44dc-b31f-e7ac648ab9d2" alt=""><figcaption><p>Console Logs</p></figcaption></figure>

## Logs Duration

The duration split-up information for every synchronization is displayed upon hovering over the Duration field. You can then click “View all APIs” to see detailed information such as System Name, API Name, API Count (number of times the API was called), Average Duration, and Total Duration.

<figure><img src="https://2655769465-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjVABEcCgwItwY4IEAD%2Fuploads%2Fv5VDZhrLTegw0sJ97X0u%2FLogs%20Duration%20Splitup.jpg?alt=media&#x26;token=2aee7829-2c40-4dee-9634-487e9fb8a735" alt=""><figcaption><p>Logs Duration with records</p></figcaption></figure>

<figure><img src="https://2655769465-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjVABEcCgwItwY4IEAD%2Fuploads%2FY4TYCTfr15tXeDslBOa9%2FLogs%20Duration%20Splitup%20All%20API.jpg?alt=media&#x26;token=d279e57c-d3dc-4473-8aab-5c4ac636ff79" alt=""><figcaption><p>Logs Duration Split-up on API Level</p></figcaption></figure>

## Logs Filter

<figure><img src="https://2655769465-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjVABEcCgwItwY4IEAD%2Fuploads%2FFANUgV81GF2iRlVJcIPn%2FLogs%20Filter.jpg?alt=media&#x26;token=4e49ae9f-21a2-417b-9a6f-065f3d5ae6fe" alt=""><figcaption><p>Logs Filter</p></figcaption></figure>

The Logs can be filtered based on:&#x20;

1. Pipe Name
2. Entity ID
3. Status of the Logs&#x20;
4. Total records

### **Default Date Filter**

The default date filter is automatically added to logs page to improve performance. Users can choose from predefined time ranges, such as recent hours or days, to quickly filter logs. (e.g., Last 3 hours or Last 7 days)

Users can also specify a custom date range (e.g., Jan 01, 2025, 12:00 AM – Jan 10, 2025, 12:00 AM)

By default, logs from the last 7 days are displayed.

## Logs Timezone &#x20;

* All times are displayed in respective project timezone. If not configured, Default Timezone is UTC (Coordinated Universal Time).
* If a user overrides a project timezone by account timezone in account settings, Logs will be displayed in the account timezone set by the user. This change will be reflected only for that user.

## Pipes Reprocessing

This feature allows the ability to reprocess the pipes with the same information again. This can be used when errors in a pipe are fixed, and users wish to resync the same data.

{% hint style="info" %}
Some systems could not work well with the reprocessing feature because of its limitations.
{% endhint %}

#### Pipes Reprocessing enable/disable options

The Option to enable and disable logs is found within the project settings as displayed in the image below:&#x20;

<figure><img src="https://2655769465-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjVABEcCgwItwY4IEAD%2Fuploads%2FBtPJZJmOHQHF1nUSvVNH%2FPipe%20Reprocessing.png?alt=media&#x26;token=cdf701ff-e176-430a-adbe-356693d3a26a" alt=""><figcaption></figcaption></figure>

On enabling the pipes reprocessing option, DCKAP Integrator logs the information of the pipe on the first run, to reprocess the same data again.

## Important Notes

{% hint style="info" %}

* All the date and time entries shown here are displayed in the timezone configured in project settings
* The **View Console** button will be displayed and Console messages are logged only when the setting is enabled in the project settings (Click here to go to [Project Settings](https://docs.dckapintegrator.com/project-manager/project-settings))
* For Batch synchronization, Console logs greater than 5 MB may be downloaded as a text file
* Dynamic services will not be able to log more than 5 MB in Console logs
* Console logs will be automatically deleted except the last 5 days' records.
* **IMPORTANT**: Console Log download link is valid only for 5 minutes. You will need to refresh the page to get a new link in the Console Log Area.&#x20;
  {% endhint %}

{% hint style="warning" %}
Any kind of logs (Logs Summary, Detailed Logs, Console Logs) will be retained only for 30 days in  DCKAP Integrator.&#x20;
{% endhint %}
