IKuznetsov: Новая страница: «= Загрузка логов через ЕдиныйАгент = ЕдиныйАгент — это рекомендуемый мощный инструмент, который автоматически находит источники логов из широкого спектра технологий на различных платформах, системах оркестрации контейнеров и операционных системах....»

2026-07-19T17:25:04Z

Новая страница: «= Загрузка логов через ЕдиныйАгент = ЕдиныйАгент — это рекомендуемый мощный инструмент, который автоматически находит источники логов из широкого спектра технологий на различных платформах, системах оркестрации контейнеров и операционных системах....»

Новая страница

= Загрузка логов через ЕдиныйАгент =
ЕдиныйАгент — это рекомендуемый мощный инструмент, который автоматически находит источники логов из широкого спектра технологий на различных платформах, системах оркестрации контейнеров и операционных системах.

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

* Упрощенная инструментация для хостов, процессов и кластеров '''Kubernetes'''.
* Беспроблемная установка на хосты и оператор для '''Kubernetes''' обеспечивают первоклассную работу благодаря встроенной функции мониторинга логов.
* Функция автоматического обогащения логов контекстной информацией, такой как топология и метаданные '''Kubernetes'''.
* Включение контекста трассировки в логи одним щелчком мыши повышает отслеживаемость.
* Автоматическое обнаружение критически важных логов в сочетании с гибкой настройкой источников логов обеспечивает всестороннюю наблюдаемость.
* Расширенные возможности управления логами в масштабе предприятия, предлагающие настройку форматов логов, маскирование конфиденциальных данных, а также фильтрацию при захвате и обработке данных.

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

После обнаружения источников логов ЕдиныйАгент применяет соответствующие правила приема логов. Эти правила определяют, как логи должны собираться, анализироваться и пересылаться на платформу мониторинга Ключ-АСТРОМ. Автоматическое обнаружение включает в себя шаблоны ротации логов.

ЕдиныйАгент автоматически обнаруживает логи с хостов и собирает логи из систем оркестрации контейнеров '''Kubernetes''' и из контейнеров '''Docker'''.

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

=== ЕдиныйАгент для логов хоста ===
ЕдиныйАгент упрощает управление логами, автоматически помечая их в соответствии с контекстом инфраструктуры и источника логов, а также обеспечивая обогащение трассировки одним щелчком мыши для более эффективного устранения неполадок. Для начала мониторинга логов достаточно установки и централизованной настройки правил приема логов в Ключ-АСТРОМ. ЕдиныйАгент также предлагает расширенные функции для масштабируемого управления логами, включая фильтрацию, маскирование конфиденциальных данных, пользовательское определение источника логов, обнаружение шаблонов ротации логов и централизованную конфигурацию для упрощения управления жизненным циклом.

=== Логи Kubernetes через ЕдиныйАгент ===
Подробнее о настройке приема логов из '''Kubernetes''' можно узнать на странице «Потоковая передача логов Kubernetes с помощью модуля логов Ключ-АСТРОМ».

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

== Поток конфигурации логов ЕдиногоАгента ==
После установки ЕдиногоАгента необходимо выполнить только один обязательный шаг: проверить правила приема логов по умолчанию или создать собственные правила приема логов, чтобы гарантировать их поступление в среду Ключ-АСТРОМ.

=== Правила приема логов ===
Настройка правил приема логов — важнейший шаг в процессе конфигурации. Правила позволяют указать, какие автоматически обнаруженные и пользовательские логи будут приниматься, фильтроваться и сохраняться. Правила приема логов можно настраивать в соответствии с указанными параметрами, такими как группа процессов или файл источника лога. Это гарантирует, что логи, поступающие из различных источников, будут должным образом обрабатываться и интегрироваться в систему мониторинга логов Ключ-АСТРОМ (включая автоматически обнаруженные и пользовательские логи).

Вы можете просмотреть источники логов, обнаруженные ЕдинымАгентом, на странице «Хост» или «Процесс» в Ключ-АСТРОМ. Для новых клиентов некоторые встроенные правила включены по умолчанию.

Правила приема логов применяются исключительно к ЕдиномуАгенту. Эти правила не распространяются на другие механизмы сбора логов.

=== Конфиденциальные данные ===
В ЕдиномАгенте можно настроить маскировку любой конфиденциальной информации, чтобы она не попадала в Ключ-АСТРОМ в открытом текстовом виде.

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

== Настройки ЕдиногоАгента ==
Система мониторинга логов Ключ-АСТРОМ использует модуль логирования ЕдиногоАгента, включенный по умолчанию во всех установках ЕдиногоАгента. Хотя для работы системы мониторинга логов не требуется специальная настройка, вы можете изменить некоторые параметры, доступные для модуля логирования ЕдиногоАгента.

=== Включите мониторинг логов с помощью oneagentctl ===
Чтобы включить мониторинг логов на ЕдиномАгенте, используйте параметр <code>--set-app-log-content-access=true</code> команды <code>oneagentctl</code>.

=== Глобальные настройки ЕдиногоАгента для мониторинга логов ===

# Перейдите в '''Настройки''' > '''Сбор и запись''' > '''Мониторинг логов''' > '''Настройка модуля логов''' > '''Расширенные настройки'''.
# Настройте параметры и сохраните изменения.

=== Настройки ЕдиногоАгента для мониторинга логов, специфичные для каждого хоста ===

# Перейдите в '''Настройки''', в верхнем левом углу выберите '''Перейти к сущности''', найдите хост и выберите его.
# В правом верхнем углу выберите имя хоста.
# Перейдите в раздел '''Сбор и запись''' > '''Мониторинг логов''' > '''Настройка модуля логов''' > '''Расширенные настройки'''.
# Настройте параметры и сохраните изменения.

=== Настройки ЕдиногоАгента по умолчанию ===
{| class="wikitable"
!Параметр
!По умолчанию
|-
|Обнаружение открытых файлов логов
|включено
|-
|Обнаружение системных логов
|включено
|-
|Обнаружение логов контейнеризированных приложений
|включено
|-
|Обнаружение логов '''IIS'''
|включено
|-
|Обнаружение логов в сетевых файловых системах
|отключено
|-
|Разрешите ЕдиномуАгенту отслеживать логи Ключ-АСТРОМ
|отключено
|-
|Определение часовых поясов контейнеров
|включено
|-
|Часовой пояс по умолчанию для агентов
|Местный часовой пояс
|-
|Ограничение на поиск по временной метке
|64 байта
|-
|Ограничение на количество символов для поиска по уровню серьезности
|100 байт
|-
|Ограничение количества строк поиска по уровню серьезности
|2
|-
|Максимальное количество экземпляров групп логов на сущность - ограничение по количеству
|200
|-
|Таймаут запроса к логу событий '''Windows'''
|5 секунд
|-
|Минимальный размер файла лога для выполнения бинарного обнаружения
|512 байт
|}

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

Выполните следующие действия, чтобы проверить, включен ли мониторинг логов Ключ-АСТРОМ на уровне среды или хоста:

=== Область действия среды ===

# Перейдите в '''Настройки''' > '''Сбор и захват данных''' > '''Общие параметры мониторинга''' > '''Контролируемые технологии'''.
# Найдите функцию мониторинга логов в списке поддерживаемых технологий и выберите '''Редактировать'''.
# Проверьте, включен ли переключатель '''Включить мониторинг логов для всех OneAgent в вашей среде''', и включите его, если он выключен.

=== Область действия хоста ===

# Перейдите в '''Настройки''', в верхнем левом углу выберите '''Перейти к сущности''', найдите хост и выберите его.
# В правом верхнем углу выберите имя хоста.
# Перейдите в раздел '''Сбор и запись''' > '''Мониторинг логов''' > '''Настройка модуля логов''' > '''Расширенные настройки'''.
# Настройте параметры и сохраните изменения.

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

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

* '''API для сбора логов''': сбор логов через API, если не удается установить ЕдиныйАгент.
* '''Расширения Ключ-АСТРОМ''': используйте настраиваемые дополнения для сбора логов и расширения возможностей мониторинга.
* '''Syslog''': Потоковая передача, мониторинг и управление файлами логов от различных компонентов системы.

== Загрузка логов за последнее время при включении модуля логирования ==
При включенном мониторинге логов модуль логирования Ключ-АСТРОМ получает ограниченное количество данных за последнее время из файлов логов.

* Если модуль логирования может определить поддерживаемый формат метки времени, он обрабатывает данные за последние 15 минут.
* Если формат метки времени не удается определить, модуль логирования обрабатывает последние 10 МиБ файла.

Загрузка последних записей лога начинается, когда модуль логирования впервые пытается прочитать файл лога. Это означает, что начальная точка может различаться для разных модулей логирования в вашей среде. Кроме того, интервалы загрузки данных модулем логирования и время распространения конфигурации (из среды в модуль логирования) влияют на фактическое время начала. Это встроенная функция, и настройка не требуется.

== Файлы логов с устаревшими изменениями ==
Файлы логов, время последнего изменения которых превышает 7 дней, не отслеживаются ЕдинымАгентом. Это влечет за собой следующие последствия:

* Данные логов из этих файлов не поступают в систему.
* При добавлении дополнительного содержимого файл рассматривается как новый. Если содержимое не содержит меток времени, ЕдиныйАгент обрабатывает последние 10 МиБ файла, которые могут включать данные, обработанные ранее. Это может привести к появлению дублирующихся записей.

Загрузка логов через ЕдиныйАгент - История изменений