Перейти к содержанию

Главная / Статьи

Frigate по шагам

Событие есть. Где его запись?

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

Запись и событияПример конфигурацииПорядок проверки

Одна камера, два разных пути

В нашем контуре Hikvision NVR хранит полную историю, а Frigate помогает выделять события. В своей системе сначала решите, где нужен непрерывный архив: у регистратора, у Frigate или в обоих местах. Сам факт обнаружения человека ещё не отвечает на этот вопрос.

Путь записи

  1. Поток с ролью record.
  2. Запись включена для камеры.
  3. Сегменты проходят политику сохранения.
  4. Видео остаётся на нужном файловом разделе.

Путь события

  1. Поток с ролью detect.
  2. Объект обнаружен и отслеживается.
  3. Активность попадает в Review.
  4. Home Assistant получает сигнал и проверяет свои условия.

Роли detect и record задаются отдельно. Один поток может иметь обе роли; основной поток для записи и подходящий под-поток для анализа — другой вариант. Проверьте фактическое качество объекта в кадре: маленький человек в слишком маленьком под-потоке может потерять нужные детали. Формат ролей описан в Camera Configuration.

Битрейт для расчёта архива берите у записываемого потока. Уменьшение разрешения анализа само по себе не уменьшает объём другого потока с ролью record.

Объект, Review и отдельный MP4

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

У нас поверх видеоконтура есть собственный архиватор коротких роликов: человек и автомобиль примерно по 30 секунд, открытие ворот — примерно 60. Эти значения принадлежат описанной схеме архива. Стандартная запись Frigate выбирает сегменты по своим правилам; длительность экспортированного файла нужно проверять отдельно.

Пример: три суток целиком, важные эпизоды дольше

Условная задача: сохранить всё за последние три суток, а интервалы alert — до двух недель. В текущей схеме Recording это разные настройки. Ниже фрагмент для одной камеры; адреса и названия заменяются параметрами вашей системы, а формат проверяется в редакторе установленной версии Frigate.

cameras:
  camera_example:
    ffmpeg:
      inputs:
        - path: rtsp://camera.example/main
          roles: [record]
        - path: rtsp://camera.example/sub
          roles: [detect]
    record:
      enabled: true
      continuous:
        days: 3
      motion:
        days: 0
      alerts:
        retain:
          days: 14
          mode: all
      detections:
        retain:
          days: 0

mode: all относится к сохраняемому интервалу alert, а не означает круглосуточную запись на 14 суток. Сохранённый объём зависит также от времени до и после события. Режим, сохраняющий только движение, может отсечь спокойную часть этого окна. Подробности и актуальные ключи — в Recording.

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

Событие видно, но нужного видео нет

  1. Проверьте нужную камеру и момент. Сопоставьте название камеры в Review и в настройках. Откройте полную запись этого промежутка, а не только короткое превью.
  2. Проверьте путь записи. Есть ли вход с ролью record, включена ли запись, нет ли ошибок потока? Настройка обнаружения объекта не заменяет эти проверки.
  3. Посмотрите итоговую политику камеры. Учтите её собственные настройки и унаследованные значения. Есть ли ещё подходящая политика для возраста и типа нужного сегмента?
  4. Проверьте место внутри контейнера. Убедитесь, что нужный диск действительно подключён к /media/frigate. Ошибка кэша /tmp/cache и нехватка места на архивном диске относятся к разным областям.
  5. Отделите запись от доставки. Если видео на месте, а Telegram молчит, переходите к MQTT, условиям и выполнению действия HA. Создавать второй архив для этого не требуется.

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

Продолжить на своей задаче

Найти место сбоя уведомления →Посчитать объём архива →Сценарий открытия ворот →Подставить событийный пример →