> For the complete documentation index, see [llms.txt](https://kb.pvhostvm.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.pvhostvm.ru/hostvm-server/rukovodstvo-po-administrirovaniyu/chasto-zadavaemye-voprosy/monitoring-i-diagnostika/nastroika-debug-logirovaniya-v-hostvm-manager.md).

# Настройка DEBUG-логирования в HOSTVM Manager

{% hint style="warning" %}
Уровень DEBUG записывает огромное количество информации. Длительное использование может привести к быстрому заполнению раздела `/var/log` и падению производительности сервиса. Включайте его только на время диагностики и сразу отключайте.
{% endhint %}

### Общее логирование HOSTVM Manager

#### Включение DEBUG-логирования для всей системы

Для диагностики общих проблем выполните следующие шаги:

1. Подключитесь по SSH к серверу HOSTVM Manager.
2. Включите DEBUG-логирование для всего HOSTVM Manager:

```
/usr/share/ovirt-engine-wildfly/bin/jboss-cli.sh --connect --controller=localhost:8706 --user=admin@internal --commands="/subsystem=logging/logger=org.ovirt:write-attribute(name=level,value=DEBUG)"
```

3. Для подтверждения введите пароль от учетной записи admin и примените изменения, перезапустив службу:

```
systemctl restart ovirt-engine.service
```

5. Для отслеживания логов в реальном времени выполните попытку входа проблемного пользователя и наблюдайте за выводом:

```
/tail -f /var/log/ovirt-engine/engine.log | grep -i "username\|ldap\|auth"
```

*Примечание: замените "username" на логин пользователя или первые символы для фильтрации*

#### Отключение DEBUG-логирования

После завершения диагностики обязательно верните уровень логирования обратно на INFO, чтобы избежать излишней нагрузки на дисковую подсистему:

```
/usr/share/ovirt-engine-wildfly/bin/jboss-cli.sh --connect --controller=localhost:8706 --user=admin@internal --commands="/subsystem=logging/logger=org.ovirt:write-attribute(name=level,value=INFO)"
```

Для подтверждения введите пароль от учетной записи admin и примените изменения, перезапустив службу:

```
systemctl restart ovirt-engine.service
```

### Логирование отдельных модулей

Для минимизации объема логов и фокусировки на проблемах доступа рекомендуется включать DEBUG только для конкретных пакетов, например отвечающих за аутентификацию (AAA - Authentication, Authorization, Accounting).

**Пакет org.ovirt.engine.core.aaa отвечает за базовые механизмы аутентификации:**

Включение логирования:

```
/usr/share/ovirt-engine-wildfly/bin/jboss-cli.sh --connect --controller=localhost:8706 --user=admin@internal --commands="/subsystem=logging/logger=org.ovirt.engine.core.aaa:write-attribute(name=level,value=DEBUG)"
systemctl restart ovirt-engine.service
```

Отключение логирования:

```
/usr/share/ovirt-engine-wildfly/bin/jboss-cli.sh --connect --controller=localhost:8706 --user=admin@internal --commands="/subsystem=logging/logger=org.ovirt.engine.core.aaa:write-attribute(name=level,value=INFO)"
systemctl restart ovirt-engine.service
```

**Пакет org.ovirt.engine.core.bll.aaa отвечает за расширеные механизмы аутентификации:**

Включение логирования:

```
/usr/share/ovirt-engine-wildfly/bin/jboss-cli.sh --connect --controller=localhost:8706 --user=admin@internal --commands="/subsystem=logging/logger=org.ovirt.engine.core.bll.aaa:write-attribute(name=level,value=DEBUG)"
systemctl restart ovirt-engine.service
```

Отключение логирования:

```
/usr/share/ovirt-engine-wildfly/bin/jboss-cli.sh --connect --controller=localhost:8706 --user=admin@internal --commands="/subsystem=logging/logger=org.ovirt.engine.core.bll.aaa:write-attribute(name=level,value=INFO)"
systemctl restart ovirt-engine.service
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kb.pvhostvm.ru/hostvm-server/rukovodstvo-po-administrirovaniyu/chasto-zadavaemye-voprosy/monitoring-i-diagnostika/nastroika-debug-logirovaniya-v-hostvm-manager.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.