Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Connecting Mitzu to ClickHouse

Community maintained

Mitzu is a no-code, warehouse-native product analytics application. Similar to tools like Amplitude, Mixpanel, and PostHog, Mitzu empowers users to analyze product usage data without requiring SQL or Python expertise.

However, unlike these platforms, Mitzu doesn’t duplicate the company’s product usage data. Instead, it generates native SQL queries directly on the company’s existing data warehouse or lake.

Goal

In this guide, we’re going to cover the following:

  • Warehouse-native product analytics
  • How to integrate Mitzu to ClickHouse

This guide is just a brief overview of how to use Mitzu. You can find more detailed information in the Mitzu documentation.

Gather your connection details

To connect to ClickHouse with HTTP(S) you need this information:

Parameter(s) Description
HOST and PORT Typically, the port is 8443 when using TLS or 8123 when not using TLS.
DATABASE NAME Out of the box, there is a database named default, use the name of the database that you want to connect to.
USERNAME and PASSWORD Out of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select a service and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS. Connection details are displayed in an example curl command.

ClickHouse Cloud HTTPS connection details

If you’re using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

Sign in or sign up to Mitzu

As a first step, head to https://app.mitzu.io to sign up.

Mitzu sign-in page with email and password fields

Configure your workspace

After creating an organization, follow the Set up your workspace onboarding guide in the left sidebar. Then, click on the Connect Mitzu with your data warehouse link.

Mitzu workspace setup page showing onboarding steps

Connect Mitzu to ClickHouse

First, select ClickHouse as the connection type and set the connection details. Then, click the Test connection & Save button to save the settings.

Mitzu connection setup page for ClickHouse with configuration form

Configure event tables

Once the connection is saved, select the Event tables tab and click the Add table button. In the modal, select your database and the tables you want to add to Mitzu.

Use the checkboxes to select at least one table and click on the Configure table button. This will open a modal window where you can set the key columns for each table.

Mitzu table selection interface showing database tables

To run product analytics on your ClickHouse setup, you need to > specify a few key columns from your table.

These are the following:

  • User id - the column for the unique identifier for the users.
  • Event time - the timestamp column of your events.
  • Optional[Event name] - This column segments the events if the table contains multiple event types.
Mitzu event catalog configuration showing column mapping options

Once all tables are configured, click on the Save & update event catalog button, and Mitzu will find all events and their properties from the above-defined table. This step may take up to a few minutes, depending on the size of your dataset.

Run segmentation queries

User segmentation in Mitzu is as easy as in Amplitude, Mixpanel, or PostHog.

The Explore page has a left-hand selection area for events, while the top section allows you to configure the time horizon.

Mitzu segmentation query interface with event selection and time configuration

Run funnel queries

Select up to 9 steps for a funnel. Choose the time window within which your users can complete the funnel. Get immediate conversion rate insights without writing a single line of SQL code.

Mitzu funnel analysis view showing conversion rates between steps

Run retention queries

Select up to 2 steps for a retention rate calculation. Choose the retention window for the recurring window for Get immediate conversion rate insights without writing a single line of SQL code.

Mitzu retention analysis showing cohort retention rates

Run journey queries

Select up to 9 steps for a funnel. Choose the time window within which your users can finish the journey. The Mitzu journey chart gives you a visual map of every path users take through the selected events.

Mitzu journey visualization showing user path flow between events


Run revenue queries

If revenue settings are configured, Mitzu can calculate the total MRR and subscription count based on your payment events.

Mitzu revenue analysis dashboard showing MRR metrics

SQL native

Mitzu is SQL Native, which means it generates native SQL code from your chosen configuration on the Explore page.

Mitzu SQL code generation view showing native ClickHouse query

Mitzu support

If you’re lost, feel free to contact us at support@mitzu.io

Or you our Slack community here

Learn more

Find more information about Mitzu at mitzu.io

Visit our documentation page at docs.mitzu.io

Navigation