> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage Explorer

export const CenteredImage = ({src, alt, width, caption, className}) => {
  const [basePath, setBasePath] = useState("");
  useEffect(() => {
    const path = window.location.pathname;
    setBasePath(path === "/docs" || path.startsWith("/docs/") ? "/docs" : "");
  }, []);
  return <Frame caption={caption} className={className} style={{
    maxWidth: width,
    marginInline: "auto"
  }}>
			<OptimizedImage src={`${basePath}${src}`} alt={alt} />
		</Frame>;
};

The usage explorer allows you to better understand and be able to analyze your usage on Namespace looking at different filters and breakdowns.

## Understanding your usage better

On your [usage page](https://cloud.namespace.so/workspace/usage), there are some breakdowns available that show your usage over the selected period broken down by:

* Purpose i.e. `github-runner`, `builder`
* Platform: `linux/amd64`, `linux/arm64`, `macos/arm64` and `windows/amd64`
* Shape: all shapes run by you appear, more information on shapes [here](/docs/architecture/compute/machine-shapes)
* GitHub Repository: usage per GitHub Repositories
* GitHub User: usage per GitHub User
* GitHub Workflow: usage per GitHub Workflow

You can pick any two breakdown options at the same time.

Clicking on the ‘Explore’ button on the top right will allow you to dive even further into your usage.

<CenteredImage width={800} alt="Explore button on the Usage Explorer page" src="/docs/images/dashboard/usage-explorer-explore-button.png" />

## The usage explorer

The [usage explorer](https://cloud.namespace.so/workspace/usage/explore) allows you to understand your usage over time,
providing you with breakdowns that will help you understand where your usage comes from and how you might be able to optimize it.

Combining multiple breakdowns, filters, displays and periods to drill down your usage can be very powerful.

All those different views can also be downloaded as a csv.

<Tabs>
  <Tab title="Usage Explorer">
    <CenteredImage width={800} alt="Usage with a breakdown per platform, shape and purpose while choosing a shape filter" src="/docs/images/dashboard/usage-explorer-filter.png" caption="Usage with a breakdown per platform, shape and purpose while choosing a shape filter" className="my-0" />
  </Tab>

  <Tab title="Selecting different units">
    <CenteredImage width={800} alt="Options to choose for different units to display the usage" src="/docs/images/dashboard/usage-explorer-units.png" caption="Options to choose for different units to display the usage" className="my-0" />
  </Tab>

  <Tab title="Customized breakdown">
    <CenteredImage width={800} alt="Usage with a breakdown per shape, purpose and GitHub Sender while choosing a date range filter" src="/docs/images/dashboard/usage-explorer-breakdown.png" caption="Usage with a breakdown per shape, purpose and GitHub Sender while choosing a date range filter" className="my-0" />
  </Tab>
</Tabs>