Build Logs Overview

When you build a data model, Sisense displays an intuitive build log that describes each step of the build.

Build logs are useful for investigating problems that occurred during your build.

The log displays each table being built as its being built. You can click the table's name in the log to zoom in on the table in your schema. If a table fails to build, you can click its name in the log and then open the table within your data model to investigate potential causes for the failure.

Note:

Your build log is available after your first build in Sisense V7.3 and later.


Build Error Messages

The build error message provides the information you need to make smarter and faster decisions.

If a Build fails, the latest logs will be displayed out-of-the-box when opening such an ElastiCube, in order to bring attention to it, and to simplify accessing the information needed to resolve the Build issue.

Build error messages include a proposed mitigation for approximately 80% of errors. The mitigations are based on expert feedback, and Sisense field experts are working on a daily basis to improve their coverage and quality.

Build error messages include:

  • Title - Short description of the error

  • Error Code - Used as a reference for community and support

  • Error message - Clear short message with information about what to check

  • Error Details - Clicking ‘Read More’ displays a detailed error message

Example build error message:

Validations Included in the Build Flow

The build flow includes out-of-the-box several verification and validation steps to proactively inform users about potential issues and prevent usage of corrupted data in dependent assets.

The following validations have been added:

  • "DataIndexingValidation" - Validates that all keys and values in dimension tables are unique

  • "RelationDimTablesValidation" - Validates that all dimension tables that were created for relations between tables include all of the possible keys and values

  • "IndexingDimTablesValidation" - Validates that all dimension tables that were created for indexing include all of the possible keys and values

All of the validations are included and enabled by default in the build flow and fail the build with corresponding messages displayed in the build logs. In most cases, rebuilding fixes the issue. To rebuild the failed cube, configure and use Build Retry.

Build Log Export

Once your build is complete or if the build failed, you can export a detailed log file by clicking in the build log.

The exported log is a JSON file that provides details about each table. For information about understanding the log file, see Working with Build Logs.

In addition, you can create a new dashboard from the build log or open any existing dashboards related to the data model.