Skip to main content
The Qualitizer is a web application — a collection of tools that help you understand, troubleshoot, and improve the quality of your Cognite Data Fusion deployment. It surfaces insights into access, data models, and workload scheduling that are otherwise hard to see, and it ships with built-in help pages that explain each feature. Qualitizer is available in English and Japanese. The application helps you answer questions such as:
  • “Why does user X see this search result while user Y does not?” — full insight into your CDF groups makes it easy to spot where you can optimize and reuse access.
  • Where are failing activities and processing bottlenecks? — identify workload spikes so you can reduce them and improve system stability.
  • What do my data model views and properties look like? — inspect the structure of your data models.
Qualitizer is built on the Cognite Flows application framework. The tool is run in standalone mode with a local proxy that injects client-credentials tokens, so technical users can run it on their own machine.
This is the same Qualitizer tool that the Foundation deployment pack can install (the qualitizer module). If you already installed it through Foundation, you can run it from that project’s modules/tools/apps/qualitizer/ folder instead of cloning it separately.

​
Who it’s for

Target personas:
  • Data engineers — investigate data quality, access, and workload issues on a CDF project.
  • CDF administrators — review access groups, data models, and job scheduling.
Use this tool when:
  • You need to understand why users see different search or access results and want a clear view of your CDF groups.
  • You want to find failing activities and scheduling bottlenecks to improve system stability.
  • You want to inspect the views and properties of your data models.

​
Prerequisites

Verify all of the following before you start:
  • Cognite Toolkit version 0.8 or later is installed. See Setting up.
  • A cdf.toml file exists in your project root. If it is missing, run cdf modules init and select Create toml file (required).
  • Authentication is configured and verified — run cdf auth init and cdf auth verify using a local .env file. See Authentication and authorization.
  • Node.js 22 or later and npm are installed to run the Qualitizer web application and its proxy.
  • You have permission to enable feature flags in your CDF project. Contact your CDF administrator if you do not have access.

​
Install

You can install Qualitizer with the Cognite Toolkit or by cloning the best-practices GitHub repository.
Run cdf modules add and select Tools and Accelerators > CDF Qualitizer Application.The Toolkit creates the module under modules/tools/apps/qualitizer/.

​
Run the application

Qualitizer runs as two local processes: a web application you open in the browser, and a proxy that handles authentication against CDF.
The tool does not store state. For some views, this limits the time window you can inspect at once (for example, one hour).
1

Set up the .env file

You can reuse the .env file from your Toolkit setup. Copy it into the qualitizer folder and add these two lines:
The complete list of environment variables is in the README file included with the tool. See Configuration reference for the most common ones.
2

Start the proxy

Leave this process running and open a separate terminal for the next step.
3

Start the web server

Open http://localhost:4242/ in your browser.

​
Configuration reference

Set these environment variables in the .env file in the qualitizer folder. The full list is in the README included with the tool.

​
Troubleshooting

For issues not covered here, contact Cognite support.

​
Support

Last modified on July 6, 2026