Загрузка логов Kubernetes с помощью ЕдиногоАгента
Загрузка логов Kubernetes с помощью ЕдиногоАгента
В этом руководстве мы рассмотрим, как включить загрузку логов Kubernetes с помощью ЕдиногоАгента через модуль логов, создать правила загрузки логов, маскировать конфиденциальные данные и настроить конфигурацию так, чтобы загружались только релевантные логи.
Целевая аудитория
Владелец Kubernetes, практик или администратор Ключ-АСТРОМ, настраивающий мониторинг логов Kubernetes с помощью модуля логов ЕдиногоАгента.
Чему вы научитесь
Как администратор Ключ-АСТРОМ, вы хотите отслеживать, есть ли проблемы с нодами кластера Kubernetes, и настроить наблюдаемость логов для работающих рабочих нагрузок. В этом руководстве вы научитесь:
- Просматривать и корректировать автоматически созданные правила загрузки логов для области вашего кластера.
- Создавать пользовательские правила загрузки логов, чтобы включать только релевантные логи Kubernetes.
Перед началом работы
Перед началом работы запустите мониторинг вашего кластера Kubernetes. Ознакомьтесь с поддерживаемыми дистрибутивами Kubernetes в разделе Поддержка технологий. Модуль логов ЕдиногоАгента автоматически обнаруживает логи, записываемые в потоки stdout и stderr контейнеризованными приложениями, работающими в подах. Подробности и альтернативы для логов, записываемых в файловую систему контейнера, доступны в разделе Потоковая передача логов Kubernetes с помощью модуля логов Ключ-АСТРОМ. Разверните Оператор Ключ-АСТРОМ на основе руководства по быстрому старту Kubernetes.
- Используйте опцию Мониторинг платформы Kubernetes + полноспектная наблюдаемость.
- Убедитесь, что включено Управление логами и аналитика.
- Если вы хотите развернуть управление логами и аналитику только для определённых ресурсов, разверните раздел Анализ логов рабочих нагрузок и нод в контексте, выберите Ограничить мониторинг логов определёнными ресурсами и укажите Пространства имён и Аннотацию пода для выбора подов, которые нужно мониторить.
Если вы уже мониторите кластер Kubernetes, возможно, потребуется изменить YAML-файл пользовательского ресурса AstromkeyKube. Проверьте конфигурацию и при необходимости обновите или добавьте секцию logMonitoring: {}. Подробности см. в разделе Мониторинг логов Kubernetes.
Загрузка логов Kubernetes с помощью ЕдиногоАгента
Начните с просмотра встроенных правил загрузки логов, чтобы понять, что уже собирается для вашего кластера Kubernetes.
1. Просмотрите встроенные правила загрузки логов
Просмотрите правила загрузки логов, автоматически созданные при развёртывании Оператора Ключ-АСТРОМ. Эти правила определяют, какие автоматически обнаруженные источники логов загружаются и сохраняются в хранилище. После выполнения руководства по быстрому старту Kubernetes соответствующие правила загрузки логов уже настроены, и ваши логи Kubernetes уже загружаются. Чтобы получить доступ к этим логам, перейдите в Kubernetes, выберите нужный объект Kubernetes и перейдите на вкладку Логи. Либо перейдите в раздел Логи.
Если вы решили ограничить мониторинг логов определёнными ресурсами при развёртывании Оператора (опция Ограничить мониторинг логов определёнными ресурсами), выполните следующие шаги:
- Перейдите в Настройки > Сбор и захват > Мониторинг логов > Правила загрузки логов.
- Просмотрите правила загрузки логов для области конфигурации среды и при необходимости измените их. Убедитесь, что нет унаследованных правил из области среды, которые могли бы загружать дополнительные логи.
- Необязательно: переключитесь на область кластера Kubernetes и добавьте правило исключения загрузки логов. В левом верхнем углу настроек выберите Перейти к сущности > и выберите нужный кластер Kubernetes. Добавьте правило Исключить все логи и переместите его в конец списка правил для этого кластера Kubernetes. Это предотвратит оценку любых унаследованных правил.
Поздравляем! Теперь вы можете просматривать ошибки в представлении нод кластера Kubernetes. Кроме того, вы можете анализировать логи ваших рабочих нагрузок в представлении рабочих нагрузок Kubernetes. На этом руководство можно закончить. При желании вы можете настроить загрузку логов с помощью пользовательских правил и маскирования конфиденциальных данных, выполнив шаги в следующих разделах.
2. Настройте пользовательское правило загрузки логов
Необязательно
Конфигурация логов AstromkeyKube из предыдущих шагов неизменяема и используется только при подключении. Дополнительные правила загрузки логов следует управлять через веб-интерфейс Ключ-АСТРОМ или API настроек.
Чтобы настроить правило загрузки логов для конкретной области кластера Kubernetes:
- Перейдите в Настройки, выберите Перейти к сущности > в левом верхнем углу страницы и найдите ваш кластер.
- Перейдите в Сбор и захват > Мониторинг логов > Правила загрузки логов. Либо откройте нужный кластер Kubernetes в разделе Kubernetes и выберите (Меню действий) > Правила загрузки логов на панели сведений о кластере.
- Выберите Добавить правило, чтобы создать правило загрузки логов.
- Укажите описательное имя для правила в поле Имя правила.
- Установите Тип правила в Включить в хранилище.
- Выберите Добавить условие и укажите следующее условие:
- Атрибут сопоставления: Имя пространства имён Kubernetes
- Значение: необходимое имя пространства имён.
- Выберите Сохранить и закрыть в нижней части страницы.
Дополнительные примеры см. в разделе Потоковая передача логов Kubernetes с помощью модуля логов Ключ-АСТРОМ. Если вы хотите, чтобы все кластеры Kubernetes в вашей среде были настроены одинаково, вам нужно определить правила загрузки логов на уровне среды.
Чтобы настроить правило загрузки логов для области конфигурации среды:
- Перейдите в Настройки > Сбор и захват > Мониторинг логов > Правила загрузки логов.
- Выполните шаги 3–7 из инструкций выше.
Обратите внимание, что любые правила на уровне кластера Kubernetes переопределяют правила, установленные на уровне среды, при использовании одних и тех же условий. Если вы хотите управлять правилами загрузки логов только на уровне среды, отключите правило, созданное Оператором Ключ-АСТРОМ, на уровне кластера Kubernetes. Не удаляйте правила, созданные Оператором Ключ-АСТРОМ, так как они могут быть созданы заново.
3. Маскирование конфиденциальных данных на периферии
Необязательно
Давайте воспользуемся примером адреса электронной почты из раздела Маскирование конфиденциальных данных в ЕдиномАгенте. Следуйте этим инструкциям, чтобы создать пользовательское правило маскирования конфиденциальных данных.
- Перейдите в Настройки.
- В левом верхнем углу страницы выберите Перейти к сущности > и найдите ваш кластер.
- Перейдите в Сбор и захват > Мониторинг логов > Маскирование конфиденциальных данных.
- Выберите Добавить правило, укажите Имя правила и введите
\b[\w\-\._]+?@[\w\-\._]+?\.\w{2,10}?\bв поле Поисковое выражение. - Необязательно: используйте раздел Условие, чтобы нацелить правило маскирования на конкретное пространство имён, рабочую нагрузку или контейнер.
- Выберите Сохранить и закрыть.
После создания этого правила маскирования оно распространяется на все модули логов в выбранном кластере Kubernetes, и конфиденциальные данные маскируются до того, как покинут вашу среду.
Лучшие практики загрузки и настройки источников логов в масштабе
- Чтобы избежать затрат на сопровождение, держите правила логов на как можно более высоком уровне, используя сопоставления для нацеливания на технологии процессов или объекты Kubernetes.
- Встроенный дашборд Обзор загрузки логов помогает отслеживать объёмы логов и состояние работоспособности. Дополнительную информацию см. в разделе Готовые дашборды.
Устранение неполадок
Ниже приведено решение проблемы, с которой сталкиваются некоторые пользователи.
Поздравляем!
Вы завершили руководство! Теперь, когда вы включили загрузку логов Kubernetes и настроили правила загрузки логов, вы можете отслеживать наличие проблем с нодами кластера Kubernetes для эффективного устранения неполадок ваших рабочих нагрузок.
