Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Cloud Functions
  • Сопоставление с другими сервисами Yandex Cloud
    • Обзор
    • Функция
    • Вызов функции
    • Асинхронный вызов функции
    • Долгоживущие функции
    • Уведомления о завершении выполнения функции
    • Сетевое взаимодействие
    • Монтирование внешних ресурсов на файловую систему функции
    • Сборщик
    • Dead Letter Queue
    • Логи функции
    • Резервное копирование
    • Квоты и лимиты
  • Инструменты
  • Правила тарификации
  • Управление доступом
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • История изменений
  • Вопросы и ответы
  • Обучающие курсы

В этой статье:

  • Уведомление пользовательского кода в активном экземпляре долгоживущей функции
  • Уведомление пользовательского кода в неактивном экземпляре функции
  1. Концепции
  2. Уведомления о завершении выполнения функции

Уведомления о завершении выполнения функции

Статья создана
Yandex Cloud
Обновлена 11 сентября 2024 г.
  • Уведомление пользовательского кода в активном экземпляре долгоживущей функции
  • Уведомление пользовательского кода в неактивном экземпляре функции

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

В зависимости от заданного в версии функции таймаута и текущего состояния экземпляра функции, существует два типа таких уведомлений:

  • для активных экземпляров долгоживущих функций;
  • для неактивных экземпляров функций.

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

Уведомление пользовательского кода в активном экземпляре долгоживущей функцииУведомление пользовательского кода в активном экземпляре долгоживущей функции

Примечание

Функциональность находится на стадии Preview. Чтобы получить доступ, обратитесь в техническую поддержку или к вашему аккаунт-менеджеру.

Этот тип уведомления направляется в пользовательский код функции при соблюдении следующих условий:

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

Уведомление о предстоящей принудительной остановке экземпляра отправляется в пользовательский код функции в форме POSIX-сигнала за десять минут до момента принудительного завершения работы экземпляра.

По умолчанию в качестве уведомления отправляется сигнал SIGTERM (Termination signal).

Вместо сигнала SIGTERM в пользовательский код функции может быть отправлен сигнал SIGINT (Interrupt from keyboard). Для этого в версию функции необходимо добавить переменную окружения X_YCF_GRACEFUL_SHUTDOWN_SIGNAL_SIGINT со значением 1.

Если позволяет среда выполнения, добавьте в функцию обработчик, который будет реагировать на поступающий от операционной системы POSIX-сигнал (SIGTERM или SIGINT). Это позволит избежать потери данных в случае нештатного завершения обработки вызова, обусловленного принудительной остановкой экземпляра функции.

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

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

Уведомление пользовательского кода в неактивном экземпляре функцииУведомление пользовательского кода в неактивном экземпляре функции

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

При принятии решения о принудительном завершении работы неактивного экземпляра функции в пользовательский код функции сначала направляется POSIX-сигнал SIGTERM, а затем (спустя 50 миллисекунд) — POSIX-сигнал SIGKILL, который принудительно остановит процесс.

Такая остановка экземпляра функции принудительно завершает все сетевые соединения на уровне L3 сетевой модели OSI.

В коде функции вы можете использовать обработчик, чтобы перехватить поступивший сигнал SIGTERM. Так вы сможете, например, штатно завершить сессии в сетевых соединениях (на уровне L7 сетевой модели OSI).

Примечание

С момента отправки сигнала SIGTERM у функции есть не более 50 миллисекунд на выполнение необходимых операций.

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

Была ли статья полезна?

Предыдущая
Долгоживущие функции
Следующая
Сетевое взаимодействие
Проект Яндекса
© 2025 ООО «Яндекс.Облако»