Troubleshooting

Find the break in the connection.

A preview of the diagnostic guide. Version-specific checks and recovery commands will be published with the product.

Coming soon

Sample content for this design. This resource is coming soon.

Start from the symptom

Coming soon

The service does not start

Check the supported runtime, configuration and logs. Keep the exact error and version when asking for help.

A data source cannot be reached

Check connectivity, source availability and credential scope. Do not include secrets in a public issue.

A relationship is missing

Compare the source keys, mapped identifiers and relationship direction. Confirm that both records exist.

An answer needs correction

Inspect the applied definition, matched records and source mapping. Save a minimal reproducible example.

Questions & issues

Preview the help and bug-reporting channels.

Coming soon

Work through a missing relationship.

Illustrative content

In this invented example, order O-018 points to product P-007, but the product source contains only P-008. The display names happen to match.

Illustrative preview

Order O-018
  product_key: P-007

Product source
  id: P-008

Check result
  relationship target: not found

Do not join on the similar name. Confirm whether the mapping is incorrect or the source record is missing, then correct the source or mapping explicitly. Preserve the original order ID when checking the answer again.

There is already something to explore.

Try the example worlds Run the learning sample