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

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

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

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

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

  • 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.

В разделах далее приводятся описания событий и сообщений, совместимых с MS AD DS, с группировкой по категории операции GC.

Включение роли GC (Promotion)

События, связанные с инициализацией и активацией роли глобального каталога:

Уровень логирования Идентификатор события Текст сообщения Описание

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

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

1119

This domain controller is now a global catalog

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

0

1559

The local domain controller has been selected to be a global catalog. However, the domain controller does not host a read-only replica of the following directory partition.
Directory partition:
<partition>
A precondition to becoming a global catalog is that a domain controller must host a read-only replica of all directory partitions in the forest. This event might have occurred because a Knowledge Consistency Checker (KCC) task has not completed or because the domain controller is unable to add a replica of the directory partition due to unavailable source domain controllers. An attempt to add the replica will be tried again at the next KCC interval.
Detail: <reason>

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

Синхронизация реплик (Synchronization)

События, связанные с репликацией партиций и частичного набора атрибутов (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

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, вызванным расширением схемы.
Это позволяет администратору отслеживать распространение изменений схемы и убедиться, что новые атрибуты корректно реплицированы во все реплики глобального каталога

Индексация (Index)

События, связанные с созданием или перестроением индексов в базе данных:

Уровень логирования Идентификатор события Текст сообщения Описание

3

1137

Successfully created an index for the following attribute.
Directory partition:
<partition>
Attribute identifier:
<attribute_id>
Attribute name:
<attribute_name>

Событие генерируется при создании индекса для атрибута в базе данных глобального каталога.
Сообщение содержит DN партиции, идентификатор и имя атрибута, для которого создан индекс.
Это событие фиксирует успешное выполнение операции перестроения индексов (например, после изменения схемы или ручного вызова samba-tool dbcheck --reindex)

Knowledge Consistency Checker (KCC)

События, генерируемые KCC при проверке и построении топологии репликации:

Уровень логирования Идентификатор события Текст сообщения Описание

0

1265

The attempt to establish a replication link with parameters
Partition: <partition>
Source DSA DN: <source_dsa_dn>
Source DSA Address: <source_dns_name>
Inter-site Transport (if any): <transport_dn>
failed with the following status:
<status>

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

0

1801

The partition <partition> should be hosted at site <site>, but has not been instantiated yet. However, the KCC could not find any hosts from which to replicate this partition.

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

0

1802

The Knowledge Consistency Checker has detected a crossRef for partition <partition>, but knowledge of the partition’s objectGUID has not yet replicated to this directory service.

Событие генерируется при обнаружении crossRef-объекта партиции, но отсутствии ее GUID в локальной базе.
Сообщение указывает на незавершенную репликацию метаданных партиции в лесу.
Это событие фиксирует потенциальную проблему с репликацией конфигурации, которая может помешать инициализации GC

Снятие роли GC (Removal)

События, связанные с удалением данных PAS и отключением роли GC:

Уровень логирования Идентификатор события Текст сообщения Описание

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

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

3

1120

This domain controller is no longer a global catalog.

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

Клиент GC (GC Client)

События, связанные с подключением клиента к удаленному GC (поиск, подключение, ошибки):

Уровень логирования Идентификатор события Текст сообщения Описание

3

1869

Domain Controller has located a global catalog in the following site.
Global catalog:
<dns_name>
Site:
<site>

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

0

1655

The attempt to communicate with global catalog <dns_name> failed with the following status: %{status}

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

0

1126

Unable to establish connection with global catalog

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

Обновлено: