Ana içeriğe geç

ONLYOFFICE Docs'ta hata ayıklama günlüğünü etkinleştirme

Genel bakış​

Bazı durumlarda ONLYOFFICE Docs'u hata ayıklama modunda çalıştırmak gerekir. Örneğin performans sorunlarını gidermek, günlükleri incelemek veya destek için bilgi toplamak istediğinizde.

ONLYOFFICE Docs'u hata ayıklama modunda başlatmanın iki seçeneği vardır.

Seçenek 1. Ortam değişkenini kullanma (yalnızca Docker)​

ONLYOFFICE Docs kapsayıcısını Docker veya Docker Compose ile yönetiyorsanız, hata ayıklama günlük düzeyini etkinleştirmek için ortam değişkeni kullanmak daha uygundur:

Docker​

  1. docker run ile ortam değişkenini ayarlayın:

    docker run -i -t -d -p 8080:80 \
      -e DS_LOG_LEVEL=DEBUG \
      onlyoffice/documentserver-de:latest

  2. Kapsayıcı zaten çalışıyorsa yeniden başlatın:

    docker restart <container>

  3. Günlükleri şu komutla görüntüleyebilirsiniz:

    docker logs -f <container>

Docker Compose​

  1. Kapsayıcıyı çalıştırırken ortam değişkenini docker-compose.yml dosyasında ayarlayın:

    services:
        documentserver:
          image: onlyoffice/documentserver-de:latest
          container_name: documentserver
          restart: always
          environment:
            - DS_LOG_LEVEL=DEBUG
          ports:
            - "8080:80"

  2. Docker Compose'u başlatın:

    docker-compose up -d

  3. Kapsayıcı zaten çalışıyorsa yeniden başlatın:

    docker-compose restart documentserver

  4. Günlükleri şu komutla görüntüleyebilirsiniz:

    docker-compose logs -f documentserver

Seçenek 2. log4js yapılandırma dosyasını kullanma​

ONLYOFFICE Docs'u hata ayıklama modunda başlatmak için:

  1. log4js yapılandırma dosyasını açın. Dosyanın yolu kullandığınız işletim sistemine bağlıdır:

    • Windows için - C:\Program Files\ONLYOFFICE\DocumentServer\config\log4js\production.json
    • Linux için - /etc/onlyoffice/documentserver/log4js/production.json
    • Docker için - /etc/onlyoffice/documentserver/log4js/production.json (Docker kapsayıcısının içinde)

  2. Aşağıdaki kod bloğuna bakın

    {
      "categories": {
        "default": {
          "appenders": [
            "default"
          ],
          "level": "WARN"
        }
      }
    }

  3. level değerini "WARN" yerine "DEBUG" olarak değiştirin.

  4. Değişiklikleri production.json yapılandırma dosyasına kaydedin.

  5. Değişiklikleri uygulamak için aşağıdaki komutu çalıştırın:

    Linux

    systemctl restart ds-*

    Docker

    supervisorctl restart all

    Windows için ise ONLYOFFICE DocumentServer Proxy hizmetini yeniden başlatın:

    net stop DsProxySvc
    net start DsProxySvc
    net stop DsConverterSvc
    net start DsConverterSvc
    net stop DsDocServiceSvc
    net start DsDocServiceSvc

  6. Günlükler (kurulum türüne bağlı olarak) şu konumlarda saklanır:

    • Windows için - C:\Program Files\ONLYOFFICE\DocumentServer\Log
    • Linux için - /var/log/onlyoffice/documentserver
    • Docker için - /var/log/onlyoffice/documentserver (Docker kapsayıcısının içinde) ve /app/onlyoffice/DocumentServer/logs/documentserver (birimi bağladıysanız ana makinede)