> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integration-events.md).

# Integration Events

The **Events** tab is available for every Airbyte-based integration. It logs all sync runs, integration lifecycle events, import operations, and entity unlink events for that integration. Use it to verify that scheduled syncs are completing, confirm that imports finished successfully, and investigate failures.

{% hint style="info" %}

* The Events tab is available for the following integrations: [Bitbucket Cloud](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/bitbucket-cloud.md), [Datadog](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/datadog.md), [Dynatrace](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/dynatrace.md), [GitHub](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/github.md), [Google Cloud](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/gcp.md), [PagerDuty](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/pagerduty.md), [ServiceNow CMDB](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/servicenow-cmdb.md), and [SonarQube](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/sonarqube.md). It is not available for Harness CD, Kubernetes integration, and Platform integrations.
* Events are retained for 180 days. Events older than 180 days are automatically removed and cannot be recovered.
* [Custom Integrations](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/custom-integrations/overview.md) also have an Events tab, but it reports ingestion and lifecycle activity rather than sync runs. Go to [Monitor ingestion](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/custom-integrations/ingest-data.md#monitor-ingestion-with-the-events-tab) for those event types.
  {% endhint %}

***

### Access the Events tab <a href="#access-the-events-tab" id="access-the-events-tab"></a>

1. In Harness IDP, go to **Configure** → **Integrations**.
2. Find your integration card and click **View**.
3. On the integration detail page, click the **Events** tab.

   <figure><img src="/files/ZDtwjMHgatHMsgFgLJLO" alt=""><figcaption></figcaption></figure>

***

### Filter events <a href="#filter-events" id="filter-events"></a>

Two dropdowns let you narrow the event list:

* **Event Type**: Filters by the kind of action that generated the event. Go to [Event type reference](#event-type-reference) for the full list.
* **Status**: Filters by outcome. Available values are **Success**, **Partial Success**, **Running**, and **Failed**.

  <figure><img src="/files/dkonKys0RFWJMTHWXcJg" alt=""><figcaption></figcaption></figure>

The event list refreshes automatically every minute. Click **Refresh events** in the top right to reload the list immediately.

***

### Event table columns <a href="#event-table-columns" id="event-table-columns"></a>

The event list displays the following columns for each event.

<figure><img src="/files/cZXNeBbCee8lAvUGQWJb" alt=""><figcaption></figcaption></figure>

| Column           | Description                                                                            |
| ---------------- | -------------------------------------------------------------------------------------- |
| **Event Name**   | The name of the event as shown in the UI, indicating the action and its outcome.       |
| **Status**       | The result of the event: **Success**, **Partial Success**, **Running**, or **Failed**. |
| **Description**  | A brief summary of the event outcome, including record counts where applicable.        |
| **Started**      | The date and time when the event began.                                                |
| **Last Updated** | The most recent timestamp for this event.                                              |
| **Triggered By** | The actor that initiated the event, such as **System** for scheduled syncs.            |

***

### Event details panel <a href="#event-details-panel" id="event-details-panel"></a>

Click any event row to open a details panel on the right side of the page.

<figure><img src="/files/ExRiaSlgBmTT5TzpcSeq" alt=""><figcaption></figcaption></figure>

| Field              | Description                                                                                                      |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Integration ID** | The unique identifier of the integration.                                                                        |
| **Started At**     | The exact date and time the event started.                                                                       |
| **Last Updated**   | The most recent update timestamp.                                                                                |
| **Duration**       | How long the event took to complete.                                                                             |
| **Records Synced** | The number of records processed during the event.                                                                |
| **Trigger Source** | What initiated the event: `scheduled` for automated syncs, or `manual` when triggered using the **Sync** button. |
| **Streams**        | The data streams involved in this event, such as the resource types being synced.                                |
| **Description**    | A summary of the event outcome.                                                                                  |

***

### Event type reference <a href="#event-type-reference" id="event-type-reference"></a>

| Event Type                 | Status          | Event Name                              |
| -------------------------- | --------------- | --------------------------------------- |
| **Sync run**               | Running         | Syncing records                         |
|                            | Success         | Sync completed                          |
|                            | Partial Success | Sync partially completed                |
|                            | Failed          | Sync failed                             |
| **Integration created**    | Running         | Creating integration                    |
|                            | Success         | Integration created                     |
|                            | Failed          | Integration creation failed             |
| **Integration updated**    | Running         | Updating integration                    |
|                            | Success         | Integration updated                     |
|                            | Failed          | Integration update failed               |
| **Integration enabled**    | Running         | Enabling integration                    |
|                            | Success         | Integration enabled                     |
|                            | Failed          | Integration enable failed               |
| **Integration disabled**   | Running         | Disabling integration                   |
|                            | Success         | Integration disabled                    |
|                            | Failed          | Integration disable failed              |
| **Entities manual import** | Running         | Starting manual import                  |
|                            | Success         | Manual import complete                  |
|                            | Partial Success | Manual import partially completed       |
|                            | Failed          | Manual import unsuccessful              |
| **Auto import**            | Running         | Auto-importing \<kind>                  |
|                            | Success         | \<kind> auto-imported                   |
|                            | Partial Success | \<kind> auto-import partially completed |
|                            | Failed          | \<kind> auto-import failed              |
| **Entities unlink**        | Running         | Unlinking entities                      |
|                            | Success         | Entities unlinked                       |
|                            | Partial Success | Entities partially unlinked             |
|                            | Failed          | Unlink failed                           |

{% hint style="info" %}
For **Auto import** events, `<kind>` is replaced by the actual entity kind being processed, such as `resource` or `component`.

For integration lifecycle events (Integration created, updated, enabled, and disabled), a **Failed** status covers both full failures and partial failures.

For **Sync run** events, a **Failed** status can indicate one of three conditions: the sync encountered an error, the sync got stuck and was marked stale by the system, or a newer sync started before this one completed and overrode it.
{% endhint %}