> ## 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. Cachet displays components on your status
page, and you can group them into 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 five 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. Cachet displays ungrouped components beneath any
component groups on your status page.

## Reordering 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 and down arrows) in the top left of the table to
activate reordering 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.

You can also reorder components 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>
