# Costory Documentation

## Docs

- [Decentralize FinOps with Per-Team Cost Reports](https://docs.costory.io/automate-reporting/decentralize-finops.md): Scale cost visibility across engineering teams by scoping automated reports to each squad. Deliver cloud cost insights via Slack, Teams, or email, no billing console access needed.
- [Event Correlations](https://docs.costory.io/automate-reporting/event-correlation.md): Connect cost spikes to the events that caused them
- [Automate Monthly Cloud Cost Reporting](https://docs.costory.io/automate-reporting/monthly-reviews.md): Stop spending days building monthly cloud cost reports. Use Costory's AI-powered Digest to generate executive summaries, root-cause analyses, and shareable reports in minutes.
- [Track Unit Economics to Justify Cloud Cost Increases](https://docs.costory.io/automate-reporting/unit-economics.md): Link cloud cost increases to business growth by importing usage metrics into Costory and building unit economics formulas. Defend scaling decisions with data.
- [Changelog](https://docs.costory.io/changelog.md): Product updates and announcements
- [Cost Metrics](https://docs.costory.io/docs/cost-metrics.md): How we compute the different metrics on top of your billing data
- [Cloud Cost Currency Conversion](https://docs.costory.io/docs/currency-conversion.md): Cloud cost currency conversion and reporting currency rules for AWS, GCP, Azure, and Datadog in Costory.
- [Billing Data Refresh Schedule and Cloud Cost Data Freshness](https://docs.costory.io/docs/data-refresh.md): Costory's billing data refresh schedule, including the monthly refresh window, manual refresh options, and AWS/GCP billing data freshness.
- [ ](https://docs.costory.io/docs/finops-memes.md)
- [Glossary](https://docs.costory.io/docs/glossary.md): Definitions for FinOps, cloud billing, and Costory-specific terms used throughout this documentation
- [Contracted Cost vs Billed Cost: Savings Plan discount sharing issues](https://docs.costory.io/docs/savings-plan-cost-fluctuation.md): Learn why Contracted Cost gives platform and engineering teams a stable, usage-driven view of AWS and GCP cloud spending, avoiding misleading Savings Plan cost fluctuations.
- [Standard Columns](https://docs.costory.io/docs/standard-columns.md): Costory normalizes billing data from AWS, GCP, Azure, Datadog, and Elastic Cloud into a unified schema. Here is how each column is populated per provider.
- [Cloud Cost Alerts and Budget Monitoring](https://docs.costory.io/features/alerts.md): Set up cloud cost alerts to detect spending spikes, track budgets, and get notified through Slack, Teams, or email before costs get out of control.
- [Cloud Cost Budgets and Budget Alerts](https://docs.costory.io/features/budgets.md): Create monthly cloud cost budgets by team, track versions, and trigger Slack or email budget alerts before overruns.
- [Multi-Cloud Cost Explorer](https://docs.costory.io/features/cost-explorer.md): Explore AWS, GCP & Azure costs in one place. Drill down to root cause, use AI-suggested dimensions, and analyze cost changes with waterfall charts.
- [Explore with context: metrics & events](https://docs.costory.io/features/cost-explorer/events-and-metrics.md): Overlay deploy events, Savings Plan purchases, and custom events on your cost charts. Define formulas to track cost-per-user, ROI, and custom KPIs in Costory's Cost Explorer.
- [Quick Share](https://docs.costory.io/features/cost-explorer/sharing.md): Share any Cost Explorer query with your team in one click. Recipients see exactly what you see, filters, group-bys, date range, and context included.
- [Cloud Cost Dashboards](https://docs.costory.io/features/dashboards.md): Build and share custom dashboards to visualize cloud costs alongside usage metrics, budgets, and business KPIs across AWS, GCP, and Azure.
- [AI-Powered Cloud Cost Digest with Anomaly Detection](https://docs.costory.io/features/digest.md): Automatically surface and triage the cloud cost changes that matter. Digest ranks every significant cost shift by dollar impact and generates AI incident reports with root cause analysis.
- [AI Assistant (MCP)](https://docs.costory.io/features/mcp.md): Connect Claude, VS Code, Cursor, or any MCP-compatible AI assistant to Costory and explore your cloud costs through natural conversation.
- [Automated Slack, Teams & Email Cost Reports](https://docs.costory.io/features/slack-reports.md): Schedule recurring cloud cost reports to Slack, Microsoft Teams, or email. Get multi-cloud cost breakdowns by team, service, and environment delivered where your team already works.
- [Tag & Allocate Cloud Costs](https://docs.costory.io/features/tagging.md): FinOps cost allocation made simple. Merge duplicate tags, allocate untagged resources, and split shared costs across AWS, GCP, and Azure without touching your cloud console.
- [Feature Engineering: Merge & Normalize Cloud Tags](https://docs.costory.io/features/tagging/feature-engineering.md): Automatically merge duplicate cloud tag keys and normalize inconsistent values across AWS, GCP, and Azure. Clean up your cost allocation tags without re-tagging resources.
- [Split Shared Infrastructure Costs Across Teams](https://docs.costory.io/features/tagging/shared-cost-allocation.md): Allocate shared cloud infrastructure costs like Cloud SQL, RDS, or network to teams based on actual usage metrics from Datadog, BigQuery, Snowflake, or Google Sheets.
- [Virtual Dimensions: Allocate Cloud Costs to Teams](https://docs.costory.io/features/tagging/virtual-dimensions.md): Allocate untagged cloud resources to teams, products, or cost centers using rule-based Virtual Dimensions. Composable, retroactive, and built for multi-cloud FinOps.
- [Teams](https://docs.costory.io/features/teams.md): Scope cloud costs, default metrics, and dashboards per team so every stakeholder sees the data that matters to them.
- [Quickstart: How to set up automated cloud cost reporting in 30 minutes](https://docs.costory.io/get-started/quickstart.md): Step-by-step guide to connect AWS, GCP, Azure and Datadog to Costory. Set up automated FinOps Slack & Teams cost reports in 30 minutes, free trial included.
- [Welcome to Costory](https://docs.costory.io/get-started/welcome.md): Cloud cost reporting for DevOps: connect AWS, GCP, and Azure billing, automate FinOps updates, and spend less time on manual cost work.
- [Billing Data](https://docs.costory.io/setup/billing.md): Set up cloud billing data sources in Costory via Terraform or manual configuration. Supports AWS CUR 2.0, GCP BigQuery, Azure Cost Management, Snowflake, and SaaS providers.
- [Aiven Billing Setup](https://docs.costory.io/setup/billing/aiven.md): Connect Aiven billing data to Costory via the Aiven Billing API.
- [Anthropic Billing Setup](https://docs.costory.io/setup/billing/anthropic.md): Connect Anthropic API and subscription billing data to Costory via Admin API key or Terraform.
- [AWS Billing Setup](https://docs.costory.io/setup/billing/aws.md): Connect AWS CUR 2.0 billing data to Costory via CloudFormation, manual setup, or Terraform.
- [Azure Billing Setup](https://docs.costory.io/setup/billing/azure.md): Connect Azure Cost Management exports to Costory via Terraform or manual setup.
- [Confluent Billing Setup](https://docs.costory.io/setup/billing/confluent.md): Connect Confluent Cloud billing data to Costory.
- [Cursor Billing Setup](https://docs.costory.io/setup/billing/cursor.md): Connect Cursor usage and billing data to Costory via Admin API key or Terraform.
- [Datadog Billing Setup](https://docs.costory.io/setup/billing/datadog.md): Connect Datadog usage and billing estimates to Costory.
- [Elastic Cloud Billing Setup](https://docs.costory.io/setup/billing/elastic-cloud.md): Connect Elastic Cloud organization billing to Costory with an Organization API key. Covers setup, historical sync, and what cost grain and dimensions you get in Cost Explorer.
- [Custom Billing Format (FOCUS) in BigQuery](https://docs.costory.io/setup/billing/focus.md): Import any FOCUS-compliant billing data from a BigQuery table into Costory.
- [GCP Billing Setup](https://docs.costory.io/setup/billing/gcp.md): Connect GCP BigQuery billing export with detailed usage costs to Costory via Terraform or manual setup.
- [GCP CUD Metadata](https://docs.costory.io/setup/billing/gcp-cud-metadata.md): Import GCP Committed Use Discount metadata from BigQuery into Costory.
- [Snowflake Billing Setup](https://docs.costory.io/setup/billing/snowflake.md): Connect Snowflake account usage and billing data to Costory using key-pair authentication and a reusable Snowflake integration.
- [Email](https://docs.costory.io/setup/collaboration/email.md): Configure email delivery in Costory for scheduled cloud cost reports and alert notifications.
- [Slack](https://docs.costory.io/setup/collaboration/slack.md): Configure the Costory Slack integration to send scheduled cost reports and alerts to your Slack channels.
- [Microsoft Teams](https://docs.costory.io/setup/collaboration/teams.md): Configure the Costory Microsoft Teams integration to send scheduled reports and alerts to Teams channels.
- [Connect Engineering Events to Costory (GitHub, CI/CD, Custom API)](https://docs.costory.io/setup/events.md): Correlate cloud cost changes with GitHub deploys, CI/CD events, Savings Plan purchases, and custom events via API. Overlay events on cost charts for instant root cause analysis.
- [Send Events from CI/CD Pipelines](https://docs.costory.io/setup/events/ci-cd.md): Post build and deploy events from your CI/CD pipelines to Costory using the Events API.
- [Send Custom Events via API](https://docs.costory.io/setup/events/custom-api.md): Send any event that explains cloud spend to Costory using the Events API and Python.
- [Connect GitHub Events](https://docs.costory.io/setup/events/github.md): Use the GitHub integration to capture deploys, PR merges, and releases as event markers in Costory.
- [Provider Events](https://docs.costory.io/setup/events/provider.md): Automatically track AWS Savings Plans, Reserved Instances, marketplace renewals, and SKU price changes in Costory.
- [Usage & Metrics Providers](https://docs.costory.io/setup/usage-metrics.md): Connect usage metrics data sources in Costory to track unit economics and explain cost changes
- [Amplitude](https://docs.costory.io/setup/usage-metrics/amplitude.md): Bring product analytics metrics from Amplitude into Costory
- [AWS CloudWatch](https://docs.costory.io/setup/usage-metrics/aws-cloudwatch.md): Connect AWS CloudWatch metrics to Costory and import custom usage metrics.
- [BigQuery](https://docs.costory.io/setup/usage-metrics/bigquery.md): Import usage metrics stored in BigQuery tables into Costory
- [CSV](https://docs.costory.io/setup/usage-metrics/csv.md): Upload usage metrics as a flat or columnar CSV file in Costory
- [Datadog](https://docs.costory.io/setup/usage-metrics/datadog.md): Query Datadog metrics with rollups and import them into Costory
- [Datadog CI Visibility](https://docs.costory.io/setup/usage-metrics/datadog-ci.md): Pull CI visibility metrics from Datadog into Costory
- [GCS Inventory (Parquet)](https://docs.costory.io/setup/usage-metrics/gcs-inventory.md): Use GCS inventory Parquet exports as usage metrics in Costory
- [Google Sheet](https://docs.costory.io/setup/usage-metrics/google-sheet.md): Sync usage metrics directly from a Google Sheet into Costory
- [Parquet file (AWS S3)](https://docs.costory.io/setup/usage-metrics/s3-parquet.md): Import Parquet metrics files from AWS S3 into Costory
- [Tsuga](https://docs.costory.io/setup/usage-metrics/tsuga.md): Import metrics, logs, and traces from Tsuga into Costory
- [Allocate the cost of a shared Cloud SQL database to the teams using it](https://docs.costory.io/use-cases/allocate_shared_cloud_sql_database/allocate.md): Use Costory's virtual dimensions and usage metrics to split a shared Cloud SQL database cost across consuming teams, based on actual storage or compute usage.
- [Correlate Cloud Costs with Active Users Using Amplitude](https://docs.costory.io/use-cases/amplitude/cost_per_active_users.md): Understand whether your cloud costs scale with your business. Connect Amplitude active users to Costory and track cost per thousand users over time.
- [Cloud budget management: define and automate cloud budgets](https://docs.costory.io/use-cases/automate_budget.md): Learn how to set up cloud budget management per team with automated alerts, monthly reports, and FinOps budgeting best practices.
- [Automated env allocation](https://docs.costory.io/use-cases/automated_env_allocation/visibility.md): How to easily allocate your costs per environment using all the metadatas available in your billing data
- [Increase visibility on your BigQuery costs with dbt](https://docs.costory.io/use-cases/dbt_bigquery_visibility/increase_visibility.md): Track and allocate BigQuery processing and storage costs at the dbt model level using labels, then visualize them in Costory.
- [AWS EKS & ECS Cost Visibility Without Third-Party Agents](https://docs.costory.io/use-cases/eks_visibility/visibility.md): Get granular Kubernetes cost visibility at the pod label level using AWS native split cost allocation. No third-party agents required.
- [Kubernetes Cost Visibility: Measure Waste, Allocate Costs, Reduce Over-Provisioning](https://docs.costory.io/use-cases/k8s_waste/visibility.md): Kubernetes cost visibility for granular insight into waste, over-provisioned resources, and cost reallocation across teams
- [Overview](https://docs.costory.io/use-cases/overview.md): Explore practical guides to get the most out of Costory
- [Split Shared API Costs Across Teams Using Usage Metrics](https://docs.costory.io/use-cases/reallocate_api_costs.md): Allocate untagged or shared API costs to the right teams based on actual usage data. This guide walks you through usage-based shared cost allocation with Costory, from importing an external metric to building a reusable chargeback model.
- [Share the correct cost for each persona](https://docs.costory.io/use-cases/show_the_correct_cost_metric_to_each_persona.md): Learn how to share the correct cost for each persona
- [Show the correct metrics to your exec team](https://docs.costory.io/use-cases/what_your_exec_team_wants/value.md): Learn how to show the correct metrics to your exec team