Quickstart

This guide walks you through setting up OpsTower from scratch. By the end, you will have a working agent connected to one of your data sources, ready to answer questions about your systems.

1. Sign Up for an Account

OpsTower uses Clerk-based authentication. You can sign up with your email address or through a supported SSO provider.

1. Go to opstowerapp.com and click Sign Up.
2. Create your account using email or a social login provider.
3. Once signed in, you will land on the OpsTower dashboard.

A free tier (Explore plan) is available, so you can start using OpsTower without entering any payment information.

2. Connect Your First Data Source

Agents need data sources to work with. Start by connecting at least one service.

1. Navigate to Connections in the sidebar.
2. Click Add Connection and choose a service to integrate. Good starting points include:
   • PostHog or Amplitude for product analytics
   • Axiom or Cloudflare for application logs
   • GitHub for code repository access
   • Supabase or D1 for database access
3. Follow the on-screen instructions to authorize the connection. Each service has its own authentication flow — typically an API key or OAuth grant.
4. Once connected, the service will appear in your Connections list with a green status indicator.

You can always add more connections later. Agents can use multiple data sources simultaneously.

3. Create Your First Agent

With a data source connected, you can now create an agent.

1. Navigate to Agents in the sidebar.
2. Click Create Agent.
3. Choose an agent type:
   • Debugger — best for investigating errors, tracing issues across logs, code, and databases.
   • Analyst — best for analyzing product analytics, tracking metrics, and detecting trends.
4. Give your agent a name and an optional description.
5. Select an AI model or leave the default (the global default model will be used).
6. Click Create.

4. Enable Connections on Your Agent

Your agent needs access to one or more of your connected data sources.

1. Open your newly created agent.
2. Go to the Connections tab within the agent settings.
3. Toggle on the connections you want the agent to use. For example, enable PostHog if you want the agent to analyze your analytics data, or enable GitHub and Axiom if you want it to debug issues across code and logs.
4. Save your changes.

The agent can now query data from any enabled connection during conversations.

5. Start Chatting

You are ready to interact with your agent.

1. Open your agent and navigate to the Chat view.
2. Ask a question related to your connected data. For example:
   • With an analytics connection: “What were my top events last week?” or “Show me the trend for sign-ups over the past 30 days.”
   • With a logs connection: “Are there any recurring errors in the last 24 hours?”
   • With a code connection: “What changed in the authentication module recently?”
3. The agent will query the relevant data sources and provide an answer with supporting details.

You can ask follow-up questions to drill deeper into any response.

6. (Optional) Set Up Scheduled Reports

If you connected an analytics platform, you can configure automated reports that run on a schedule.

1. Navigate to Reports in the sidebar.
2. Click Create Report and select the analytics connection to use.
3. Configure the report parameters — metrics to track, comparison periods, and anomaly detection sensitivity.
4. Enable daily scheduling and provide an email address for delivery.
5. Save the report.

Reports run automatically and deliver a summary with key metrics, period-over-period comparisons, detected anomalies, and AI-generated insights directly to your inbox.

Next Steps

• Read the Key Concepts page to understand how agents, connections, reports, and knowledge work together.
• Explore the Connections documentation to integrate additional data sources.
• Learn how to add Knowledge to give your agents custom context about your systems.