Как настроить лимиты расходов для сервисов Firebase

Предварительная версия. Бюджеты с предельными расходами доступны в предварительной версии. Это означает, что на них не распространяются соглашения об уровне обслуживания и правила прекращения поддержки, а также что в них могут вноситься изменения, при которых не обеспечивается обратная совместимость.

На этой странице описано, как настроить бюджеты с пределом расходов и управлять ими, если в вашем проекте Firebase используется тарифный план Blaze.

Бюджеты с пределом расходов доступны для следующих сервисов Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase и Firebase Extensions.

Важно! Пределы расходов не являются жесткими. Из-за задержки в отчетах об использовании ограничение расходов не применяется мгновенно и может задерживаться на несколько минут. Все расходы, понесенные за время задержки, будут оплачиваться в обычном порядке.
Поэтому мы рекомендуем устанавливать предел расходов немного ниже абсолютного лимита и рассматривать его как один из инструментов, помогающих управлять расходами и снижать риск получения неожиданно больших счетов. Подробнее о дополнительных оповещениях и логических операторах…

Перейти к инструкциям по настройке предела расходов

Общие сведения о бюджетах

Чтобы контролировать расходы и избегать неожиданных сумм в счетах, вы можете создавать бюджеты для Google Cloud Billing. Бюджеты – это общие денежные суммы, которые вы планируете тратить каждый месяц. Они могут быть бюджетами с уведомлениями или бюджетами с пределом расходов.

Бюджеты с уведомлениями

• Если расходы достигнут заданных пороговых значений, Cloud Billing отправит уведомления по электронной почте.

• Обратите внимание:

  • Оповещения о бюджете не приостанавливают работу сервисов. Они предназначены для того, чтобы помочь вам отслеживать свои расходы и предупреждать вас, чтобы вы могли принять меры, если это необходимо. Например, вы можете использовать уведомления о бюджете, чтобы отключить платежные функции для проекта.

  • При переходе на тарифный план Blaze в консоли Firebase вам будет автоматически предложено настроить бюджет с уведомлениями. Вы также можете вручную настроить бюджеты с уведомлениями в консоли Google Cloud.

Бюджеты с ограничением расходов (эта страница)

• Если расходы достигнут пороговых значений, заданных для бюджета определенного сервиса, Cloud Billing отправит уведомления по электронной почте.

• Если расходы достигнут 100 % от бюджета, Cloud Billing приостановит работу сервиса до конца месяца.

• Обратите внимание:

  • Пределы расходов доступны только для следующих сервисов Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase и Firebase Extensions.

  • Вы можете вручную настроить бюджеты с предельными расходами в консоли Firebase (как описано на этой странице) или в консоли Google Cloud.

  • Прежде чем настраивать бюджет с пределом расходов, ознакомьтесь с важной информацией о бюджетах с пределом расходов ниже на этой странице.

Все проекты Firebase на самом деле являются проектами Google Cloud. Это означает, что Firebase и Google Cloud используют общие платежные данные, а один и тот же проект можно просматривать как в консоли Firebase, так и в консоли Google Cloud.

Общие сведения о бюджетах с лимитом расходов

Прежде чем настраивать бюджет с предельными расходами, ознакомьтесь с информацией в этом разделе, в том числе со списком поддерживаемых сервисов и возможными статусами предельных расходов. Также рекомендуем ознакомиться с ограничениями бюджетов с пределом расходов.

Вы также можете ознакомиться с часто задаваемыми вопросами о бюджетах с пределом расходов в документации Google Cloud.

Доступные сервисы

Лимиты расходов можно настроить для следующих сервисов Firebase:

• Firebase AI Logic: ограничить доступ к Gemini Developer API или Agent Platform Gemini API (formerly Vertex AI).
• Firebase App Hosting Установите ограничения для базового сервиса Cloud Run.
• Cloud Functions for Firebase: установите ограничения для базового сервиса Cloud Run functions.
• Firebase Extensions: установите ограничения для базового сервиса Cloud Run functions.

Мы работаем над тем, чтобы добавить в этот список больше сервисов, подходящих для бюджетов с пределом расходов, поэтому рекомендуем периодически проверять его.

Примечание. Если вы зададите предел расходов для одного из базовых сервисов, указанных выше, то этот бюджет будет применяться на уровне проекта и ко всем способам взаимодействия с сервисом в проекте. Например, если вы установите бюджет для Agent Platform Gemini API (formerly Vertex AI), он будет применяться ко всем случаям использования этого API в проекте через Firebase SQL Connect, ADK, Genkit и т. д. (а не только через Firebase AI Logic).

Статусы лимитов расходов

У предела расходов может быть одно из следующих состояний:

• Настроено. Cloud Billing активно отслеживает расходы вашего проекта на определенный сервис на основе бюджета с ограничением расходов.

• Применен. Расходы в проекте достигли 100 % от установленного месячного бюджета для этого сервиса, поэтому Cloud Billing применил предел расходов. Любое новое использование сервиса до конца месяца приостановлено, если только предел расходов не будет явно снят.

• Снят. Cloud Billing применил предел расходов (и приостановил использование соответствующего сервиса), но примененный предел расходов был явно снят, чтобы возобновить работу сервиса.

  В состоянии Снято сервис работает без лимита расходов до конца месяца, если вы не измените настройки или не увеличите лимит. В начале следующего месяца исходный лимит расходов автоматически включается снова.

Примечание. Изменение любой конфигурации ограничения расходов (даже переименование бюджета в консоли Google Cloud) возвращает ограничение расходов в состояние Настроено. Если ваши ежемесячные расходы уже достигли порогового значения или превысили его, ограничение сработает и вступит в силу немедленно.

Если вы не отмените лимит расходов, работа сервиса будет приостановлена только на текущий месяц. Затем, в начале следующего месяца, принудительный предел расходов будет автоматически сброшен, а сервис возобновит работу.

Как настроить пределы расходов и управлять ими

Примечание. Прежде чем настраивать бюджет с ограничением расходов, ознакомьтесь с общими сведениями о таких бюджетах в начале этой страницы.

1. Настройте бюджет с пределом расходов.
   Настройте бюджет с пределом расходов, чтобы Cloud Billing мог начать активно отслеживать расходы вашего проекта на определенный сервис.

2. Подробнее об оповещениях и применении предела расходов…
   Если расходы на проект достигают определенных пороговых значений месячного бюджета для этого сервиса, Cloud Billing отправляет оповещения по электронной почте и применяет предел расходов. Применение предела означает, что любое новое использование этого сервиса приостанавливается до конца месяца.

3. При необходимости снимите принудительный предел расходов (или увеличьте его бюджет).
   Если вы хотите возобновить использование приостановленного сервиса в том же месяце (без ограничений или с более высоким бюджетом), вам нужно явно снять установленный предел расходов.

Требуемые права доступа

Чтобы настроить бюджет с предельными расходами и управлять им, вам нужен доступ с правами администратора к проекту и связанному с ним аккаунту Cloud Billing. Вы можете получить необходимые разрешения одним из следующих способов:

• Вариант 1. Роль Администратор платежного аккаунта в аккаунте Cloud Billing, связанном с проектом.

• Вариант 2. Роль владельца проекта в проекте, для которого вы хотите настроить бюджеты с предельными расходами.

• Вариант 3. Следующая комбинация ролей IAM на уровне аккаунта Cloud Billing и проекта:

  • Роль Менеджер платежного аккаунта по учету расходов для аккаунта Cloud Billing, связанного с проектом.

    и

  • Роль редактора проекта в проекте, для которого вы хотите настроить бюджеты с пределом расходов.

Как настроить бюджет с пределом расходов

Чтобы Cloud Billing начал активно отслеживать ваши расходы на сервис, вам нужно настроить бюджет с лимитом расходов для этого сервиса. Если расходы на сервис в проекте достигнут определенных пороговых значений, Cloud Billing отправит оповещения по электронной почте и применит предел расходов.

Чтобы настроить бюджеты с предельными расходами в консоли Firebase, выполните следующие действия:

1. Откройте проект в консоли Firebase и перейдите в раздел Settings (Настройки) > Usage and billing (Использование и оплата) > Details & settings (Подробности и настройки).

2. Перейдите к карточке Пределы расходов на уровне сервиса.

3. Найдите сервис, для которого нужно установить ограничение, укажите сумму месячного бюджета и нажмите Настроить.

   • Бюджет с лимитом расходов распространяется на один проект и один сервис, соответствующий требованиям, в этом проекте.

   • Временной диапазон для бюджета с ограничением расходов – месяц, начиная с первого дня каждого месяца.

Внимание! Пределы расходов бюджетов не являются жесткими. Из-за задержки в отчетах об использовании предел расходов применяется не мгновенно. Все расходы, понесенные в течение этого времени, будут оплачиваться в обычном порядке. Рекомендуем установить бюджет немного ниже абсолютного предела.

Обратите внимание, что вы также можете настроить бюджеты с предельными расходами в консоли Google Cloud.

Оповещения по электронной почте и применение предела расходов

После того как вы настроите бюджет с лимитом расходов, Cloud Billing будет активно отслеживать расходы вашего проекта на этот сервис. Она будет отправлять оповещения по электронной почте и применять предел расходов на основе следующих пороговых значений для бюджета с пределом расходов этого сервиса.

• 50 % и 80 % от заданного бюджета:

  • Cloud Billing отправляет предупреждения по электронной почте всем администраторам платежных аккаунтов, владельцам проектов и основным контактам.

• 100 % от заданного бюджета:

  • Cloud Billing применяет ограничение расходов, то есть приостанавливает использование соответствующего сервиса до конца месяца, если вы не отмените ограничение.

  • Cloud Billing отправляет ещё одно оповещение по электронной почте. Кроме того, в консолях Firebase и Google Cloud появятся баннеры-уведомления о применении предела расходов и приостановке сервиса.

Влияние на стороне клиента и обработка ошибок

Когда работа сервиса приостанавливается из-за достижения лимита расходов, клиентское приложение начинает выдавать ошибки для этого сервиса. Вы должны корректно обрабатывать эти исключения в коде приложения (например, с помощью блоков try-catch).

Как снять принудительный предел расходов

Если лимит расходов достигнут и применен, все новые действия в соответствующем сервисе приостанавливаются до конца месяца, если вы не отмените лимит.

Чтобы снять принудительный предел расходов в консоли Firebase, выполните следующие действия:

1. Откройте проект в консоли Firebase и перейдите в раздел Settings (Настройки) > Usage and billing (Использование и оплата) > Details & settings (Подробности и настройки).

2. Перейдите к карточке Пределы расходов на уровне сервиса.

3. Найдите сервис с принудительным пределом расходов и нажмите Снять.

При снятии предела расходов учитывайте следующее:

• Возможная задержка возобновления работы сервиса. Для полного восстановления работы некоторых сервисов после снятия принудительного предела расходов может потребоваться час.
• Без ограничений до конца месяца. Если вы отмените действующий лимит расходов и не внесете других изменений, сервис будет работать без ограничений до конца месяца. В начале следующего месяца лимит расходов автоматически сбрасывается до состояния Настроено с исходным бюджетом, и сервис возобновляет работу.
• Если вы не отмените предел расходов, сервис останется приостановленным только на текущий месяц. В начале следующего месяца предел расходов автоматически сбрасывается до состояния Настроено с исходным бюджетом, и сервис возобновляет работу.

Обратите внимание, что вы также можете снять принудительные пределы расходов с помощью консоли Google Cloud.

Как увеличить лимит расходов после применения мер

Если предел расходов достигнут и вы хотите возобновить работу сервиса, увеличив бюджет на оставшуюся часть месяца (например, с 10 до 20 долларов США), вы не сможете изменить сумму бюджета, пока предел расходов находится в состоянии Достигнут. Чтобы установить более высокий лимит, сначала нужно снять ограничение.

Чтобы возобновить работу сервиса и увеличить лимит расходов, выполните следующие действия:

1. Снимите ограничение на расходы. В консоли Firebase или Google Cloud найдите сервис, для которого действует ограничение, и нажмите Снять.

   Пока ограничение снимается, лимит расходов будет находиться в состоянии ожидания.

2. Дождитесь снятия ограничения. Подождите несколько минут и обновите страницу. Статус должен измениться на Снято.

   Обслуживание будет возобновлено. В зависимости от сервиса это может занять до часа.

3. Измените сумму бюджета. Измените бюджет с пределом расходов, указав новый, более высокий месячный бюджет. Сохраните изменения.

Важные примечания:

• Привязка к общей сумме расходов за текущий месяц. Новый бюджет по-прежнему привязан к общей сумме расходов за текущий месяц, включая перерасход, возникший из-за задержек в отчетности до применения ограничения.

• Установите бюджет, превышающий расходы за текущий месяц. Убедитесь, что новый бюджет превышает сумму, которую вы уже потратили в этом месяце (включая перерасход). В противном случае лимит снова сработает и работа сервиса будет приостановлена.

• Расчет остатка бюджета. Остаток бюджета на месяц – это новый порог за вычетом общей суммы расходов на данный момент. Пример:

  1. Вы установили предел расходов в размере 10 долларов США на Cloud Functions for Firebase.

  2. Ваши расходы достигают 10 долларов США (плюс 1 доллар США за время задержки, итого 11 долларов США). Лимит применяется, и функции приостанавливаются.

  3. Вы убеждаетесь, что трафик легитимен, снимаете ограничение и ждете, пока статус не изменится на Снято.

  4. Вы обновляете предел расходов до 20 долларов США. После сохранения изменений лимит расходов вернется в состояние Настроено.

  5. Функции продолжают выполняться в рамках нового лимита в 20 долларов США, при этом на месяц остается около 9 долларов США бюджета (лимит в 20 долларов США минус уже начисленные 11 долларов США).

  6. В следующем месяце предел расходов останется на уровне 20 долларов США.

Ограничения бюджетов с предельными расходами

Ниже приведены важные ограничения, которые следует учитывать при работе с бюджетами с пределом расходов.

• Пределы расходов не являются жесткими ограничениями. Из-за задержки в отчетах об использовании предел расходов применяется не мгновенно, а с задержкой в несколько минут. Все расходы, понесенные за время задержки, будут оплачиваться в обычном порядке. Рекомендуем установить бюджет немного ниже абсолютного лимита.

• Область действия: проект и сервис. Бюджет с пределом расходов распространяется на один проект и один сервис в нем.

  • Вы не можете задать бюджет с пределом расходов на уровне всего аккаунта Cloud Billing, папки, организации или ярлыка.

  • Вы не можете установить единый бюджет с лимитом расходов, который будет охватывать несколько проектов или сервисов.

  • Когда вы устанавливаете бюджет с пределом расходов для сервиса, он применяется ко всем способам взаимодействия с сервисом в проекте. Например, если вы установите бюджет для Agent Platform Gemini API (formerly Vertex AI), он будет применяться ко всем случаям использования этого API в проекте через Firebase SQL Connect, ADK, Genkit и т. д. (а не только через Firebase AI Logic).

• Месячный диапазон дат. Временной диапазон бюджета с пределом расходов – месяц, начиная с первого дня каждого месяца.

• Подписка будет продлеваться автоматически каждый месяц.

  • Если вы не снимете ограничение расходов, сервис останется приостановленным только на текущий месяц. В начале следующего месяца лимит расходов автоматически сбрасывается до состояния Настроено с исходным бюджетом, и сервис возобновляет работу.

  • Если вы снимете принудительный лимит расходов в течение месяца и не измените бюджет, сервис будет работать без лимита расходов до конца этого месяца, а лимит расходов автоматически вернется в состояние Настроено с исходным бюджетом, и сервис возобновит работу.

• Не включает скидки и бонусы. Расчет стоимости для бюджета с предельными расходами основан на валовых расходах и не включает скидки и бонусы.

Если у вас более сложная платежная конфигурация, вы можете найти подробную информацию об ограничениях бюджетов с пределом расходов в документации Google Cloud.