Как сохранять логи

Когда вы создаёте развёртывание, ваш контейнер генерирует логи. Вы можете сохранить эти логи в выбранный вами S3-бакет после завершения развёртывания. Настроив Endpoint Storage, вы сможете получить эти логи в любое время, даже после завершения развёртывания.

Свяжите ваш Endpoint Storage с версией приложения

Для этого вам нужно привязать версию приложения к Endpoint Storage. Перейдите на страницу с подробностями версии приложения и найдите Хранилище логов контейнера раздел. Включите переключатель и выберите ваш Endpoint Storage в поле выбора.

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

Готово! Каждое развёртывание с этой версией приложения теперь будет сохранять логи контейнера в ваш S3-бакет.

Путь по умолчанию

Путь в вашем S3-бакете будет выглядеть так.

• edgegap/arbitrium

• Первая часть вашего клиентского email, большинство S3-браузеров не любят "@"

• Имя вашего Endpoint Storage

• app / версия приложения / container_log

• Дата в формате YYYY-MM-DD

Вы можете создать несколько Endpoint Storage с тем же S3-бакетом, но с разными именами. Таким образом вы можете иметь разные директории для множества окружений, если захотите.

Дополнительные сценарии использования

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

Сохранение логов контейнера при создании развёртывания

При создании развёртывания вы можете указать, хотите ли вы сохранить логи контейнера вместе с запросом на развёртывание. Это независимо от настроек версии приложения, то есть не обязательно заранее настраивать Endpoint Storage для версии приложения — достаточно иметь рабочий Endpoint Storage.

Вы можете сделать это, добавив следующий JSON в ваш запрос на развёртывание. Поле endpoint_storage — это имя вашего Endpoint Storage.

{
  "container_log_storage": {
    "enabled": true,
    "endpoint_storage": "demo-bucket"
  }
}

Если endpoint_storage не указан, мы попытаемся использовать endpoint storage версии приложения. Если endpoint storage не найден, логи контейнера не будут сохранены.

Сохранение логов контейнера при остановке

Другой удобный способ — при завершении развёртывания. Если у вас есть основания полагать, что в контейнере что-то пошло не так, вы можете запросить сохранение логов контейнера. Эта опция доступна в маршрутах остановки развёртывания и самостопа (Self stop).

Вы можете сделать это, добавив параметр запроса container_log_storage в ваш запрос. Параметр container_log_storage — это имя вашего Endpoint Storage. Вы также можете указать true чтобы использовать endpoint storage версии приложения.

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