> ## 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.

# Quickstart: connect your first bill in 30 minutes

> Connect AWS, Google Cloud, Azure or an LLM provider with Terraform, CloudFormation or by hand, then get cost by team in Slack and in Claude. 30-day free trial, no credit card.

New to Costory? Read the [Welcome](https://docs.costory.io/get-started/welcome.md) page for how the product fits DevOps workflows, then follow the steps below.

![Example of weekly cost reporting message sent by Costory](https://mintcdn.com/costory/MPk5hJyiLFQv1UHM/images/slack-report-light.png?fit=max\&auto=format\&n=MPk5hJyiLFQv1UHM\&q=85\&s=c54fb32412db534866bab867cdcbf76a)

Costory's scheduled reports deliver actionable insights on cloud costs directly to your workspace.

Here's what you can expect in 30 minutes:

* Set up your 30-day free trial with your cloud billing data connected.
* Get a unified view of your costs across teams, providers, and environments.
* Receive your first Costory report in your team's inbox (Slack, Teams, or email).

## Prerequisites for Costory cloud cost management setup

* **Cloud billing admin access**: Be a billing admin on your cloud provider account. Marketplace admins can also purchase Costory from the marketplace at the end of onboarding.
* **Slack or Teams app install**: Have your Slack or Teams admin ready to install the Costory app, or hold admin permissions yourself.

## Step 1: Connect your AWS, GCP, Azure billing accounts (10 minutes)

**1. Create your Costory Account: 1 minute**

> [card] [Sign up for Costory](https://app.costory.io/sign-up)
>
> Request a free trial

**2. Connect your cloud billing data: 10 minutes**

Go to [Setup Billing Datasources](https://app.costory.io/datasources/billing)

> [tab] AWS CUR using CloudFormation
>
> ![Setup AWS CUR using CloudFormation Template](https://mintcdn.com/costory/LqFJ666hCOge47VG/images/Setup%20AWS%20CUR%20using%20CloudFormation%20Template.gif?s=5f55ae4ee1682742830995cf50295a29)
>
> Setup AWS CUR using CloudFormation Template
>
> > [!TIP]
> >
> > If you have an existing export, you will be able to import it directly in Costory.
>
> > [!TIP]
> >
> > If you need to create a new report, AWS takes between 6 and 12 hours to export the first file. And 12-24 hours to backfill the historical data. Costory will ping you when your data is ready.

> [tab] GCP Billing Export
>
> Click new datasource and select GCP. You will see your Costory service account email. Share your BigQuery dataset with it using these IAM roles: BigQuery Data Viewer and BigQuery Metadata Viewer.
>
> > [!TIP]
> >
> > The data will be available in Costory within 10 minutes.

> [tab] Azure Billing Export
>
> ![Azure setup](https://mintcdn.com/costory/LqFJ666hCOge47VG/images/Azure%20setup.gif?s=7643d48d8f33da10d9bdf5291ec6d90e)
>
> Azure setup
>
> > [!TIP]
> >
> > If you have an existing export, you will be able to import it directly in Costory.
>
> > [!TIP]
> >
> > If you need to create a new report, Azure takes between 5 and 10 minutes to export the first file. You can then trigger backfills (\~1 hour).

> [tab] Datadog
>
> ![Datadog setup](https://mintcdn.com/costory/LqFJ666hCOge47VG/images/Datadog%20setup.gif?s=5db300c35be3fb3edf2008f8c2d66085)
>
> Datadog setup
>
> > [!TIP]
> >
> > The data will be available in Costory within 10 minutes.

**3. Wait for your data to be ingested: (from 10 minutes to 24 hours depending on your luck but mostly on your provider...)**

Costory will ingest your data and make it available.
Depending on your provider, the first export may take from 10 minutes (GCP, Azure) to several hours (AWS).

## Step 2: Automate your cloud cost reporting (20 minutes)

**1. Create Dimensions: Costory automatically finds your best labels: 5 minutes**

Costory will read your existing labels across providers, suggest merges and mappings to standardize keys and values.

Going from 3 labels: `env`, `environment`, `k8s_label_env` with many different values to a single label: `environment`, with only 3 values: `development`, `staging`, `production`.

You can review those in the [Dimensions page](https://app.costory.io/dimensions), and add more transformations to your labels:

![Dimensions UI showing label values being remapped into a clean dimension](https://mintcdn.com/costory/WRvESdGs0dJNS2oW/images/quickstart/feature-engineering.gif?s=5e4a368ffab44febc9d9d98bb24c45d0)

Dimensions let you merge labels and map values into clean reporting fields

> [!TIP]
>
> Dimensions keep Explorer clean with only the
> meaningful labels and values. They also help our AI assistant better
> understand your data and keep its explanations clear and actionable.

**2. Verify Billing Data: 5 minutes**

Explore the cost using Last Month date preset, or Last invoice month (uses invoice date instead of usage dates).

![Costory Explorer showing last month billing data with cost breakdown, cost distribution, and comparison details](https://mintlify.s3.us-west-1.amazonaws.com/costory/images/quickstart/verify-billing-data.gif)

Check your last month costs and compare them to your invoice

Check that the amounts are correct. Trust the data before building reports on top of it.

Useful docs:

* [Standard Columns](https://docs.costory.io/docs/standard-columns.md): how we normalize raw exports into columns.
* [Cost Metrics](https://docs.costory.io/docs/cost-metrics): the metrics we compute on top of your data.
* [Currency conversion](https://docs.costory.io/docs/currency-conversion.md): how we convert into your reporting currency.

**3. Deploy FinOps Dashboards & Alerts: 10 minutes**

Start from template dashboards instead of building from scratch. Costory templates cover the most common FinOps scenarios, and Costory suggests relevant ones for you.

![Costory dashboard showing FinOps widgets that can be saved and shared with your team](https://mintcdn.com/costory/WRvESdGs0dJNS2oW/images/quickstart/deploy-finops-dashboard-and-alerts.gif?s=a681059ad88df925ee0a64598637dd29)

Start from a template dashboard and customize it to your needs

[Dashboards](https://app.costory.io/dashboards/new) cover Kubernetes cost and waste, EC2 and Savings Plan coverage, network costs, realized savings, and more.

If you connect [Costory MCP](https://docs.costory.io/features/mcp.md), you can also skip the blank canvas: ask Claude or Cursor to "build a dashboard for Kubernetes cost by namespace" and it drafts the widgets for you.

Alert templates notify you when:

* The cost of your R\&D environment is above your production costs.
* The data scientists started two VMs with huge GPU during the week-end.
* Reserved instances are not fully used.
* Your savings plan no longer covers 50% of your costs.
* A mandatory tag is no longer attached to most of your costs.
* Your K8S waste ratio is above 75%.

![Costory alerts page listing active cost alerts for savings plan coverage, Kubernetes waste, and weekly cost changes](https://mintcdn.com/costory/WRvESdGs0dJNS2oW/images/quickstart/alerts-overview.png?fit=max\&auto=format\&n=WRvESdGs0dJNS2oW\&q=85\&s=931ca5f6a165e0c8487b74acbfd40ba4)

Review active alerts for common FinOps scenarios

**4. Automate Slack and Teams Cost Reports: Share costs with your team: 5 minutes**

Teams own cloud costs once they can see them.

Share a weekly and a monthly report via Slack, Teams, or email. You can share any view:

* [Cost per environment](https://docs.costory.io/use-cases/automated_env_allocation/visibility.md)
* Service name with cost changes over the last week.
* [Monthly cost per daily active users](https://docs.costory.io/use-cases/amplitude/cost_per_active_users.md)

  ![Costory report builder showing a cost per service report configured for recurring delivery](https://mintcdn.com/costory/WRvESdGs0dJNS2oW/images/quickstart/create-reports.gif?s=8ec4ff8da807babfd9ddcbf206ddd9ee)

  Create and schedule a recurring report from a Costory view

![Example of weekly cost reporting message sent by Costory](https://mintcdn.com/costory/MPk5hJyiLFQv1UHM/images/slack-report-light.png?fit=max\&auto=format\&n=MPk5hJyiLFQv1UHM\&q=85\&s=c54fb32412db534866bab867cdcbf76a)

Your first Costory report delivered directly to your team's inbox.

Connect easily with your team. We support:

> [tab] Slack
>
> Go to [Integrations](https://app.costory.io/integration/). Connect the Costory App to your Slack.
>
> ![Slack authorization flow for installing the Costory app in a workspace](https://mintcdn.com/costory/WRvESdGs0dJNS2oW/images/quickstart/setup-slack.gif?s=e895cb94fa0f657aa139837d36272875)
>
> Setup Slack integration

> [tab] Teams
>
> Go to [Integrations](https://app.costory.io/integration/). Download the zip from Integrations, then upload it in Teams Admin Center > Manage Apps

> [tab] Email
>
> No setup required, you can use it right away.

## Next Steps

Here's what most of our customers do in their first week:

* Invite teammates: click the **account name** in the left sidebar, then **Invites** (Admins). See [Settings](https://docs.costory.io/get-started/settings.md#invite-users).
* Set up alerts: [check our templates](https://app.costory.io/alerts/new)
* [Calculate your cost per environment](https://docs.costory.io/use-cases/automated_env_allocation/visibility.md)
* [Show the correct metrics to your exec team](https://docs.costory.io/use-cases/what_your_exec_team_wants/value.md)
* [Connect a business metric to understand your marginal costs](https://docs.costory.io/use-cases/amplitude/cost_per_active_users.md).

### Need help?

We're here to help. Reach out to us at [support@costory.io](mailto:support@costory.io), or open **Support & Changelog** in the left sidebar, then **Talk to a human**.&#x20;


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.