feat(tools/looker): add support for pulse, vacuum and analyze audit and performance functions on a Looker instance (googleapis#1581)

This pull request adds 3 new tools, looker-health-pulse,
looker-health-vacuum, and looker-health-analyze, as capabilities to the
Looker MCP Toolbox. These tools are designed to provide health checks
and auditing analytical insights for a Looker instance (they come from
the popular [Looker CLI tool
Henry](https://github.com/looker-open-source/henry)).

**looker-health-pulse**
This tool performs various health checks on a Looker instance. It can be
used to:
- Check database connection status.
- Identify dashboards with slow-running or erroring queries.
- List slow explores and failed schedules.
- Find enabled legacy features.

**looker-health-analyze**
This tool performs analytical tasks on Looker projects, models, and
explores. It can be used to:
- Analyze projects to check Git status and validation.
- Analyze models to count explores and identify unused ones.
- Analyze explores to find unused joins and fields. *Unused is defined
as not being queried in the last 90 days.*

**looker-health-vacuum**
This tool finds unnused explores, joins, and fields based on user
defined search conditions (namely, timeframe and min query #):
- Identify unnused explores for specific or all models
- Identify unnused fields or joins for specific explores or all explores
within a model

This update targets Looker administrators, as it provides new
capabilities to monitor the health and efficiency of their Looker
instances and connect those capabilities to MCP Clients.

🛠️ Fixes googleapis#1415

---------

Co-authored-by: Luka Fontanilla <maluka@google.com>

Author: drstrangelooker

cmd/root.go

@@ -106,6 +106,9 @@ import (
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetmeasures"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetmodels"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetparameters"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerhealthanalyze"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerhealthpulse"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerhealthvacuum"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookermakedashboard"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookermakelook"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerquery"

cmd/root_test.go

@@ -1489,7 +1489,7 @@ func TestPrebuiltTools(t *testing.T) {
 			wantToolset: server.ToolsetConfigs{
 				"looker_tools": tools.ToolsetConfig{
 					Name:      "looker_tools",
-					ToolNames: []string{"get_models", "get_explores", "get_dimensions", "get_measures", "get_filters", "get_parameters", "query", "query_sql", "query_url", "get_looks", "run_look", "make_look", "get_dashboards", "make_dashboard", "add_dashboard_element"},
+					ToolNames: []string{"get_models", "get_explores", "get_dimensions", "get_measures", "get_filters", "get_parameters", "query", "query_sql", "query_url", "get_looks", "run_look", "make_look", "get_dashboards", "make_dashboard", "add_dashboard_element", "health_pulse", "health_analyze", "health_vacuum"},
 				},
 			},
 		},

docs/en/resources/tools/looker/looker-health-analyze.md

@@ -0,0 +1,63 @@
+---
+title: "looker-health-analyze"
+type: docs
+weight: 1
+description: >
+  "looker-health-analyze" provides a set of analytical commands for a Looker instance, allowing users to analyze projects, models, and explores.
+aliases:
+- /resources/tools/looker-health-analyze
+---
+
+## About
+
+The `looker-health-analyze` tool performs various analysis tasks on a Looker instance. The `action` parameter selects the type of analysis to perform:
+
+- `projects`: Analyzes all projects or a specified project, reporting on the number of models and view files, as well as Git connection and validation status.
+- `models`: Analyzes all models or a specified model, providing a count of explores, unused explores, and total query counts.
+- `explores`: Analyzes all explores or a specified explore, reporting on the number of joins, unused joins, fields, unused fields, and query counts. Being classified as **Unused** is determined by whether a field has been used as a field or filter within the past 90 days in production.
+
+## Parameters
+
+| **field** | **type** | **required** | **description** |
+| :--- | :--- | :--- | :--- |
+| kind | string | true | Must be "looker-health-analyze" |
+| source | string | true | Looker source name |
+| action | string | true | The analysis to perform: `projects`, `models`, or `explores`. |
+| project | string | false | The name of the Looker project to analyze. |
+| model | string | false | The name of the Looker model to analyze. Required for `explores` actions. |
+| explore | string | false | The name of the Looker explore to analyze. Required for the `explores` action. |
+| timeframe | int | false | The timeframe in days to analyze. Defaults to 90. |
+| min_queries | int | false | The minimum number of queries for a model or explore to be considered used. Defaults to 1. |
+
+## Example
+
+Analyze all models in `thelook` project.
+
+```yaml
+tools:
+  analyze-tool:
+    kind: looker-health-analyze
+    source: looker-source
+    description: |
+      Analyzes Looker projects, models, and explores.
+      Specify the `action` parameter to select the type of analysis.
+    parameters:
+      action: models
+      project: "thelook"
+
+Analyze all the explores in the `ecomm` model of `thelook` project. Specifically look at usage within the past 20 days. Usage minimum should be at least 10 queries.
+
+```yaml
+tools:
+  analyze-tool:
+    kind: looker-health-analyze
+    source: looker-source
+    description: |
+      Analyzes Looker projects, models, and explores.
+      Specify the `action` parameter to select the type of analysis.
+    parameters:
+      action: explores
+      project: "thelook"
+      model: "ecomm"
+      timeframe: 20
+      min_queries: 10

docs/en/resources/tools/looker/looker-health-pulse.md

@@ -0,0 +1,55 @@
+---
+title: "looker-health-pulse"
+type: docs
+weight: 1
+description: >
+  "looker-health-pulse" performs health checks on a Looker instance, with multiple actions available (e.g., checking database connections, dashboard performance, etc).
+aliases:
+- /resources/tools/looker-health-pulse
+---
+
+## About
+
+The `looker-health-pulse` tool performs health checks on a Looker instance. The `action` parameter selects the type of check to perform:
+
+- `check_db_connections`: Checks all database connections, runs supported tests, and reports query counts.
+- `check_dashboard_performance`: Finds dashboards with slow running queries in the last 7 days.
+- `check_dashboard_errors`: Lists dashboards with erroring queries in the last 7 days.
+- `check_explore_performance`: Lists the slowest explores in the last 7 days and reports average query runtime.
+- `check_schedule_failures`: Lists schedules that have failed in the last 7 days.
+- `check_legacy_features`: Lists enabled legacy features. (*To note, this function is not available in Looker Core. You will get an error running this command with a Core instance configured.*)
+
+## Parameters
+
+| **field**     | **type** | **required** | **description**                             |
+|---------------|:--------:|:------------:|---------------------------------------------|
+| kind          | string   | true         | Must be "looker-health-pulse"                      |
+| source        | string   | true         | Looker source name                          |
+| action        | string   | true         | The health check to perform                 |
+
+## Example
+
+```yaml
+tools:
+  pulse:
+    kind: looker-health-pulse
+    source: looker-source
+    description: |
+      Pulse Tool
+
+      Performs health checks on Looker instance.
+      Specify the `action` parameter to select the check.
+    parameters:
+      action: check_dashboard_performance
+```
+
+## Reference
+
+| **action**                | **description**                                                                |
+|---------------------------|--------------------------------------------------------------------------------|
+| check_db_connections      | Checks all database connections and reports query counts and errors            |
+| check_dashboard_performance | Finds dashboards with slow queries (>30s) in the last 7 days                 |
+| check_dashboard_errors    | Lists dashboards with erroring queries in the last 7 days                      |
+| check_explore_performance | Lists slowest explores and average query runtime                               |
+| check_schedule_failures   | Lists failed schedules in the last 7 days                                      |
+| check_legacy_features     | Lists enabled legacy features                                                  |

docs/en/resources/tools/looker/looker-health-vacuum.md

@@ -0,0 +1,63 @@
+---
+title: "looker-health-vacuum"
+type: docs
+weight: 1
+description: >
+  "looker-health-vacuum" provides a set of commands to audit and identify unused LookML objects in a Looker instance.
+aliases:
+- /resources/tools/looker-health-vacuum
+---
+
+## About
+
+The `looker-health-vacuum` tool helps you identify unused LookML objects such as models, explores, joins, and fields. The `action` parameter selects the type of vacuum to perform:
+
+- `models`: Identifies unused explores within a model.
+- `explores`: Identifies unused joins and fields within an explore.
+
+## Parameters
+
+| **field** | **type** | **required** | **description** |
+| :--- | :--- | :--- | :--- |
+| kind | string | true | Must be "looker-health-vacuum" |
+| source | string | true | Looker source name |
+| action | string | true | The vacuum to perform: `models`, or `explores`. |
+| project | string | false | The name of the Looker project to vacuum. |
+| model | string | false | The name of the Looker model to vacuum. |
+| explore | string | false | The name of the Looker explore to vacuum. |
+| timeframe | int | false | The timeframe in days to analyze for usage. Defaults to 90. |
+| min_queries | int | false | The minimum number of queries for an object to be considered used. Defaults to 1. |
+
+## Example
+
+Identify unnused fields (*in this case, less than 1 query in the last 20 days*) and joins in the `order_items` explore and `thelook` model
+
+```yaml
+tools:
+  vacuum-tool:
+    kind: looker-health-vacuum
+    source: looker-source
+    description: |
+      Vacuums the Looker instance by identifying unused explores, fields, and joins.
+    parameters:
+      action: explores
+      project: "thelook_core"
+      model: "thelook"
+      explore: "order_items"
+      timeframe: 20
+      min_queries: 1
+```
+
+Identify unnused explores across all models in `thelook_core` project. 
+
+```yaml
+tools:
+  vacuum-tool:
+    kind: looker-health-vacuum
+    source: looker-source
+    description: |
+      Vacuums the Looker instance by identifying unused explores, fields, and joins.
+    parameters:
+      action: models
+      project: "thelook_core"
+     

internal/prebuiltconfigs/tools/looker.yaml

@@ -695,6 +695,56 @@ tools:
           This tool can be called many times for one dashboard_id
           and the resulting tiles will be added in order.
 
+    health_pulse:
+        kind: looker-health-pulse
+        source: looker-source
+        description: |
+          health-pulse Tool
+
+          This tool takes the pulse of a Looker instance by taking
+          one of the following actions:
+            1. `check_db_connections`,
+            2. `check_dashboard_performance`,
+            3. `check_dashboard_errors`,
+            4. `check_explore_performance`,
+            5. `check_schedule_failures`, or
+            6. `check_legacy_features`
+
+    health_analyze:
+        kind: looker-health-analyze
+        source: looker-source
+        description: |
+          health-analyze Tool
+
+          This tool calculates the usage of projects, models and explores.
+
+          It accepts 6 parameters:
+            1. `action`: can be "projects", "models", or "explores"
+            2. `project`: the project to analyze (optional)
+            3. `model`: the model to analyze (optional)
+            4. `explore`: the explore to analyze (optional)
+            5. `timeframe`: the lookback period in days, default is 90
+            6. `min_queries`: the minimum number of queries to consider a resource as active, default is 1
+
+    health_vacuum:
+        kind: looker-health-vacuum
+        source: looker-source
+        description: |
+          health-vacuum Tool
+
+          This tool suggests models or explores that can removed
+          because they are unused.
+
+          It accepts 6 parameters:
+            1. `action`: can be "models" or "explores"
+            2. `project`: the project to vacuum (optional)
+            3. `model`: the model to vacuum (optional)
+            4. `explore`: the explore to vacuum (optional)
+            5. `timeframe`: the lookback period in days, default is 90
+            6. `min_queries`: the minimum number of queries to consider a resource as active, default is 1
+
+          The result is a list of objects that are candidates for deletion.
+
 toolsets:
     looker_tools:
         - get_models
@@ -712,3 +762,6 @@ toolsets:
         - get_dashboards
         - make_dashboard
         - add_dashboard_element
+        - health_pulse
+        - health_analyze
+        - health_vacuum