> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bronto.io/llms.txt
> Use this file to discover all available pages before exploring further.

# BrontoScope

> Investigate error events automatically with BrontoScope, an AI-powered tool that identifies scope, root causes, and next steps without writing queries.

BrontoScope enables **automatic AI-powered error investigation** directly from your logs. Instead of manually querying and correlating data, BrontoScope analyzes error events for you and delivers a structured report in seconds.

No prompts. No setup. Just click and investigate.

***

## Overview

When you encounter an error event in your logs, BrontoScope can:

* Analyze the event across multiple dimensions
* Correlate signals from logs, services, and infrastructure
* Identify patterns and anomalies
* Generate a clear, actionable report

All in **under 10 seconds**.

***

## How It Works

1. Navigate to your logs and locate an error event
2. Click the event to open the **event panel**
3. Select **Investigate with AI**
4. BrontoScope automatically runs a multi-step analysis
5. Review the generated report and supporting data

***

## What BrontoScope Analyzes

### 1. Problem Scope

BrontoScope determines the full impact of the error, including:

* When the issue started
* Whether the issue is ongoing or resolved
* Affected:
  * Users
  * Services
  * Hosts
  * Regions (if applicable)

This helps you quickly understand **blast radius and urgency**.

***

### 2. Likely Causes

The AI evaluates patterns and correlations to suggest potential root causes, such as:

* Network instability or latency spikes
* Sudden traffic increases or load imbalance
* Recent deployments or configuration changes
* Application-level bugs or exceptions

These insights are **hypothesis-driven**, not guesses — each is backed by observed data patterns.

***

### 3. Recommended Next Steps

BrontoScope provides actionable guidance to move forward, including:

* Suggested queries to run
* Services or systems to inspect
* Metrics to validate
* Additional logs or time windows to review

This reduces time-to-resolution by guiding your investigation.

***

### 4. Supporting Evidence

Every conclusion is backed by transparent data:

* Underlying queries executed by the AI
* Relevant log samples
* Generated charts and trends
* Time-based comparisons

You can **validate, refine, or extend** the investigation at any time.

***

## Key Benefits

### No Prompt Required

BrontoScope requires **zero input from the user**. It:

* Understands the context of the selected error
* Determines relevant queries automatically
* Executes a full investigation workflow

***

### Fast Time to Insight

* Results delivered in **under 10 seconds**
* Eliminates manual querying and correlation
* Reduces mean time to detection (MTTD) and resolution (MTTR)

***

### Explainable AI

Unlike black-box systems, BrontoScope shows:

* How conclusions were reached
* What data was used
* Which queries were executed

This ensures **trust and auditability**.

***

## When to Use BrontoScope

Use BrontoScope whenever you:

* Encounter a new or unfamiliar error
* Need to quickly assess impact
* Want to validate whether an issue is widespread
* Are debugging production incidents
* Need a starting point for deeper investigation

***

## Best Practices

* Start with the **first occurrence** of an error for cleaner insights
* Compare multiple investigations if the issue evolves over time
* Use the generated queries to drill deeper into specific hypotheses
* Combine with dashboards and alerts for full observability coverage

***

## Limitations

* Results depend on available log and telemetry data
* AI-generated causes are **probabilistic**, not guaranteed root causes
* Complex multi-system failures may require further manual investigation

***

## Summary

BrontoScope transforms error investigation from a manual, time-consuming process into an **instant, AI-driven workflow**.

By combining automated analysis, clear explanations, and actionable insights, it enables teams to:

* Detect issues faster
* Understand impact immediately
* Resolve incidents more efficiently