docs/en/integrations/looker/tools/looker-health-analyze.md
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.{{< compatible-sources >}}
| field | type | required | description |
|---|---|---|---|
| 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. |
kind: tool
name: health_analyze
type: looker-health-analyze
source: looker-source
description: |
This tool calculates the usage statistics for Looker projects, models, and explores.
Parameters:
- action (required): The type of resource to analyze. Can be `"projects"`, `"models"`, or `"explores"`.
- project (optional): The specific project ID to analyze.
- model (optional): The specific model name to analyze. Requires `project` if used without `explore`.
- explore (optional): The specific explore name to analyze. Requires `model` if used.
- timeframe (optional): The lookback period in days for usage data. Defaults to `90` days.
- min_queries (optional): The minimum number of queries for a resource to be considered active. Defaults to `1`.
Output:
The result is a JSON object containing usage metrics for the specified resources.
| field | type | required | description |
|---|---|---|---|
| type | string | true | Must be "looker-health-analyze" |
| source | string | true | Looker source name |
| description | string | true | Description of the tool that is passed to the LLM. |