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

# Event Correlations

> Connect cost spikes to the events that caused them

<Warning>
  When cloud costs spike, teams scramble to answer: "What changed?" Often the root cause is known (a deployment, new region, or event like Black Friday) but there's no structured correlation between these events and the cost data.
</Warning>

<iframe src="https://cdn.lottielab.com/l/4FSbcgAtFcZSK9.html" title="Embedded content" className="w-full h-96 rounded-xl" />

## How Costory Helps

<Info>
  Costory ingests technical and business events and aligns them with cost timelines.
</Info>

<img src="https://mintcdn.com/costory/VgOY4BJyTDVknUpv/images/event-correlation-timeline.png?fit=max&auto=format&n=VgOY4BJyTDVknUpv&q=85&s=e3c5d0835c4b9ff3bb944b853877ec75" alt="Event Correlation" width="1032" height="555" data-path="images/event-correlation-timeline.png" />

## Supported Inputs

<CardGroup cols={2}>
  <Card title="AWS Commercial Events" icon="aws">
    Savings Plans, Reserved Instances, EDP renewals
  </Card>

  <Card title="GitHub Metadata" icon="github">
    PRs, deploys, labels, and release tags
  </Card>

  <Card title="CI/CD Pipelines" icon="gear">
    Custom events via API integration
  </Card>

  <Card title="Manual Events" icon="calendar-plus">
    Traffic spikes, client onboarding, campaigns
  </Card>
</CardGroup>

<img src="https://mintcdn.com/costory/VgOY4BJyTDVknUpv/images/event-correlation-overview.png?fit=max&auto=format&n=VgOY4BJyTDVknUpv&q=85&s=da2bc56dddb96ae55ed4b35809485579" alt="Event Correlation" width="2048" height="1165" data-path="images/event-correlation-overview.png" />

<Tip>
  All events are timestamped and visualized alongside cost time series. They also improve the accuracy of Digest summaries and ML-driven anomaly detection.
</Tip>

<img src="https://mintcdn.com/costory/VgOY4BJyTDVknUpv/images/event-correlation-detail.png?fit=max&auto=format&n=VgOY4BJyTDVknUpv&q=85&s=f64bf092dea000ecfec55f43afc44dcf" alt="Event Correlation" width="957" height="563" data-path="images/event-correlation-detail.png" />

## Benefits

<CardGroup cols={2}>
  <Card title="Faster Root Cause Analysis" icon="bolt">
    Event-aware timelines speed up investigations
  </Card>

  <Card title="Institutional Memory" icon="brain">
    Build shared context across engineering and finance
  </Card>

  <Card title="Better Explanations" icon="comment-dots">
    Improve accuracy of cost change narratives
  </Card>

  <Card title="Confident Anomaly RCA" icon="shield-check">
    Increase confidence in anomaly root cause analysis
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Connect Events" icon="link" href="/setup/events">
    Set up your event sources in Costory.
  </Card>

  <Card title="Monthly Reviews" icon="calendar" href="/automate-reporting/monthly-reviews">
    Use event context in automated reports.
  </Card>
</CardGroup>