Make product decisions with the same numbers the business reports.
Your Data team defines each metric in Looker and checks its quality there. Zentrik follows the metrics you choose: each one is a saved Look, run exactly as saved, on a daily or weekly schedule.
Every reading compares the latest complete period with the one before it, and keeps one Insight per metric current. Product questions from PostHog or Amplitude and Looker metrics land in the same place, so ideas and briefs can cite both.
Connect Looker
A workspace owner or admin can connect Looker. You need your Looker instance URL and an API client ID and secret. A Looker admin creates them on a user's page under Admin → Users → Edit API keys (create API credentials). Use a dedicated user whose role can see the folders and models that hold your metrics.
- Open Settings → Integrations → Connections and select Looker.
- Enter the instance URL, such as https://yourcompany.cloud.looker.com. Older self-hosted instances answer on port 19999: https://looker.yourcompany.com:19999.
- Paste the Client ID and Client secret, then save.
- Select Choose metrics.
Zentrik signs in with the credentials before it saves them. The client secret is encrypted at rest and is never shown again. One Looker instance connects to a workspace; to use other credentials, replace them on the connection.
Choose a metric
- Select Add metric and search your saved Looks by title, folder or model.
- Choose a Look. Zentrik runs it once and lists the numbers it returns.
- Pick the Value to follow, name the metric, and choose a daily or weekly reading.
- Select Preview reading to see the latest value, its change and the recent periods. Save when it shows the number you expect.
A Look with a date dimension is read by that dimension's timeframe: day, week, month, quarter or year. The period still in progress is left out. If the Look also splits each period, for example by country, Zentrik adds the rows up when the value is a count or sum, and refuses averages and distinct counts, which cannot be added. A Look without a date is read as one value and compared with the previous reading. Pivoted Looks are not supported; remove the pivot in Looker or save a separate Look.
Use the reading
- Current Insight states the latest reading, for example Monthly GMV rose 12% to 412,000 in October 2026 compared with September 2026. A change under 10% is reported as within 10% of the period before.
- Readings keeps the result of each run.
- Open Insight carries the reading into ideas and briefs.
- Pause stops scheduled readings without deleting the metric or its history.
Zentrik reports the direction of a change but never calls it good or bad: a rising churn rate is not good news.
Data and access
- Zentrik reads through the Looker API 4.0: the list of saved Looks the API user can see, and the results of the Looks you choose.
- A Look runs as saved. Zentrik never sends its own query, filter, model or SQL, so the definition stays with your Data team. Looker's cache policy for the model decides how fresh results are.
- Zentrik stores each reading: the value per period, the comparison, versions and safe run receipts. It does not keep the Look's raw rows.
- Disconnecting removes the saved credentials. Saved metrics and their Insights stay in Zentrik.
Troubleshooting
Most connection problems clear up after a fresh authorization or an admin allows the app. If you have tried that and still cannot connect, contact us and we will help.
Looker rejected this client ID and secret
Create new API credentials for the API user in Looker, then update them on the connection. Credentials stop working when the user is disabled or the keys are deleted.
A Look is missing from the list
The API user only sees Looks in folders its role can open. Ask a Looker admin to share the folder, or move the Look to a shared folder.
This Look returns several rows per period
The Look splits each period by another dimension and its value is an average or distinct count. Save a Look with one row per period, or follow a count or sum.
This Look no longer returns the value
Someone changed the Look in Looker. Edit the metric in Zentrik and choose the value again.
Continue from here
Related guides
Did this guide answer your question?
Your response helps us prioritize missing or unclear documentation.
Still stuck?
Send your question to Zentrik support. This guide will be included automatically.