Skip to main content

​
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
  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