Логирование событий глобального каталога

При работе глобального каталога (Global Catalog, GC) в «Эллес» формируются и фиксируются события, совместимые с событиями Microsoft Active Directory Domain Services (MS AD DS). Эти события позволяют администратору отслеживать состояние инициализации, репликации и отключения глобального каталога, а также диагностировать причины задержек и ошибок, связанных с синхронизацией партиций и обновлением частичного набора атрибутов (PAS).

Подробнее о работе с глобальным каталогом в «Эллес» см. в разделах «Администрирование роли Global Catalog» и «Настройка глобального каталога».

Класс логирования

Для удобства анализа записи, связанные с глобальным каталогом, могут выделяться из общего массива информации, фиксируемой в логах «Эллес», с помощью следующего класса логирования:

  • gc — события глобального каталога.

Пример настройки сохранения сообщений, связанных с глобальным каталогом, в отдельный лог-файл на контроллере домена «Эллес»:

log level = 0 gc:3@/app/log/elles/gc_audit.log

В примере записи для логирования работы глобального каталога с классом логирования gc сохраняются в файл /app/log/elles/gc_audit.log с уровнем логирования 3.

Подробнее о настройке уровня и места логирования с использованием классов в разделе «Логирование Эллес»).

События

Сообщения, предназначенные для фиксации событий глобального каталога, имеют следующий формат:

  • события, совместимые с MS AD DS:

    <идентификатор события (EventId)>: <описание события>

  • остальные события регистрируются в стандартном формате лог-записей «Эллес».

Пример сообщений, совместимых с MS AD DS:

[2026/05/21 14:22:30.123456,  0] ../../source4/ldap_server/ldap_server_gc.c:906(ldapsrv_gc_ready_check_handler)
  ldapsrv_gc_ready_check_handler: EventId 1110: Promotion of this domain controller to a global catalog will be delayed for the following interval.
Interval (minutes): 5
This delay is necessary so that the required directory partitions can be prepared before the global catalog is advertised. In the config, you can specify the number of seconds that the directory system agent will wait before promoting the local domain controller to a global catalog. For more information about the Global Catalog Delay Advertisement config value, see the product documentation.
CN=DomainDnsZones,DC=elles,DC=inno,DC=tech, CN=ForestDnsZones,DC=elles,DC=inno,DC=tech
[2026/05/21 14:45:12.789012,  3] ../../source4/ldap_server/ldap_server_gc.c:1306(ldapsrv_gc_dns_update_done)
  ldapsrv_gc_dns_update_done: EventId 1119: This domain controller is now a global catalog
[2026/05/21 15:01:45.334210,  3] ../../source4/dsdb/repl/drepl_out_helpers.c:1195(dreplsrv_op_pull_source_apply_changes_trigger)
  dreplsrv_op_pull_source_apply_changes_trigger: EventId 1702: The global catalog completed synchronization of the partial attribute set for the following directory partition from the following domain controller.
Directory partition: CN=DomainDnsZones,DC=elles,DC=inno,DC=tech
Domain controller: elles_dc1.elles.inno.tech
This is a special replication cycle due to the addition of one or more attributes to the partial attribute set.
Табл. 1. События глобального каталога
Уровень логирования Идентификатор события Событие Описание

0

1110

Promotion of this domain controller to a global catalog will be delayed for the following interval.
Interval (minutes): <interval>
This delay is necessary so that the required directory partitions can be prepared before the global catalog is advertised. In the config, you can specify the number of seconds that the directory system agent will wait before promoting the local domain controller to a global catalog. For more information about the Global Catalog Delay Advertisement config value, see the product documentation.

Событие генерируется следующим образом:

  • при включении GC безусловно выдается сообщение о задержке на 5 минут; если условия для включения GC выполняются до истечения задержки, активация происходит без ожидания;

  • если за 5 минут не завершена репликация всех необходимых партиций, выдается новое сообщение о задержке включения на 30 минут;

  • далее сообщение повторяется каждые 30 минут, пока репликация не будет завершена.

Сообщение содержит продолжительность текущей задержки (в минутах).
Администратор может отслеживать прогресс репликации по частоте и интервалам этих сообщений: частые повторения указывают на проблемы с репликацией конкретных партиций, а прекращение сообщений указывает на успешное завершение подготовки GC.
Задержка является преднамеренной мерой для обеспечения целостности данных перед объявлением GC в DNS и обслуживанием клиентских запросов

3

1119

This domain controller is now a global catalog

Событие генерируется при успешном завершении всех этапов инициализации глобального каталога: завершена синхронизация всех необходимых партиций, атрибут isGlobalCatalogReady в базе данных установлен в TRUE, и выполнена регистрация DNS SRV-записей через скрипт samba_dnsupdate.
Это событие подтверждает, что контроллер домена полностью готов к обслуживанию запросов к глобальному каталогу и может быть обнаружен клиентами в домене

3

1120

This domain controller is no longer a global catalog.

Событие генерируется при завершении процесса снятия роли глобального каталога: все данные частичного набора атрибутов (PAS) для соответствующих партиций удалены из локальной базы данных, атрибут isGlobalCatalogReady установлен в FALSE, и DNS SRV-записи, регистрирующие контроллер как GC, были удалены или обновлены через скрипт samba_dnsupdate.
Это событие подтверждает, что контроллер домена больше не функционирует в роли сервера глобального каталога; клиенты перестанут его обнаруживать в качестве источника GC

3

1578

Promotion of the local domain controller to a global catalog has been delayed because the directory partition occupancy requirements have not been met. The occupancy requirement level and current domain controller level are as follows.
Occupancy requirement level: <requirement level>
Domain controller level: <current level>
The following config value defines the directory partition occupancy requirement level.
<Global Catalog Partition Occupancy>
Higher occupancy requirement levels include the lower levels. The levels are defined as follows:
(0) Indicates no occupancy requirement.
(1) Indicates at least one read-only directory partition in the site has been added by the Knowledge Consistency Checker (KCC).
(2) Indicates at least one directory partition in the site has been fully synchronized.
(3) Indicates all read-only directory partitions in the site have been added by the KCC (at least one has been synchronized).
(4) Indicates all directory partitions in the site have been fully synchronized.
(5) Indicates all read-only directory partitions in the forest have been added by the KCC (at least one has been synchronized).
(6) Indicates all directory partitions in the forest have been fully synchronized.

Событие генерируется после второго и последующих сообщений с EventId 1110, когда задержка активации GC продлевается с 5 до 30 минут, и отображает текущий уровень «заполненности» (occupancy) каталога.
Событие содержит два параметра: требуемый уровень заполнения, задаваемый конфигурацией, и текущий уровень заполнения контроллера домена, отражающий прогресс синхронизации партиций.
Это позволяет оценить прогресс подготовки GC и спрогнозировать время завершения синхронизации. Уровни иерархические — каждый последующий включает предыдущие:
(0) — нет требований;
(1) — хотя бы для одной частичной партиции начата репликация;
(2) — хотя бы одна частичная партиция полностью синхронизирована;
(3) — для всех частичных партиций, расположенных в локальном сайте, начата репликация;
(4) — все частичные партиции, расположенные в локальном сайте, полностью синхронизированы;
(5) — для всех частичных партиций в лесу начата репликация;
(6) — все частичные партиции в лесу полностью синхронизированы

3

1659

The removal of the following directory partition from the local Active Directory Domain Services database has resumed. Directory partition:<partition>

Событие генерируется при начале удаления частичной реплики (PAS) при снятии роли глобального каталога (GC). Отражает факт запуска процесса удаления указанной партиции

3

1660

The removal of the following directory partition from the local Active Directory Domain Services database completed successfully. Directory partition:<partition>

Событие генерируется при успешном завершении удаления частичной реплики (PAS) при снятии роли глобального каталога (GC). Подтверждает, что партиция полностью удалена из базы данных

3

1702

The global catalog completed synchronization of the partial attribute set for the following directory partition from the following domain controller.
Directory partition: <partition>
Domain controller: <dc>
This is a special replication cycle due to the addition of one or more attributes to the partial attribute set.

Событие генерируется при успешном завершении синхронизации частичного набора атрибутов (PAS) для конкретной партиции каталога в ответ на изменение схемы — добавление нового атрибута в PAS.
Сообщение содержит DN партиции и DNS-имя источника репликации, подтверждая, что данный цикл репликации был инициирован не стандартным обновлением, а специальным запросом на синхронизацию PAS, вызванным расширением схемы.
Это позволяет администратору отслеживать распространение изменений схемы и убедиться, что новые атрибуты корректно реплицированы во все реплики глобального каталога

3

1704

The global catalog initiated replication of a member of the partial attribute set for the following directory partition from the following domain controller.
Directory partition: <partition>
Domain controller: <dc>
This is a special replication cycle due to the addition of one or more attributes to the partial attribute set.

Событие генерируется при инициировании специального цикла репликации в ответ на добавление нового атрибута в частичный набор атрибутов (PAS).
Сообщение содержит DN партиции и DNS-имя источника репликации, подтверждая, что данный цикл запущен не в рамках стандартной репликации, а как реакция на изменение схемы — конкретно на расширение списка атрибутов, включаемых в PAS.
Это позволяет администратору отслеживать распространение изменений схемы и убедиться, что новые атрибуты корректно инициируют репликацию между контроллерами домена для поддержания согласованности глобального каталога

3

1744

The local domain controller is no longer a global catalog. As a result, the partial, read-only directory partition of the following domain is being removed from the local domain controller.
Domain: <domain>
The local domain controller cannot be reconfigured to become a global catalog until this partial, read-only directory partition is completely removed.

Событие генерируется при снятии роли глобального каталога (GC) и фиксирует начало процесса удаления частичной реплики (PAS) для каждой соответствующей партиции каталога.
Сообщение указывает на конкретную доменную партицию, данные которой начинают удаляться с локального контроллера, и подтверждает, что повторное назначение роли GC невозможно до полного завершения удаления всех PAS-данных — это обеспечивает целостность состояния каталога и предотвращает конфликты при последующем повторном включении GC

Обновлено: