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

# Components

> Learn how to manage components in Cachet.

In Cachet, a component represents any part of your system that can fail. Components are displayed on your status page
and can be grouped together to form component groups.

For example, you may have an "Ingest" component that represents your ingestion service, or a "Database" component that
represents your database service.

You can manage your components by navigating to the "Components" page in the dashboard.

A component has the following properties:

* **Name**: The name of the component.
* **Status**: The current status of the component.
* **Description**: A brief description of the component.
* **Link**: A link to the component, such as a URL to the service.
* **Enabled**: Whether the component is enabled or not.

### Managing Components from the Dashboard

Cachet also provides a simple way of updating your component statuses directly from the Dashboard homepage. Here you can update the status quickly by clicking the appropriate status button rather than navigating through the "Components" page.

<Frame caption="Update Component Statuses">
  <img className="block dark:hidden" src="https://mintcdn.com/cachet/roDiT_3ouFZbM8GY/v3.x/images/component-dashboard-light.png?fit=max&auto=format&n=roDiT_3ouFZbM8GY&q=85&s=063e7ba88bff142aff94729c19ca328c" alt="Manage Components" width="1808" height="1977" data-path="v3.x/images/component-dashboard-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/cachet/roDiT_3ouFZbM8GY/v3.x/images/component-dashboard-dark.png?fit=max&auto=format&n=roDiT_3ouFZbM8GY&q=85&s=cc8cba8d63ad9090ef125e023d1fb650" alt="Manage Components" width="1809" height="1978" data-path="v3.x/images/component-dashboard-dark.png" />
</Frame>

### Component Statuses

Components can have one of four statuses:

* <Tooltip tip="Status ID: 1"><Icon icon="square-1" /></Tooltip> **Operational**: The component is working as expected.
* <Tooltip tip="Status ID: 2"><Icon icon="square-2" /></Tooltip> **Performance Issues**: The component is experiencing performance issues.
* <Tooltip tip="Status ID: 3"><Icon icon="square-3" /></Tooltip> **Partial Outage**: The component is experiencing partial outage.
* <Tooltip tip="Status ID: 4"><Icon icon="square-4" /></Tooltip> **Major Outage**: The component is experiencing a major outage.
* <Tooltip tip="Status ID: 5"><Icon icon="square-5" /></Tooltip> **Unknown**: The component status is unknown.

## Component Groups

To help organize your components, you can group them together into component groups. For example, you may have a
"Services" component group that contains all of your service components.

Cachet will automatically group any ungrouped components together. Ungrouped components are displayed beneath any
component groups on your status page.

## Re-ordering Components

You may reorder components via the dashboard by dragging and dropping them into the desired order. To do this,
head to the "Components" page in the dashboard, click the swap icon (up / down arrows) in the top left of the table to
activate re-ordering mode, and then drag and drop the components into the desired order. Once you're happy with the new
order, click the check icon to save your changes.

Components can also be reordered when editing a component group. The order will remain relative to the specific group.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/cachet/roDiT_3ouFZbM8GY/v3.x/images/component-reordering-light.gif?s=39976aebc034be4262ada019bc11f84c" alt="Reorder Components" width="800" height="496" data-path="v3.x/images/component-reordering-light.gif" />

  <img className="hidden dark:block" src="https://mintcdn.com/cachet/roDiT_3ouFZbM8GY/v3.x/images/component-reordering-dark.gif?s=45ec1cafbb6a6e51110c9553e529df6b" alt="Reorder Components" width="800" height="493" data-path="v3.x/images/component-reordering-dark.gif" />
</Frame>
