---
title: "Integration.Log"
slug: "integrationlog"
updated: 2025-10-08T14:41:58Z
published: 2025-10-08T14:41:58Z
canonical: "support.lusid.com/integrationlog"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration.Log

| **Type** | **Read/write** | **Author** | **Availability** |
| --- | --- | --- | --- |
| [Data provider](/v1/docs/what-are-a-data-provider-and-a-direct-provider) | Read | Finbourne | Provided with LUSID |

The `Integration.Log` provider enables you to write a [Luminesce SQL query](/v1/docs/understanding-the-luminesce-sql-query-syntax) that retrieves [log details](/v1/docs/setting-up-an-integration#viewing-and-troubleshooting-all-runs) for runs of an integration instance.

> **Note:** The LUSID user running the query must have sufficient [access control permissions](/v1/docs/creating-policies-to-control-access-to-providers-for-different-luminesce-end-users) to both use the provider *and* read log data for integration runs. This should automatically be the case if you are the domain owner.

**See also:** [Integration.Run](/v1/docs/integrationrun), [Integration.Dashboard](/v1/docs/luminesce-read-provider), [Integration.Execute](/v1/docs/integration-execute)

## Basic usage

```sql
select * from Integration.Log where <filter-expression>;
```

## Data fields

By default, `Integration.Log` returns a table of data populated with particular fields (columns). You can return a subset of these fields.

To list fields available to return, their data types, whether fields are considered 'main', and an explanation for each, run the following query using a [suitable tool](/v1/docs/what-tools-are-available-to-write-luminesce-queries):

```sql
select FieldName, DataType, IsMain, IsPrimaryKey, SampleValues, Description from Sys.Field where TableName = 'Integration.Log' and FieldType = 'Column';
```

> **Note:** Fields marked 'main' are returned by queries that include a caret character, for example `select ^ from Integration.Log`.

## Examples

> **Note:** For more example Luminesce SQL queries, visit our [Github repo](https://github.com/finbourne/luminesce-examples/tree/master/examples).

### Example 1: Retrieve first 10 integration run logs

```sql
select * from Integration.Log limit 10
```

### Example 2: Retrieve all logs for a particular run of an integration instance

```sql
select * from Integration.Log where RunId = '015c7176-79f7-465a-b28e-7ad52503389d'
```

### Example 3: Retrieve data mapping errors for a particular day

```sql
select Description,
  SourceAttributeName
  SourceAttributeValue
  SourcePrimaryIdType
  SourcePrimaryIdValue
  TargetAttributeName
  TargetAttributeValue
  TargetPrimaryIdType
  TargetPrimaryIdValue
from Integration.Log
where Status = 'AttributeFailed' 
  and FirstActivity >= #2025-09-25#
```