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.- Go to Settings → Integrations
- Click Connect next to Slack
- Authorize the TierZero Slack app in your workspace
- 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.| Platform | What You Need |
|---|---|
| Datadog | API key + Application key with read permissions |
| New Relic | User API key |
| Grafana Cloud | Service account token |
| CloudWatch | IAM role with read access |
- Go to Settings → Integrations
- Click Connect next to your observability platform
- Follow the setup wizard and provide the required credentials
- Verify the connection
Step 3: Connect Code
Connect your code hosting platform so TierZero can analyze repositories, commits, and deployments.- Go to Settings → Integrations
- Click Connect next to GitHub, GitLab, or Bitbucket
- 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.- Go to Knowledge → TierZero.md
- Write or paste your organizational context
- Click Save
Step 5: Create Your First Alert Agent
Alert Agents automatically investigate incoming alerts and deliver findings.- Go to Alert Agents in the sidebar
- Click Create Alert Agent
- Select an alert source (e.g., PagerDuty, Datadog, OpsGenie)
- Configure the investigation runbook, which tells TierZero how to investigate
- Set the Slack channel where findings should be posted
- Activate the agent
Step 6: Verify It Works
Trigger a test alert or wait for a real one. When an alert fires:- TierZero receives the alert via webhook
- The Alert Agent follows the investigation runbook
- Findings are posted to the configured Slack channel
- You can ask follow-up questions in the thread