Skip to content

Instances

An instance represents the runtime execution of a journey. Since a journey consists of a collection of components and the relationships that link them, an instance shows the events that occur across your data estate as work gets done.

Observing an instance can give you insights into questions like:

  • What happened during the execution of this journey?
  • Are the correct events happening in the right components at the right time?
  • What, if any, blockers are occurring during the process of delivering a data asset?
  • What is the progress of a specific piece of data across my data estate?

Tip

Alerts and statuses can help keep you up-to-date on instance progress.

Define instances

You can define the window of time when a journey's instances start and end with instance conditions. You can configure instance conditions in the journey Settings tab for both regular instances and payload instances. For steps on how to, see Configure Instance Conditions.

Note

For an overview of instance behaviors and logic, see Define Instances and Payload Instances Overview.

View the Instances page

Observability data is always associated with a specific project. To see a list of all the instances for a given project:

  1. Use the drop-down in the menu to select a Project.
  2. Select Instances from the menu.

Instances page

Each record includes an instance ID, the associated journey, the start condition, timings, relevant statuses, and alerts.

  • The ID column displays a unique instance identifier.
  • IDs, journey names, and duration are truncated. Hover the cursor to display these in full.
  • The type of instance condition configured for the journey displays in the Start Type column.
  • The Duration column shows the length of time for completed instances and the time elapsed for instances in progress.
  • The Status columns show the progress, status, and alerts for each instance.
    • Click any alert to open a dialog with more details.
  • Use the various filters to narrow your results.
  • Use Refresh to update the page with new instances and Show/Hide Columns to customize the table.

Note

Timestamps display in the UI as Mmm DD, YYYY hh:mm:ss AM/PM in the user's browser timezone. All system timestamps adhere to the ISO 8601 format YYYY-MM-DDTHH:mm:ss.sssZ. Observability assumes UTC when no timezone is specified.

Visual example in Observability

(Screenshot of the Instances page)

Components

Create Relationships

Data Journeys