Установите лимиты расходов для сервисов Firebase.


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

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

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

Разберитесь в бюджетах.

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

Бюджеты, предназначенные только для оповещений

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

  • Обратите внимание на следующее:

Ограничения по расходам (эта страница)

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

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

  • Обратите внимание на следующее:

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

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

Обзор бюджетов с ограничением расходов

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

Список часто задаваемых вопросов о лимитах расходов также можно найти в документации Google Cloud .

Услуги, имеющие право на получение помощи

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

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

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

Ограничения на расходы

Ограничение на расходы может находиться в одном из следующих состояний:

  • Настройка : Cloud Billing активно отслеживает расходы по конкретному сервису в рамках вашего проекта, исходя из установленного лимита расходов.

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

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

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

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

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

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

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

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

Необходимые разрешения

Для настройки и управления лимитом расходов вам необходимы права администратора проекта и связанного с ним аккаунта Cloud Billing . Любой из следующих вариантов предоставляет вам необходимые разрешения:

Настройте лимит расходов.

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

Вот как настроить лимиты расходов с помощью консоли Firebase :

  1. Откройте свой проект в консоли Firebase , затем перейдите в... > Использование и оплата > Страница сведений и настроек .

  2. Перейдите к карточке «Лимит расходов на уровне обслуживания» .

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

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

    • Бюджет с ограничением расходов устанавливается на месяц , начиная с первого дня каждого месяца.

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

Уведомления по электронной почте и контроль за соблюдением лимитов расходов.

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

  • 50% и 80% от установленного бюджета:

    • Cloud Billing рассылает предупреждающие электронные письма всем администраторам биллинга, владельцам проектов и любым соответствующим «ключевым контактным лицам» .
  • 100% от установленного бюджета:

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

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

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

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

Отменить принудительное ограничение расходов

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

Вот как снять ограничение на расходы с помощью консоли Firebase :

  1. Откройте свой проект в консоли Firebase , затем перейдите в... > Использование и оплата > Страница сведений и настроек .

  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 а также на уровне папки, организации или метки, невозможно.

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

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

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

  • Работа сервиса возобновляется автоматически каждый месяц.

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

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

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

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