Skip to content

Key Concepts

This page covers the foundational concepts behind OpsTower. Understanding these building blocks will help you get the most out of the platform.

Agents are the core of OpsTower. Each agent is an autonomous assistant that connects to your data sources, answers questions, and performs investigations on your behalf.

OpsTower offers two agent types, each specialized for a different operational need:

Debugger agents are built for investigating errors and tracing issues across your stack. They can query logs, search through code repositories, and run database queries to piece together what went wrong and why.

Typical use cases for Debugger agents:

  • Investigating production errors by correlating log entries with recent code changes.
  • Tracing a bug from a user-facing symptom through application logs to the root cause.
  • Querying database records to verify data integrity when an issue is reported.

Analyst agents are built for analytics and trend analysis. They monitor your product metrics, detect anomalies, and surface changes that matter.

Typical use cases for Analyst agents:

  • Tracking key product metrics like sign-ups, conversions, or retention over time.
  • Detecting sudden spikes or drops in user activity.
  • Generating periodic summaries comparing current performance against previous periods.

Each agent can be customized with:

  • Multiple connections — enable any combination of your connected data sources.
  • A specific AI model — override the global default model for this agent.
  • Knowledge items — attach custom context to help the agent understand your systems.

Connections are integrations between OpsTower and your external services. They allow agents to read data from your analytics platforms, log providers, databases, and code repositories.

Connections fall into four categories:

Integrate with product analytics platforms to give Analyst agents access to event data, user behavior, and product metrics.

ServiceDescription
PostHogOpen-source product analytics
AmplitudeProduct analytics and event tracking
GA4Google Analytics 4

Connect log aggregation services so Debugger agents can search and analyze your application logs.

ServiceDescription
AxiomLog management and observability
CloudflareCloudflare Workers and CDN logs
Google CloudGoogle Cloud Logging
AWS CloudWatchAWS monitoring and log management

Grant agents read access to your databases for data verification and investigation queries.

ServiceDescription
D1Cloudflare D1 serverless SQL database
SupabaseOpen-source Firebase alternative (PostgreSQL)
Generic SQLAny SQL database via connection string
DynamoDBAWS managed NoSQL database
FirestoreGoogle Cloud NoSQL document database

Connect your code repositories so agents can search through source code, review recent changes, and correlate code modifications with production issues.

ServiceDescription
GitHubSource code repositories and commit history

Reports are automated analytics summaries generated by OpsTower. They are designed to keep you informed about your product’s performance without requiring manual analysis.

Each report includes:

  • Key metrics — the numbers that matter most for your product.
  • Period-over-period comparisons — how current values compare to the previous period.
  • Anomaly detection — automatic identification of unusual patterns or sudden changes.
  • AI-generated insights — plain-language explanations of what the data means and what might need attention.

Reports can be scheduled to run daily and delivered via email, so your team starts each day with a clear picture of how things are going.

Reports are tied to analytics connections (PostHog, Amplitude, GA4). You can create multiple reports with different configurations and delivery schedules.

Knowledge allows you to provide agents with custom context about your systems, products, and processes. This helps agents give more relevant and accurate responses.

There are three types of knowledge:

Write plain text descriptions directly in the OpsTower interface. Use this for quick context like:

  • Descriptions of your product architecture.
  • Team conventions and naming standards.
  • Known issues or ongoing incidents.

Upload documents in PDF, TXT, or Markdown format. This is useful for:

  • Technical design documents.
  • Runbooks and standard operating procedures.
  • Architecture diagrams and system documentation.

Link an existing OpsTower report as a knowledge source. This gives agents access to your latest analytics data as background context when answering questions, combining real-time data access with historical trend awareness.

OpsTower supports multiple AI model providers, giving you flexibility in choosing the right model for your needs.

  • Anthropic — Claude model family.
  • OpenAI — GPT model family.
  • Google — Gemini model family.

You can configure AI models at two levels:

  • Global default — set a default model in your account settings that applies to all agents unless overridden.
  • Per-agent override — assign a specific model to an individual agent, useful when different tasks benefit from different model strengths.

OpsTower offers three pricing tiers to match teams of different sizes and needs.

The free tier is designed for individuals and small teams getting started with operational agents. It includes access to core features with usage limits on the number of agents, connections, and interactions.

The Pro tier is built for growing teams that need more capacity. It raises the limits on agents, connections, and report scheduling, and unlocks additional configuration options.

The Business tier is designed for larger teams with advanced requirements. It includes the highest usage limits, priority support, and additional administrative controls for team management.


  • Follow the Quickstart guide to set up your first agent.
  • Browse the Connections documentation to see all available integrations.
  • Learn how to configure Reports for automated analytics delivery.