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

# AI Log Assistant

> Ask questions about your logs in plain English and get answers backed by your real data.

The AI Log Assistant lets you ask questions about your logs in plain English and get answers backed by your real data.

Available on **Pro** and **Enterprise** plans.

<img src="https://mintcdn.com/enabo/p9BVVvDSI7cm2Vjn/images/dashboard/ai-assistant.png?fit=max&auto=format&n=p9BVVvDSI7cm2Vjn&q=85&s=f77430e3d2c00dbb657e92009f5d28fa" alt="AI Log Assistant" width="1440" height="900" data-path="images/dashboard/ai-assistant.png" />

## Getting Started

Navigate to the **AI** page from the sidebar. You can type a question or click one of the suggested prompts, which are generated from your live data.

## What You Can Ask

### Error Investigation

* "What errors happened today?"
* "What's causing the 500 errors in my API?"
* "Show me the most common errors this week"

### Trends and Patterns

* "Are errors increasing?"
* "Compare error rates by service"
* "Show me activity trends this week"

### Log Search

* "Find logs mentioning timeout in production"
* "Show me the latest error logs from auth-service"

### Flow Tracing

* "Trace the request with flow ID abc-123"
* "What went wrong in this flow?"

### Infrastructure

* "What services are producing the most logs?"
* "What's my retention policy?"
* "List my API keys"

## Available Tools

The AI assistant has access to 17 tools that connect to your live log data:

| Tool                          | Description                                                          |
| ----------------------------- | -------------------------------------------------------------------- |
| **search\_logs**              | Search and filter logs by level, source, environment, and time range |
| **search\_logs\_fulltext**    | Full-text search with phrases, boolean operators, and exclusions     |
| **count\_logs**               | Count logs matching specific filters                                 |
| **get\_log\_detail**          | Drill into a specific log entry with full stack traces and metadata  |
| **get\_aggregated\_errors**   | Top errors grouped by message with counts                            |
| **get\_metrics**              | Log volume broken down by level with daily comparison                |
| **get\_stats\_over\_time**    | Log statistics grouped by hour or day for trend analysis             |
| **get\_stats\_by\_source**    | Log statistics grouped by source/service                             |
| **get\_flow\_logs**           | Trace multi-step requests by flow ID                                 |
| **list\_sources**             | List available log sources                                           |
| **list\_alert\_rules**        | View configured alert rules                                          |
| **get\_alert\_history**       | Recent alert trigger history                                         |
| **preview\_alert**            | Check what an alert rule would match right now                       |
| **get\_org\_info**            | Organization details, plan, and usage limits                         |
| **list\_api\_keys**           | API keys with usage info                                             |
| **list\_members**             | Team members and roles                                               |
| **list\_alert\_destinations** | Alert notification destinations                                      |

## Smart Suggestions

The assistant generates context-aware suggestions based on your live data:

* If you have errors today, it suggests investigating them
* If error rates are trending up, it highlights the change
* Suggestions adapt to your specific sources and error patterns

After each response, follow-up suggestions appear based on the tools used in the answer.

## Plan Requirements

| Plan       | Access                                   |
| ---------- | ---------------------------------------- |
| Free       | View-only (upsell prompt on interaction) |
| Pro        | Full access                              |
| Enterprise | Full access                              |