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

# Chronosphere

The Chronosphere integration can be configured via Chronosphere's and Resolve's UIs.

## Create a Chronosphere Service Account

To access your Chronosphere environment a service account token is needed. If you don’t already have a service account, please create one: [How to create a service account](https://docs.chronosphere.io/administer/accounts-teams/service-accounts).

<Accordion title="Permissions for Restricted Service Accounts">
  Use a "Read-only" Service Account to allow ResolveAI to query data for your investigations.
</Accordion>

When you create a service account, Chronosphere also creates an API token that the service account uses for authentication. Use this API token to integrate with ResolveAI.

## Connect Chronosphere

Set up the integration either in the Resolve UI or in the [Resolve Satellite](/resolve-satellite).

<Tabs>
  <Tab title="Resolve UI">
    ### Connect Via Resolve UI

    1. Open [Chronosphere Integration](https://app0.resolve.ai/integrations/chronosphere/connect) in Resolve
    2. Click **Add Connection**
    3. Enter a name (ex. `Chronosphere-Main`)
    4. Leave **Environments** blank to ingest data from all environments, or list specific ones that match your Satellite config
    5. Paste your API token from the Chronosphere Service Account
    6. Enter your site domain (ex. `https://myorg.chronosphere.io`)
    7. (Optional) Specify dashboard slugs to allowlist. If left blank, all dashboards are accessible by default.
    8. Click **Save**
  </Tab>

  <Tab title="Satellite">
    ### Connect Via Satellite

    Save your Chronosphere token in a Kubernetes secret, then update the Resolve Satellite to use these secrets.

    #### 1. Create Kubernetes Secret

    Create a Kubernetes secret using this structure.

    ```yaml secret creation theme={null}
    apiVersion: v1
    kind: Secret
    type: Opaque
    metadata:
      name: chronosphere-resolve-token
    stringData:
      token: "<your token>"
    ```

    <Warning>
      **Security Best Practice:** Never store credentials in plaintext in configuration files or source control.
      Always use Kubernetes secrets and encrypt etcd or use enterprise secret management systems.
      See [Secret Management](/secret-management) for detailed guidance.
    </Warning>

    Apply the secret.

    ```shell apply secret theme={null}
    kubectl apply -f chronosphere-resolve-token.yml
    ```

    ***

    #### 2. Update Values File

    Add the Chronosphere integration to `resolve-values.yaml`.

    ```yaml resolve-values.yaml theme={null}
    integrations:
      chronosphereOnPrem:
        type: "chronosphere"
        create: true
        secretName: "chronosphere-resolve-token"
        connection:
          site: <yourcompany.chronosphere.io>
    ```

    (Optional) Add [sensitive data redaction](/sensitive-data-redaction) with `redactionConfig`.

    ```yaml resolve-values.yaml theme={null}
    integrations:
      chronosphereOnPrem:
        type: "chronosphere"
        create: true
        secretName: "chronosphere-resolve-token"
        connection:
          site: <yourcompany.chronosphere.io>
          redactionConfig:
            enabled: true
    ```

    ***

    #### 3. Apply Changes

    Update the satellite with the new `resolve-values.yaml` file.

    ```shell theme={null}
    helm upgrade --install resolve-satellite \
      oci://registry-1.docker.io/resolveaihq/satellite-chart \
      --values resolve-values.yaml
    ```

    ***

    #### 4. Verify Integration

    Open [Chronosphere Integration](https://app0.resolve.ai/integrations/chronosphere/connect) and check the connection.
  </Tab>
</Tabs>

***

## Alert Webhooks

1. Open [Chronosphere Integration](https://app0.resolve.ai/integrations/chronosphere/connect) and click the integration in the table.
2. Scroll down and click **Edit**.
3. In **Webhooks** click the `+` button to name and create a new webhook integration.
4. Follow the instructions to add a new webhook integration in Chronosphere
   1. Set up a new **Notifier** by going to Alerts > Notifiers.
   2. Enter the webhook URL from your ResolveAI setup instructions.
   3. Enable the "Notify when Resolved" setting.
   4. Add the new Notifier to your team's **Notification Policy**.