Skip to main content

Overview

This guide walks you through the essential steps to get TierZero operational. By the end, you’ll have your first Alert Agent running and investigating real alerts.

Step 1: Connect Slack

Slack is how TierZero communicates with your team, making it the first integration you should set up.
  1. Go to Settings → Integrations
  2. Click Connect next to Slack
  3. Authorize the TierZero Slack app in your workspace
  4. Verify the integration shows as Connected
TierZero uses Slack to join incident channels, respond to questions, and deliver investigation results. See Slack Integration for full details.

Step 2: Connect Observability

Connect at least one observability platform so TierZero can query logs, metrics, and traces.
PlatformWhat You Need
DatadogAPI key + Application key with read permissions
New RelicUser API key
Grafana CloudService account token
CloudWatchIAM role with read access
  1. Go to Settings → Integrations
  2. Click Connect next to your observability platform
  3. Follow the setup wizard and provide the required credentials
  4. Verify the connection

Step 3: Connect Code

Connect your code hosting platform so TierZero can analyze repositories, commits, and deployments.
  1. Go to Settings → Integrations
  2. Click Connect next to GitHub, GitLab, or Bitbucket
  3. Install the app and grant access to the repositories you want TierZero to analyze

Step 4: Write Your TierZero.md

TierZero.md is a markdown document that gives TierZero context about your organization, including your architecture, services, escalation procedures, and conventions.
  1. Go to Knowledge → TierZero.md
  2. Write or paste your organizational context
  3. Click Save
See TierZero.md for a detailed guide on what to include.

Step 5: Create Your First Alert Agent

Alert Agents automatically investigate incoming alerts and deliver findings.
  1. Go to Alert Agents in the sidebar
  2. Click Create Alert Agent
  3. Select an alert source (e.g., PagerDuty, Datadog, OpsGenie)
  4. Configure the investigation runbook, which tells TierZero how to investigate
  5. Set the Slack channel where findings should be posted
  6. Activate the agent
See Alert Agent for full setup details.

Step 6: Verify It Works

Trigger a test alert or wait for a real one. When an alert fires:
  1. TierZero receives the alert via webhook
  2. The Alert Agent follows the investigation runbook
  3. Findings are posted to the configured Slack channel
  4. You can ask follow-up questions in the thread

What’s Next?