Insights

Insights provides analysis and exploration tools for understanding your Terraform-managed infrastructure. Track changes over time, search across resources, analyze impact, and visualize dependencies.

Features

Timeline

Track every change to your Terraform state:

  • Transaction history with timestamps
  • User activity tracking
  • Filter by date range or user
  • See exactly what changed

View Timeline

Find resource instances across all your states by field:

  • Filter by type, module, provider, or address
  • Match attribute values
  • Search spans every state
  • Jump straight to instance details, blast radius, or the graph

Use Search

Blast Radius

Understand the impact of changing a resource:

  • See all dependent resources
  • Identify high-impact changes
  • Plan modifications safely
  • Visualize impact scope

Learn Blast Radius

Graph Explorer

Interactive dependency visualization:

  • Pan and zoom
  • Click to select resources
  • Filter by type or module
  • Trace dependency chains

Explore Dependencies

In the Stategraph UI, the Insights section is accessible from the left sidebar:

Insights
├── Timeline      → Transaction history
├── Search        → Find instances by field
├── Blast Radius  → Impact analysis
└── Graph         → Dependency visualization

Use Cases

Change Tracking

Use Timeline to:

  • Review what changed and when
  • Identify who made changes
  • Audit infrastructure modifications
  • Debug unexpected state changes

Resource Discovery

Use Search to:

  • Find resources by name or type
  • Locate configuration values
  • Cross-reference across states
  • Quick navigation to resources

Change Planning

Use Blast Radius to:

  • Assess impact before making changes
  • Identify critical dependencies
  • Plan safe modification order
  • Communicate scope to stakeholders

Architecture Understanding

Use Graph Explorer to:

  • Visualize resource relationships
  • Understand module structure
  • Identify isolated resources
  • Document infrastructure

Quick Start

1. View Recent Changes

Navigate to Insights > Timeline to see recent transactions:

  • Each row shows a state change
  • Click to expand and see details
  • Filter by time period

2. Search for Resources

Use Insights > Search to find resources:

  • Type a resource name or type
  • Results appear instantly
  • Click to navigate to resource

3. Check Impact

Before changing a resource, use Blast Radius:

  1. Select a state
  2. Choose a resource
  3. View dependent resources
  4. Assess change impact

4. Explore Dependencies

Use Graph Explorer to visualize:

  1. Select a state
  2. View the dependency graph
  3. Click nodes to see details
  4. Filter to focus on specific resources

Insights vs Inventory

Insights focuses on analysis and exploration:
- Timeline, Search, Blast Radius, Graph Explorer
- Answering "what happened?" and "what if?"

Inventory focuses on cataloging and querying:
- Instances, Modules, Types, Query, Dashboards, Gap Analysis
- Answering "what do we have?"

Documentation

Topic Description
Timeline Transaction history
Search Find instances by type, module, provider, address
Blast Radius Impact analysis
Graph Explorer Dependency visualization
Dashboard Metrics Metrics on the home Infrastructure Overview dashboard