Skip to main content
Connect engineering events to Costory so you can correlate cost changes with GitHub deploys, CI/CD runs, provider commitments, and custom API events. This makes root cause analysis faster and gives your team shared context in Explorer and the Events page.
Events show up as timeline markers in Costory. You can filter by source, category, and labels to explain cost changes in seconds.
Costory dashboard contextualized with events on cost charts

​
Supported event sources

GitHub deploys

Pull request merges, releases, and deployment metadata.

CI/CD pipelines

Post build and deploy events directly from your pipelines.

Custom API events

Send any event that explains spend via the Events API.

Provider events

AWS live; Azure and GCP on the roadmap.

​
How events work in Costory

  1. Connect a source (GitHub, CI/CD, or API).
  2. Categorize events as BUSINESS, TECHNICAL, or PROVIDER.
  3. Save events with context so the date, source, labels, and description are available from the Events page.
  4. Overlay events on cost charts for fast in Explorer.
  5. Share context in saved views, dashboards, and Cost Reports.

​
Event categories

Costory groups events into three categories so you can filter consistently across teams:
CategoryWhat it representsExamples
BUSINESSGo-to-market or product eventsLaunches, pricing changes, marketing campaigns
TECHNICALEngineering and infrastructure changesDeploys, incidents, migrations, CI/CD runs
PROVIDERCloud provider and billing changes purchases, activations, price changes

​
Frequently asked questions

GitHub and provider events typically appear within minutes. API events appear as soon as they are accepted by the Events API.
Yes. Post events with historical timestamps and Costory will place them on the correct date in your cost timeline.
No. Events are metadata overlays only. They help explain costs but do not modify billing data.
Yes. Use category, label, source, and environment filters in the Events page and in Explorer views.

​
Next steps

Add Usage Metrics

Combine events with KPIs for full context.

Events

Save, filter, and manage event context.

Explore costs

See how events drive cost changes in your dashboards.
Last modified on June 24, 2026