Механизм устаревания файлов ЕдиногоАгента

Материал из Документация Ключ-АСТРОМ

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

  • Минимальное необходимое пространство: 200 МБ * 3 = 600 МБ (журналы, оповещения, отчеты о сбоях).
  • Требуемое пространство по умолчанию: 1 ГБ * 3 = 3 ГБ (журналы, оповещения, отчеты о сбоях).

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

Лог-файлы

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

Данные времени выполнения

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

Дополнительные сведения о настройке установки ЕдиногоАгента см. в справке для конкретной ОС: Linux, Windows или AIX.

Аварийная уборка

В экстренной ситуации, когда свободное место на диске достигает порога 3%, ЕдиныйАгент удаляет все файлы из каталогов, управляемых механизмом устаревания, за исключением последних журналов установщика и журнала модуля ОС ЕдиногоАгента.

ЕдиныйАгент Правила механизма устаревания

Механизм устаревания ЕдиногоАгента гарантирует, что дисковое пространство, используемое ЕдинымАгентом, постоянно находится в заданных пределах. Для этого к каталогам ЕдиногоАгента применяется ряд правил. При необходимости вы можете обратиться в службу поддержки Ключ-Астром, чтобы изменить некоторые правила устаревания.

Каталог журналов

  • Linux/AIX /var/log/key-astrom/oneagent
  • Windows %PROGRAMDATA%\key-astrom\oneagent\log

Механизм устаревания файлов проверяет файлы и подкаталоги в основном каталоге журнала и удаляет самые старые файлы, когда:

  • Общий размер каталога превышает 1 ГБ.
  • Любой файл в этом каталоге старше 14 дней
  • Каталог содержит более 1000 файлов (самые новые файлы сохраняются, старые файлы удаляются)

Существуют дополнительные правила для подкаталогов:

  • {log-dir}/process
    • Файлы удаляются при выполнении любого из следующих условий:
      • Файлы в этом каталоге занимают в общей сложности более 300 МБ.
      • Любой файл в этом каталоге старше 14 дней
      • Содержит более 1000 файлов.
  • {log-dir}/installer
    • Файлы удаляются при выполнении любого из следующих условий:
      • Файлы в этом каталоге занимают более 30 МБ.
      • Любой файл в этом каталоге старше 180 дней. В Windows файл driver.log сохраняется.
  • {log-dir}/dumpproc
    • Файлы удаляются при выполнении любого из следующих условий:
      • Файлы в этом каталоге занимают в общей сложности более 100 МБ.
      • Любой файл в этом каталоге старше 14 дней
      • Этот каталог содержит более 1000 файлов (самые новые файлы сохраняются, самые старые файлы удаляются)

Каталог хранения данных

  • Linux/AIX /var/lib/key-astrom/oneagent/datastorage
  • Windows %PROGRAMDATA%\key-astrom\oneagent\datastorage
  • {data_storage_dir}/supportalerts
    • Файлы удаляются при выполнении любого из следующих условий:
      • Этот каталог содержит более 10 файлов
      • Файлы в этом каталоге занимают более 1 ГБ.
      • Любой из файлов в этом каталоге старше 7 дней
  • {data_storage_dir}/memorydump
    • Файлы удаляются при выполнении любого из следующих условий:
      • Любой из файлов в этом каталоге старше 2 часов
      • Файлы в этом каталоге занимают более 20 ГБ.
  • {data_storage_dir}/crashreports
    • Файлы удаляются при выполнении любого из следующих условий:
      • О них уже сообщили Ключ-Астром.
      • Этот каталог содержит более 100 файлов
      • Файлы в этом каталоге занимают более 1 ГБ.
      • Любой из файлов в этом каталоге старше 3 дней

Каталог среды выполнения

  • Linux/AIX /var/lib/key-astrom/onagent/agent/runtime
  • Windows %PROGRAMDATA%\key-astrom\oneagent\agent\runtime
  • Механизм устаревания файлов ЕдиногоАгента проверяет подкаталоги, начинающиеся с 0x. Проверки выполняются рекурсивно.
  • Если каталог 0x* содержит подкаталог дампа и все файлы в нем старше 3 дней, то подкаталог дампа удаляется.
  • Если все файлы и каталоги в каталоге 0x* старше 7 дней, весь каталог удаляется.
  • Этот каталог также полностью очищается во время обновления ЕдиногоАгента .

Каталог установки bin

  • Linux/AIX /opt/key-astrom/oneagent/bin
  • Windows %PROGRAMFILES%\key-astrom\oneagent\bin
  • {каталог установки}/bin
    • ЕдиныйАгент развертывает ряд файловых артефактов в процессе обновления, особенно в случае внедряемых технологических модулей. Все файлы внедряемых модулей хранятся в версионных папках. Когда ЕдиныйАгент активен, он выполняет очистку файлов в соответствии со следующими критериями:
      • Текущая используемая версия всегда сохраняется.
      • ЕдиныйАгент сканирует все отслеживаемые процессы и определяет, какие библиотеки используются.
      • Затем список библиотек сравнивается с тем, что находится в каталоге bin, и все неиспользуемые двоичные файлы из каталогов 32 и 64 битности удаляются. Для двоичных файлов из каталога any механизм устаревания ЕдиногоАгента сохраняет самые последние 11 версий, включая текущую версию и 10 самых последних предыдущих версий.

Механизм устаревания для ЕдиногоАгента в режиме мониторинга только для приложений

Если у вас нет доступа к уровню инфраструктуры, Ключ-Астром также предоставляет возможность мониторинга только приложений для Kubernetes, OpenShift, Pivotal Web Services, IBM Cloud Foundry или SAP Business Technology Platform.

Механизм устаревания в режиме мониторинга только для приложений управляет журналами модулей ЕдиногоАгента. Все они расположены в соответствующих подкаталогах каталога журналов ЕдиногоАгента по умолчанию:

  • Linux/AIX /var/log/key-astrom/oneagent
  • Windows %PROGRAMDATA%\key-astrom\oneagent\log

Ротация журнала

Каждый модуль ЕдиногоАгента ограничивает количество журналов до 5. Размер каждого из этих 5 файлов ограничен 10 МБ.

Старение журнала

ЕдиныйАгент очищает файлы журнала при запуске, когда:

  • Файл журнала старше 14 дней
  • Общий размер всех файлов журналов превышает 300 МБ.
  • Существует более 1000 файлов журналов

Во избежание ненужных задержек при запуске вашего приложения ограничение на массовую очистку ЕдиногоАгента установлено таким образом, чтобы удалять не более 50 самых старых файлов.