#Логи

#Анализ запросов логов

В панели анализа запросов логов центра операций вы можете просматривать логи стандартного вывода (stdout) учетной записи, под которой вы вошли, в рамках ее прав, включая системные логи, логи продукта, логи Kubernetes и логи приложений. Через эти логи можно получить представление о работе ресурсов.

• Системные логи: Логи с хост-нод, например: dmesg, syslog/messages, secure и др.
• Логи продукта: Логи собственных компонентов платформы и интегрированных сторонних компонентов, например: Container-Platform, Platform-Center, DevOps, Service-Mesh и др.
• Логи Kubernetes: Логи компонентов, связанных с оркестрацией контейнеров Kubernetes, а также логи, генерируемые kubelet, kubeproxy и docker, например: docker, kube-apiserver, kube-controller-manager, etcd и др.
• Логи приложений: Логи бизнес-приложений, включая файловые логи и логи стандартного вывода.

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

#Поиск логов

1. В левой навигационной панели нажмите Operations Center > Logs > Log Query Analysis.

2. Выберите нужный тип лога, условия запроса, введите ключевые слова для поиска в содержимом логов и нажмите Search.

#Экспорт данных логов

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

1. Нажмите кнопку Export в правом верхнем углу столбчатой диаграммы и настройте параметры в появившемся диалоговом окне экспорта логов.

   • Scope: Диапазон экспорта логов, можно выбрать Current Page или All Results.

     • Current Page: Экспортирует только результаты запроса на текущей странице, максимум 1 000 записей.
     • All Results: Экспортирует все данные логов, соответствующие текущим условиям запроса, максимум 1 миллион записей.

   • Fields: Поля отображения логов. Вы можете выбрать, какие поля включать в экспортируемый файл, отметив соответствующие чекбоксы.

     Примечание: Для разных типов логов доступны разные поля отображения, выбирайте согласно вашим потребностям.

   • Format: Формат экспортируемого файла логов, поддерживаются txt или csv. Платформа экспортирует в сжатом формате gzip.

2. Нажмите Export, и браузер автоматически скачает сжатый файл на ваш локальный компьютер.

#Просмотр контекста лога

1. Дважды кликните по области содержимого лога, и в текущем диалоговом окне отобразятся 5 логов до и после времени печати текущего лога, что помогает специалистам по эксплуатации лучше понять причины возникновения текущих логов ресурсов.

2. Вы можете настроить отображаемые поля контекста лога или экспортировать контекст лога. При экспорте контекста лога выбор Scope не требуется; нажатие кнопки Export сразу скачает файл контекста лога на локальный компьютер через браузер.

#Управление временем хранения логов приложений

Если политика проекта не установлена, время хранения логов приложений на платформе определяется параметром Application Log Retention Time Log Storage Plugin, установленного на Storage Cluster, выбранном при установке Alauda Container Platform Log Collector в кластере, где размещено приложение.

Вы можете дифференцировать время хранения Application Logs на платформе, добавляя и управляя политиками логов проекта.

#Установка политик хранения администратором платформы

1. В левой навигационной панели нажмите Operations Center > Logs > Policy Management.

2. Нажмите Add Project Policy.

3. В выпадающем списке Project выберите проект.

4. Установите Log Retention Time.

   • Используйте кнопки -/+ по обе стороны счетчика для уменьшения/увеличения дней хранения или введите значение напрямую. Платформа позволяет устанавливать время хранения от 1 до 30 дней.
   • Если введено десятичное число, оно округляется вверх до целого; если значение меньше 1, оно округляется вверх до 1, и кнопка - становится неактивной; если значение больше 30, оно округляется вниз до 30, и кнопка + становится неактивной.

5. Нажмите Add.

#Установка политик хранения администратором проекта

1. Перейдите на страницу деталей текущего проекта.

2. Нажмите кнопку редактирования рядом с полем политики логов, чтобы включить политику логов в появившемся окне.

3. Установите Log Retention Time.

• Используйте кнопки -/+ по обе стороны счетчика для уменьшения/увеличения дней хранения или введите значение напрямую. Платформа позволяет устанавливать время хранения от 1 до 30 дней.
• Если введено десятичное число, оно округляется вверх до целого; если значение меньше 1, оно округляется вверх до 1, и кнопка - становится неактивной; если значение больше 30, оно округляется вниз до 30, и кнопка + становится неактивной.

#Установка политик хранения через CLI

1. Войдите в кластер global и выполните команду:

   kubectl edit project <Project Name>

2. Измените yaml согласно примеру ниже, сохраните и отправьте изменения.

   apiVersion: auth.alauda.io/v1
   kind: Project
   metadata:
     annotations:
       cpaas.io/creator: mschen1@alauda.io
       cpaas.io/description: ''
       cpaas.io/display-name: ''
       cpaas.io/operator: leizhuc
       cpaas.io/project.esPolicyLastEnabledTimestamp: '2025-02-18T09:53:54Z'
       cpaas.io/updated-at: '2025-02-18T09:53:54Z'
   creationTimestamp: '2025-02-13T08:19:11Z'
   finalizers:
     - namespace
   generation: 1
   labels:
     cpaas.io/project: bookinfo
     cpaas.io/project.hotDataRetentionDays: '7' # Время хранения горячих данных в проекте
     cpaas.io/project.coldDataRetentionDays: '30' # Время хранения холодных данных после переноса в холодное хранилище S3
     cpaas.io/project.logPolicyEnabled: 'true' # Включение политики проекта
     cpaas.io/project.id: '95447321'
     cpaas.io/project.level: '1'
     cpaas.io/project.parent: ''
   name: bookinfo
   ### Остальная информация yaml, не связанная с изменениями, опущена.

   В некоторых средах ACP 4.2 для совместимости могут сохраняться устаревшие метки, такие как cpaas.io/project.esIndicesKeepDays и cpaas.io/project.esPolicyEnabled. Для новых настроек используйте приведенные выше новые метки.

#Настройка частичного исключения логов приложений из сбора

Если вам нужно просматривать только Реальные логи определенных приложений в кластере без необходимости их хранения (коллектор будет отбрасывать соответствующие логи), вы можете воспользоваться этим разделом для настройки области остановки сбора логов (кластер, namespace, Pod) для тонкой настройки сбора логов приложений.

#Остановить сбор всех логов приложений в кластере

Вы можете обновить Configuration Parameters Alauda Container Platform Log Collector кластера, чтобы выключить переключатель сбора Application Log, тем самым единообразно обновив область сбора логов для этого кластера. После выключения переключателя сбора для определенного типа логов сбор всех логов этого типа в текущем кластере прекратится.

#Остановить сбор логов приложений в конкретном namespace

Вы можете выключить переключатель сбора логов для namespace, добавив метку cpaas.io/log.mute=true в указанный namespace, тем самым остановив сбор всех логов стандартного вывода и файловых логов для всех Pod в этом namespace.

Возможные способы настройки:

• Через командную строку: После входа на любой управляющий узел кластера выполните команду для обновления метки namespace.

  kubectl label namespace <Namespace Name> cpaas.io/log.mute=true

• Через интерфейс: В представлении Project Management обновите метку namespace.

  1. В списке проектов представления Project Management кликните по Project Name, где находится namespace.

  2. В левой навигационной панели нажмите Namespaces.

  3. Кликните по Namespace Name, метку которого нужно обновить.

  4. На вкладке Details нажмите кнопку управления справа от Labels.

  5. Добавьте метку (Ключ: cpaas.io/log.mute, Значение: true) или измените значение существующей метки, затем нажмите Update.

#Остановить сбор логов Pod

Вы можете выключить переключатель сбора логов для конкретного Pod, добавив метку cpaas.io/log.mute=true к нему, тем самым остановив сбор логов стандартного вывода и файловых логов для этого Pod.

После входа на любой управляющий узел кластера выполните команду для обновления метки Pod.

kubectl label pod <Pod Name> -n <Namespace Name> cpaas.io/log.mute=true

Примечание: Если Pod принадлежит вычислительному компоненту (Workload), вы можете обновить метки вычислительного компонента (Deployment, StatefulSet, DaemonSet, Job, CronJob), чтобы единообразно обновить метки всех Pod под этим компонентом, и метки сохранятся даже после пересоздания Pod.

Обновление меток вычислительного компонента выполняется следующим образом.

1. В представлении продукта Container Platform переключитесь через верхнюю навигацию в namespace, где находится Pod.

2. В левой навигационной панели нажмите Compute Components > Тип вычислительного компонента, к которому принадлежит Pod.

3. Нажмите кнопку управления справа от нужного компонента > Update.

4. В правом верхнем углу переключитесь в режим редактирования YAML, нажав YAML.

5. В поле spec.template.labels добавьте метку cpaas.io/log.mute: 'true'.

   Пример:

   spec:
     template:
       metadata:
         namespace: tuhao-test
         creationTimestamp: null
         labels:
           app: spilo
           cpaas.io/log.mute: 'true'
           cluster-name: acid-minimal-cluster
           role: exporter
           middleware.instance/name: acid-minimal-cluster
           middleware.instance/type: PostgreSQL

6. Нажмите Update.