Установка Loki

Loki — горизонтально масштабируемая, высокодоступная многопользовательская система агрегации и хранения логов. Loki индексирует не содержимое логов, а набор меток для каждого потока логов.

Перед началом работыПеред началом работы

1. Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

   По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

2. Убедитесь, что группы безопасности для кластера Managed Service for Kubernetes и его групп узлов настроены корректно. Если отсутствует какое-либо из правил — добавьте его.

   Важно

   От настройки групп безопасности зависит работоспособность и доступность кластера, а также запущенных в нем сервисов и приложений.

3. Подготовьтесь к установке Loki:

   1. Создайте сервисный аккаунт с ролями storage.uploader и storage.viewer. Он необходим для доступа к Yandex Object Storage.

   2. Создайте статический ключ доступа для сервисного аккаунта в формате JSON:

      yc iam access-key create \
        --service-account-name=<имя_сервисного_аккаунта> \
        --format=json > sa-key.json
      

   3. Создайте бакет с ограниченным доступом в Object Storage.

Установка с помощью Yandex Cloud MarketplaceУстановка с помощью Yandex Cloud Marketplace

1. Перейдите на страницу каталога и выберите сервис Managed Service for Kubernetes.

2. Нажмите на имя нужного кластера Managed Service for Kubernetes и выберите вкладку Marketplace.

3. В разделе Доступные для установки приложения выберите Loki и нажмите кнопку Перейти к установке.

4. Задайте настройки приложения:

   • Пространство имен — выберите пространство имен для Loki или создайте новое.
   • Название приложения — укажите название приложения.
   • Имя бакета — укажите имя бакета в Object Storage.
   • Статический ключ для доступа — скопируйте содержимое файла sa-key.json.
   • Установить Promtail — оставьте опцию включенной, чтобы поставлять локальные журналы инстансу Grafana Loki с помощью агента Promtail. Обычно агент используется для приложений, для которых нужен регулярный мониторинг.

5. Нажмите кнопку Установить.

6. Дождитесь перехода приложения в статус Deployed.

Установка с помощью Helm-чартаУстановка с помощью Helm-чарта

1. Установите менеджер пакетов Helm версии не ниже 3.8.0.

2. Установите kubectl и настройте его на работу с созданным кластером.

3. Для установки Helm-чарта с Loki выполните команду:

   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/grafana/loki/chart/loki \
     --version 1.2.0-7 \
     --untar && \
   helm install \
     --namespace <пространство_имен> \
     --create-namespace \
     --set global.bucketname=<имя_бакета> \
     --set-file global.serviceaccountawskeyvalue=<путь_к_файлу_sa-key.json> \
     loki ./loki/
   

   Примечание

   Если вы используете версию Helm ниже 3.8.0, добавьте в начало команды строку export HELM_EXPERIMENTAL_OCI=1 && \, чтобы включить поддержку Open Container Initiative (OCI) в клиенте Helm.

4. Убедитесь, что все поды Loki перешли в состояние Running:

   kubectl get pods -A -l "app.kubernetes.io/instance=loki"
   

Подключение к LokiПодключение к Loki

После развертывания Loki будет доступен внутри кластера Managed Service for Kubernetes по следующему адресу:

http://<имя_сервиса_Loki_gateway>.<пространство_имен>.svc.cluster.local

Чтобы узнать пространство имен и имя сервиса Loki gateway выполните команду:

kubectl get service -A | grep distributed-gateway

Результат:

test-namespace   loki-loki-distributed-gateway   ClusterIP   10.96.168.88   <none>   80/TCP    15m

См. такжеСм. также

• Документация Grafana Loki.