Günlük Kaydı

Bir Kubernetes dağıtımının günlüklerini okuyun, kopyalayın ve saklayın.

Ayakaleaf Pro pod’u içindeki her hizmet kendi günlük dosyasını /var/log/overleaf/ altına yazar; kubectl logs yalnızca konteynerin başlangıç çıktısını (başlatma betikleri, geçişler) gösterir. Toolkit’in bin/logs komutu aynı dosyaları okur, bkz. Günlük Kaydı.

Nerede	Ne
kubectl -n overleaf logs <pod>	başlangıç: gizli anahtar denetimi, geçişler (Finished migrations), hizmetlerin başlaması
Pod içinde /var/log/overleaf/<service>.log	web.log, web-api.log, clsi.log, real-time.log, document-updater.log, docstore.log, filestore.log, history-v1.log, project-history.log, chat.log, notifications.log, linked-url-proxy.log ve Dropbox açıkken third-party-datastore.log
Pod içinde /var/log/nginx/	hizmetlerin önündeki nginx’in access.log ve error.log dosyaları
kubectl -n overleaf logs mongo-0, redis-0, git-bridge-0	Kendi pod’larında çalışan MongoDB, Redis ve git-bridge

​

Günlükleri okuma

Toolkit	Kubernetes
bin/logs web	kubectl -n overleaf exec deploy/overleaf -- tail -n 20 /var/log/overleaf/web.log
bin/logs -f web clsi	kubectl -n overleaf exec deploy/overleaf -- tail -f /var/log/overleaf/web.log /var/log/overleaf/clsi.log
bin/logs -n all web > web.log	kubectl -n overleaf cp overleaf/<pod>:/var/log/overleaf/web.log web.log
bin/logs mongo	kubectl -n overleaf logs mongo-0

Birden fazla replika ile her pod’un kendi dosyaları vardır: deploy/overleaf yerine pod adını (overleaf-0, overleaf-1, …) kullanın. HAProxy’nin eklediği X-Served-By başlığı, bir isteğe hangi replikanın yanıt verdiğini gösterir.

ConfigMap’teki LOG_LEVEL (varsayılan info; ayrıca debug, warn, error) pod’daki tüm hizmetlerin düzeyini tek seferde ayarlar.

​

Günlükleri saklama

Dosyalar konteynerde bulunur ve pod değiştirildiğinde kaybolur. Bunları saklamak için Deployment veya StatefulSet’te /var/log/overleaf konumuna bir birim bağlayın; örneğin düğümde bir hostPath veya bir PersistentVolumeClaim:

          volumeMounts:
            # ...
            - name: logs
              mountPath: /var/log/overleaf
      volumes:
        # ...
        - name: logs
          hostPath:
            path: /srv/overleaf-logs
            type: DirectoryOrCreate

Konteyner dosyaları günlük olarak döndürür ve beş tanesini saklar; böylece birim sınırsız büyümez. Ya da bunları kümenizin günlük aracısıyla bu yoldan toplayın.

​

Kubernetes üzerinde test edildi

Üç replikalı ve yukarıdaki gibi /var/log/overleaf konumunda bir hostPath birimi bulunan Kubernetes 1.37 üzerinde, her düğümün /srv/overleaf-logs dizini kendi replikasının on iki hizmet günlüğünü içeriyordu ve tablodaki komutlar gösterildiği gibi çalıştı: kubectl exec üzerinden tail, bir günlük dosyasının kubectl cp ile kopyalanması, Overleaf pod’unun (başlangıç ve geçişler) ve mongo-0’ın kubectl logs çıktısı.