Looker Lineage Connector

Looker Lineage Plus Connector – User Setup

To enable Bigeye to connect to Looker and retrieve data lineage, you will need to create a permission set, role, and user, configure content access, and generate an API key.


1. Create a Permission Set

  1. In the top navigation bar, go to Admin → Roles and click New Permission Set.
  2. Name the permission set: bigeyeperms.
  3. Select the following permissions:
    • access_data.see_lookml_dashboards
    • access_data.see_looks
    • access_data.see_looks.see_user_dashboards
    • access_data.see_looks.explore
    • access_data.see_looks.see_sql
    • access_data.see_lookml
  4. Click New Permission Set to save.

2. Create a Role

  1. In the top navigation bar, go to Admin → Roles and click New Role.
  2. Name the role: bigeyerole.
  3. Select the permission set you created (bigeyeperms).
  4. Select the appropriate Model Set (typically, All).
  5. Click New Role to save.

3. Create a User

  1. In the top navigation bar, go to Admin → Users and click Add Users.
  2. Choose a username/email, for example: [email protected].

    This does not need to be a valid email address.

  3. Uncheck the Send setup emails option.
  4. Assign the role you created (bigeyerole).
  5. Click Add Users to save.

4. Configure Content Access

  1. In the top navigation bar, go to Admin → Content Access.
  2. Bigeye does not read the actual dashboard or look content. We recommend starting with all Content (Shared + Users). You can revoke permissions later if needed.
  3. With the Shared folder selected:
    • Click Manage Access.
    • If All Users does not already have View or Manage/Edit access, add the Bigeye user with View access.
    • Click Save.
  4. Repeat the process for the Users folder.

5. Create an API Key

  1. In the top navigation bar, go to Admin → Users and click Edit on the Bigeye user you created.
  2. Click Edit Keys.
  3. Copy the Client ID and Client Secret.
    • Make sure to unhide the secret before copying.
  4. Save these values securely for later use in Bigeye.

6. Get Your Looker Host URL

  1. In the top navigation bar, go to Admin → Settings.
  2. Copy your Host URL.

Configuration Parameters

The following fields can be configured:

  • looker.location
  • looker.lkml.location
  • looker.authority
  • looker.jersey.api.timeout
  • looker.resource
  • looker.client.id
  • looker.clientid.secret.password
  • looker.include.workspaces / looker.exclude.workspaces
  • looker.git.username
  • looker.git.password
  • looker.git.use.ssh
  • looker.git.ssh.key.directory
  • looker.git.ssh.key.password
  • looker.include.projects / looker.exclude.projects
  • looker.include.models / looker.exclude.models
  • looker.include.dashboards / looker.exclude.dashboards
  • looker.include.folderpaths / looker.exclude.folderpaths
  • looker.exclude.user.folders

Summary of Steps

  1. Create a permission set (bigeyeperms).
  2. Create a role (bigeyerole) and link it to the permission set.
  3. Create a user (e.g., [email protected]).
  4. Grant content access to Shared and Users folders.
  5. Generate an API key (Client ID & Secret).
  6. Retrieve the Looker Host URL.