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

# Chronosphere

> Cloud-native observability platform for metrics and monitoring

## Overview

Connect your Chronosphere environment to give TierZero access to your metrics, dashboards, and alerting data. TierZero queries Chronosphere during investigations to analyze service health, correlate metrics with incidents, and surface relevant dashboards.

## Prerequisites

* Administrative access to your Chronosphere environment
* Permission to create service accounts

## Setup Instructions

### Step 1: Create a Chronosphere Service Account

1. In Chronosphere, create a service account following [Chronosphere's service account documentation](https://docs.chronosphere.io/administer/accounts-teams/service-accounts)
2. Use a **Read-only** service account, as TierZero only needs query access
3. Copy the API token that is generated when the service account is created

### Step 2: Navigate to Integration Settings

1. Log into your TierZero dashboard
2. Go to **Settings → Integrations**
3. Click **Connect** next to Chronosphere

### Step 3: Configure the Connection

1. Enter a **Connection Name** (e.g., "Chronosphere-Main")
2. Paste your **API Token** from the Chronosphere service account
3. Enter your **Site Domain** (e.g., `https://myorg.chronosphere.io`)
4. Optionally specify **Dashboard Slugs** to allowlist specific dashboards. If left blank, all dashboards are accessible
5. Click **Save**

### Step 4: Configure Alert Webhooks (Optional)

To receive Chronosphere alerts in TierZero:

1. Open the Chronosphere integration page in TierZero and click your connection
2. Click **Edit** in the Webhooks section
3. Click **+** to create a new webhook
4. In Chronosphere, go to **Alerts → Notifiers** and create a new Notifier
5. Enter the webhook URL from TierZero
6. Enable **Notify when Resolved**
7. Add the Notifier to your team's Notification Policy

## What TierZero Accesses

* **Metrics**: Query and analyze timeseries metrics
* **Dashboards**: Access dashboard configurations and panel data
* **Alerts**: Receive alert notifications via webhook

## Security

* TierZero uses a **read-only service account** with no elevated privileges
* API tokens are encrypted at rest and in transit
* Revoke access at any time by deleting or disabling the service account in Chronosphere

## Troubleshooting

### Connection Fails

* Verify the site domain is correct (include `https://`)
* Check that the API token is valid and the service account is active
* Ensure the service account has read permissions

### Dashboards Not Visible

* If you specified dashboard slugs, verify they match the actual slugs in Chronosphere
* Clear the dashboard slugs field to allow access to all dashboards