нл:: Переплетение:: Профили:: DataManagement_Current:: Управление журналированием

Публичный API для регистрации набора событий, хранящихся извне.

Зарегистрируйте обратный вызов формы FetchExternalEventsFunct . Этот API требует, чтобы платформа знала количество событий при регистрации. Внутренняя работа также требует, чтобы это число было постоянным. Поскольку этот API не позволяет платформе регистрировать определенные идентификаторы событий, это не позволяет платформе постоянно хранить события (по крайней мере, с уникальными идентификаторами событий).

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

Этот вариант функции следует использовать, когда внешний поставщик хочет получать уведомления как о доставке событий подписчику, так и об удалении объекта внешних событий.

Когда события доставляются, внешний поставщик уведомляется об этом вместе с идентификатором узла получателя и идентификатором последнего события, доставленного этому получателю. Обратите внимание, что внешний поставщик может быть уведомлен несколько раз об одном и том же идентификаторе события. Для обработчика не существует особых ограничений, в частности, обработчик может отменить регистрацию идентификаторов внешних событий.

Если объект внешних событий удаляется из буферов журнала, внешний поставщик уведомляется вместе с копией объекта внешних событий.

Указатель на структуру ExternalEvents в случае возникновения ошибки будет иметь значение NULL, в противном случае он будет заполнен идентификаторами начального и конечного событий, назначенными обратному вызову. Этот указатель следует использовать для отмены регистрации набора событий.

Подробную информацию о том, что должен реализовать обратный вызов, см. в документации по FetchExternalEventsFunct .

Публичный API для регистрации набора событий, хранящихся извне.

Зарегистрируйте обратный вызов формы FetchExternalEventsFunct . Этот API требует, чтобы платформа знала количество событий при регистрации. Внутренняя работа также требует, чтобы это число было постоянным. Поскольку этот API не позволяет платформе регистрировать определенные идентификаторы событий, это не позволяет платформе постоянно хранить события (по крайней мере, с уникальными идентификаторами событий).

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

Этот вариант функции следует использовать, когда внешний поставщик хочет получать уведомления о доставке событий подписчику, но не при удалении объекта внешних событий. Когда события доставляются, внешний поставщик уведомляется об этом вместе с идентификатором узла получателя и идентификатором последнего события, доставленного этому получателю. Обратите внимание, что внешний поставщик может быть уведомлен несколько раз об одном и том же идентификаторе события. Для обработчика не существует особых ограничений, в частности, обработчик может отменить регистрацию идентификаторов внешних событий.

Указатель на структуру ExternalEvents в случае возникновения ошибки будет иметь значение NULL, в противном случае он будет заполнен идентификаторами начального и конечного событий, назначенными обратному вызову. Этот указатель следует использовать для отмены регистрации набора событий.

Подробную информацию о том, что должен реализовать обратный вызов, см. в документации по FetchExternalEventsFunct .

Публичный API для регистрации набора событий, хранящихся извне.

Зарегистрируйте обратный вызов формы FetchExternalEventsFunct . Этот API требует, чтобы платформа знала количество событий при регистрации. Внутренняя работа также требует, чтобы это число было постоянным. Поскольку этот API не позволяет платформе регистрировать определенные идентификаторы событий, это не позволяет платформе постоянно хранить события (по крайней мере, с уникальными идентификаторами событий).

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

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

Указатель на структуру ExternalEvents в случае возникновения ошибки будет иметь значение NULL, в противном случае он будет заполнен идентификаторами начального и конечного событий, назначенными обратному вызову. Этот указатель следует использовать для отмены регистрации набора событий.

Подробную информацию о том, что должен реализовать обратный вызов, см. в документации по FetchExternalEventsFunct .

Запланируйте задачу выгрузки журнала.

Функция решает, планировать ли процесс разгрузки задач, и если да, то она планирует асинхронный запуск LoggingFlushHandler в потоке Weave.

Решение о планировании промывки зависит от трех факторов:

явный запрос на очистку буфера

состояние буфера событий и объем данных, еще не синхронизированных с потребителями событий

существует ли уже ожидающее событие запроса на очистку запроса.

Явный запрос на планирование сброса передается через входной параметр.

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

Ожидающее состояние журнала событий указывается переменной mUploadRequested . Поскольку эта функция может вызываться несколькими потоками, mUploadRequested необходимо читать и устанавливать атомарно, чтобы избежать планирования избыточного LoggingFlushHandler до отправки уведомления.

Сериализуйте события Weave всех типов важности.

Сериализует события в WeaveCircularTLVBuffer и связанные состояния в предоставленный буфер.

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

SetExchangeManager

WEAVE_ERROR SetExchangeManager(
  nl::Weave::WeaveExchangeManager *inMgr
)

SetLoggingEndpoint

WEAVE_ERROR SetLoggingEndpoint(
  event_id_t *inEventEndpoints,
  size_t inNumImportanceLevels,
  size_t & outLoggingPosition
)

void SkipEvent(
  EventLoadOutContext *aContext
)

void ThrottleLogger(
  void
)

void UnregisterEventCallbackForImportance(
  ImportanceType inImportance,
  event_id_t inEventID
)

void UnthrottleLogger(
  void
)

Публичные статические функции

void CreateLoggingManagement(
  nl::Weave::WeaveExchangeManager *inMgr,
  size_t inNumBuffers,
  const LogStorageResources *const inLogStorageResources
)

void DestroyLoggingManagement(
  void
)

LoggingManagement & GetInstance(
  void
)