---
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**                                                                            |
|:------------|:---------|:-------------|:-------------------------------------------------------------------------------------------|
| 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

```yaml
tools:
  health_analyze:
    kind: 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.
```

## Reference

| **field**   | **type** | **required** | **description**                                    |
|-------------|:--------:|:------------:|----------------------------------------------------|
| kind        |  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. |
