journal de bord#

Niveau de journalisation#

Vous pouvez configurer le niveau de journalisation du cluster Xinference via l’option --log-level. Par exemple, démarrez le cluster local Xinference au niveau de journalisation DEBUG :

xinference-local --log-level debug

Fichier journal#

Xinference prend en charge la rotation des fichiers journaux. Par défaut, un nouveau fichier de sauvegarde de journal est généré lorsque un seul fichier journal atteint 100 Mo, et le système conserve les 30 sauvegardes de journal les plus récentes. La méthode de configuration du niveau de journal ci-dessus affecte à la fois les journaux en ligne de commande et les fichiers journaux.

Environment Variables#

Xinference provides several environment variables to control logging behavior:

  • XINFERENCE_LOG_CONSOLE: Enable or disable console output (default: true). When set to false, logs are written only to files, and tqdm progress bars are captured and sampled.

  • XINFERENCE_LOG_FORMAT: Log format, either text (default) or json.

  • XINFERENCE_LOG_DOWNLOAD_PROGRESS: Control how download progress bars are logged when XINFERENCE_LOG_CONSOLE=false. Valid values are sampled (default, logs at 25/50/75/100% per file), full (logs every frame), or off (no progress logs).

Example usage:

# Disable console output, log download progress at sampling points
XINFERENCE_LOG_CONSOLE=false XINFERENCE_LOG_DOWNLOAD_PROGRESS=sampled xinference-local

# Disable console output, log every download progress frame
XINFERENCE_LOG_CONSOLE=false XINFERENCE_LOG_DOWNLOAD_PROGRESS=full xinference-local

# Disable console output, no download progress logs
XINFERENCE_LOG_CONSOLE=false XINFERENCE_LOG_DOWNLOAD_PROGRESS=off xinference-local

Structure du répertoire des journaux#

Premièrement, tous les logs sont stockés dans le répertoire <XINFERENCE_HOME>/logs, où la configuration de <XINFERENCE_HOME> est décrite dans Utilisation.

Ensuite, Xinference crée un sous-répertoire dans le répertoire des logs <XINFERENCE_HOME>/logs. Le nom du sous-répertoire correspond au moment du démarrage du cluster Xinference (en millisecondes).

Déploiement local#

Dans un déploiement local, les journaux du superviseur Xinference et des travailleurs Xinference sont fusionnés dans un seul fichier. La structure du répertoire des journaux est la suivante :

<XINFERENCE_HOME>/logs
    └── local_1699503558105
        └── xinference.log

Parmi eux, 1699503558105 est le timestamp de création du cluster Xinference. Ainsi, lorsque vous créez plusieurs fois un cluster localement, vous pouvez rechercher les journaux correspondants en fonction de ce timestamp.

Déploiement distribué#

Dans un déploiement distribué, le superviseur Xinference et les workers Xinference créent chacun leurs propres sous-répertoires dans le répertoire des journaux. Le nom du sous-répertoire commence par le nom du rôle du cluster, suivi du temps de démarrage (en millisecondes). Comme illustré ci-dessous :

<XINFERENCE_HOME>/logs
    └── supervisor_1699503558908
        └── xinference.log
        worker_1699503559105
        └── xinference.log