Skip to content

feat(billing): Update documentation surrounding on-demand budgets #4808

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 17 commits into from
Apr 4, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 30 additions & 13 deletions src/docs/product/accounts/pricing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Capacity is the total number of events sent by and billed to your organization.

#### On-Demand Capacity

On-demand capacity is billed at the end of each billing cycle. You are charged per processed event, rounded up to the nearest cent. You have the ability to set on-demand caps so you can stay on budget. See [On-demand spending cap](#on-demand-cap) for more information.
On-demand capacity is billed at the end of each billing cycle. You are charged per processed event, rounded up to the nearest cent. You have the ability to set on-demand caps so you can stay on budget. Your on-demand capacity is determined by your on-demand budget, which can be configured on either a shared or per-category (errors, transactions, attachments) basis. Learn more in [On-Demand Budgets](#on-demand-cap).

#### Prepaid (Reserved) Capacity

Expand All @@ -40,9 +40,23 @@ The second is the **On-Demand Period**. The On-Demand Period reflects a one mont

### Billing Controls

#### On-Demand Spending Cap {#on-demand-cap}
#### On-Demand Budgets {#on-demand-cap}

You can set a maximum monthly on-demand bill amount by setting an on-demand spending cap. Once you reach the spending cap, you will still be able to access Sentry and prior event data. However, any additional events you send will be rejected.
You can set a maximum monthly on-demand invoice amount by setting an on-demand budget. Once you reach the maximum budget capacity, you will still be able to access Sentry and prior event data. However, any additional events you send will be rejected.

<Note>

Per-category on-demand budgets are only available on plans with [performance monitoring](/product/performance/) features and if you're in the Early Adopter program.
If you opt out of the Early Adopter program while on the per-category on-demand budget strategy, you'll retain the per-category budgets you've set and the ability to update them. However, if you switch to the shared on-demand budget strategy, you won't be able to switch back unless you opt in to the Early Adopter program again.
Customers on plans without performance monitoring can only use the shared on-demand budget strategy.

</Note>
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@imatwawana There are changes to how the new on-demand budget feature will be rolled out. We aim to roll this out to customers on the performance plan, and are also on the early adopters program.

In addition, if they are using the per-category on-demand budget strategy, they'll retain this configuration regardless if they are on the Early Adopters program or not.

I updated this note to reflect that. I'm unsure if the language here is sufficient.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When you say they'll retain the configuration, do we mean that they just retain the per-category budget they've already set up? Or could they make changes to their per-category budget?

And if they switch to shared, I assume we mean that they can't go back to per-category?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@imatwawana

When you say they'll retain the configuration, do we mean that they just retain the per-category budget they've already set up? Or could they make changes to their per-category budget?

They'll be able to do both.

So if they:

  1. enabled early adopters feature in the past,
  2. switched to per-category on-demand budget strategy, and
  3. opted out of early adopters afterwards,

they remain on the per-category on-demand budget.

Customers on the performance plans may only be able to opt into per-category on-demand budget only if they're opted into the Early Adopter program.

And if they switch to shared, I assume we mean that they can't go back to per-category?

They'll be unable to switch back to per-category as long as they're opted out of Early Adopters.


You have two choices for setting your on-demand budget strategy:

- **Shared:** Your on-demand budget is shared among errors, transactions, and attachments.

- **Per-category:** Separate on-demand budgets for errors, transactions, and attachments. Any overages in one category will not consume the budget of another category.

#### Rate Limits

Expand Down Expand Up @@ -309,19 +323,19 @@ The slider on the [pricing](https://sentry.io/pricing/) page allows you to choos

Downgrades and cancellations are processed as the end of the current contract cycle and cannot be refunded.

#### What happens if I continue to send events after my on-demand spending cap is consumed?
#### What happens if I continue to send events after my on-demand budget is consumed?

All additional events are rejected.

#### If I raise my on-demand spending cap mid-month, when will my organization start accepting events again?
#### If I raise my on-demand budget mid-month, when will my organization start accepting events again?

Your organization will start accepting additional events as soon as your new cap is applied. We guarantee new caps will be applied within 24 hours. However, in most cases your organization will start accepting events within minutes.
Your organization will start accepting additional events as soon as your new budget is applied. We guarantee new budgets will be applied and effective within 24 hours. However, in most cases your organization will start accepting events within minutes.

#### If I lower my on-demand spending cap mid-month below this month’s existing bill, when will the new cap take effect? What will my on-demand bill be?
#### If I lower my on-demand budget mid-month below this month’s existing bill, when will the new budget take effect? What will my on-demand bill be?

We guarantee your new, lowered on-demand spending cap will be applied within 24 hours. In the meantime, the old on-demand spending cap will remain in effect. However, in most cases, the new spending cap will be applied within minutes.
We guarantee your new, lowered on-demand budget will be applied within 24 hours. In the meantime, the old on-demand budget will remain in effect. However, in most cases, the new budget will be applied within minutes.

After the new spending cap is in effect, all additional events will be rejected and no additional on-demand capacity will be added. At end of billing month, you will be charged for any on-demand capacity consumed.
After the new budget is in effect, all additional events will be rejected and no additional on-demand capacity will be added. At end of billing month, you will be charged for any on-demand capacity consumed.

#### If I want to cancel monthly billing, what happens?

Expand All @@ -340,6 +354,7 @@ You must have either `Billing` or `Owner` permissions to access and/or make chan
#### Why am I being charged for sales tax?

As of December 1, 2020, customers with a US-based billing address may be subject to state and local sales tax. Sales tax will apply to billing addresses located in the following states/localities:

- Connecticut
- District of Columbia
- Massachusetts
Expand All @@ -360,11 +375,13 @@ No. We do not adjust the billing or invoicing of a closed billing period. Any pr
#### Do I qualify for a tax exemption?

If your company or non-profit organization qualifies for a sales tax exemption, you can reach out to [email protected] with the following information to have sales tax removed from any future invoices:
- Organization Name
- Copy of a signed tax exempt certificate

- Organization Name
- Copy of a signed tax exempt certificate

#### I submitted an exemption form, why am I still being charged sales tax?

Taxes could still be included in your bill if either:
- The exemption certificate was still in review after the billing period was closed
- The exemption certificate covers a state that is different from your billing address

- The exemption certificate was still in review after the billing period was closed
- The exemption certificate covers a state that is different from your billing address
4 changes: 2 additions & 2 deletions src/docs/product/accounts/quotas/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -150,11 +150,11 @@ If this is your first time exceeding quota, however, you'll be entered into a on

### On-Demand Capacity

If you need to increase your event quota temporarily, we recommend that you add or increase on-demand capacity. This is ideal for situations like rolling out a new version of your application where you anticipate more events for the month. To add on-demand capacity, you enter a monthly maximum spending cap. Learn more about [on-demand capacity](/product/accounts/pricing/#on-demand-capacity) in our pricing documentation.
If you need to increase your event quota temporarily, we recommend that you add or increase on-demand capacity. This is ideal for situations like rolling out a new version of your application where you anticipate more events for the month. To add on-demand capacity, you enter a monthly maximum budget on either a shared or per-category (errors, transactions, and attachments) basis. Learn more about [on-demand capacity](/product/accounts/pricing/#on-demand-capacity) in our pricing documentation.

### Reserved Capacity

If the number of events you need is steadily increasing, you may want to increase your reserved capacity. Reserved capacity is less expensive than on-demand capacity since you prepay for it. It also allows you to choose the number of events that you want to have available rather than just setting a maximum spending cap. Learn more about [reserved capacity](/product/accounts/pricing/#prepaid-reserved-capacity) in our pricing documentation.
If the number of events you need is steadily increasing, you may want to increase your reserved capacity. Reserved capacity is less expensive than on-demand capacity since you prepay for it. It also allows you to choose the number of events that you want to have available beforehand rather than just setting an arbitrary on-demand budget. Learn more about [reserved capacity](/product/accounts/pricing/#prepaid-reserved-capacity) in our pricing documentation.

You shouldn't increase your reserved capacity if you think your need for more events is temporary, since [reducing your reserved capacity is tied to your billing cycle](#decreasing-quotas).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@ Many times, an unexpected spike is caused by a new error (or errors) introduced

If an account depletes its event capacity and has never previously triggered a grace period, we continue to accept events for the next three days at a maximum rate of 10,000 events per hour. If you choose not to increase your capacity, Sentry will stop accepting events for the remainder of the current billing month. However, if you increase your capacity, events accepted during the grace period will be counted as consumed capacity.

Once you've used your grace period, we recommend using our on-demand spending caps to ensure you have time to adjust your capacity in the event of a future spike in errors.
Once you've used your grace period, we recommend setting up an on-demand budget to ensure you have time to adjust your capacity in the event of a future spike in errors.

Also, consider doing the following:

Expand Down