HealthEvent
Представляет сведения о работоспособности, сообщаемые о сущности работоспособности, такой как кластер, приложение или узел, с дополнительными метаданными, добавленными диспетчером работоспособности.
Свойства
| Имя | Тип | Обязательно |
|---|---|---|
SourceId |
строка | Да |
Property |
строка | Да |
HealthState |
string (перечисление) | Да |
TimeToLiveInMilliSeconds |
string (duration) | Нет |
Description |
строка | Нет |
SequenceNumber |
строка | Нет |
RemoveWhenExpired |
Логическое | Нет |
HealthReportId |
строка | Нет |
IsExpired |
Логическое | Нет |
SourceUtcTimestamp |
строка (дата-время) | Нет |
LastModifiedUtcTimestamp |
строка (дата-время) | Нет |
LastOkTransitionAt |
строка (дата-время) | Нет |
LastWarningTransitionAt |
строка (дата-время) | Нет |
LastErrorTransitionAt |
строка (дата-время) | Нет |
SourceId
Тип: строка
Обязательный: да
Имя источника, которое определяет клиента, службу наблюдения или компонент системы, создавший информацию о работоспособности.
Property
Тип: строка
Обязательный: да
Свойство информации о работоспособности. Один объект может возвращать отчеты о работоспособности для разных свойств.
Это свойство имеет строковый формат, а не фиксированное перечисление, чтобы создатель отчетов мог гибко классифицировать состояние, активировавшее отчет.
Например, создатель отчета с идентификатором источника LocalWatchdog может отслеживать состояние доступного дискового пространства на узле и передавать для этого узла свойство AvailableDisk.
Этот же создатель отчета может отслеживать подключения узла и передавать свойство Connectivity для того же узла.
В хранилище данных о работоспособности эти отчеты обрабатываются как независимые события работоспособности для указанного узла.
Кроме идентификатора источника, свойство однозначно идентифицирует данные о работоспособности.
HealthState
Тип: string (перечисление)
Обязательный: да
Состояние работоспособности сущности Service Fabric, например кластера, узла, приложения, службы, секции, реплики и т. д.
Возможны следующие значения:
Invalid— указывает недопустимое состояние работоспособности. Все перечисления Service Fabric имеют недопустимый тип. Значение равно нулю.Ok— указывает, что состояние работоспособности в порядке. Значение равно 1.Warning— указывает, что состояние работоспособности находится на уровне предупреждения. Значение равно 2.Error— указывает, что состояние работоспособности находится на уровне ошибки. Необходимо изучить состояние работоспособности ошибки, так как они могут повлиять на правильную функциональность кластера. Значение равно 3.Unknown— указывает неизвестное состояние работоспособности. Значение равно 65 535.
TimeToLiveInMilliSeconds
Тип: string (duration)
Обязательный: нет
Срок, в течение которого отчет о работоспособности считается действительным. В этом поле указывается длительность в формате ISO8601.
Если клиенты создают периодические отчеты, периодичность отправки отчетов должна быть выше, чем срок жизни отчетов.
Если клиенты передают отчеты об изменении состояния, для них можно установить бесконечный срок действия.
По истечении срока жизни событие работоспособности, которое содержит данные о работоспособности, удаляется из хранилища данных о работоспособности (если RemoveWhenExpired имеет значение true) или считается ошибкой (если RemoveWhenExpired имеет значение false).
Если значение не указано, по умолчанию устанавливается бесконечный срок жизни.
Description
Тип: строка
Обязательный: нет
Описание информации о работоспособности. Это свойство предоставляет информацию об отчете в произвольном текстовом формате, доступном для чтения.
Максимальная длина строки для описания составляет 4096 символов.
Более длинные строки автоматически усекаются.
При усечении в последние символы описания помещается маркер [Truncated], длина которого входит в строку длиной 4096 символов.
Наличие маркера указывает на усечение.
Обратите внимание, что усеченное описание включает менее 4096 символов исходной строки.
SequenceNumber
Тип: строка
Обязательный: нет
Порядковый номер отчета о работоспособности в формате числовой строки.
Порядковый номер отчета используется хранилищем данных о работоспособности для отслеживания устаревших отчетов.
Если значение не указано, порядковый номер автоматически создается клиентом работоспособности при добавлении отчета.
RemoveWhenExpired
Тип: boolean
Обязательный: нет
Это значение указывает, удаляется ли отчет из хранилища работоспособности после истечения срока его действия.
Если задано значение true, отчет будет удален из хранилища работоспособности после истечения срока его действия.
Если задано значение false, отчет с истекшим сроком действия рассматривается как указывающий на ошибку. Для этого свойства по умолчанию используется значение false.
Если клиенты создают периодические отчеты, для параметра RemoveWhenExpired следует использовать значение false (по умолчанию).
Таким образом, если у репортера есть проблемы (например, взаимоблокировка) и он не может сообщить, сущность оценивается с ошибкой при истечении срока действия отчета о работоспособности.
Такая сущность будет находиться в состоянии "Ошибка работоспособности".
HealthReportId
Тип: строка
Обязательный: нет
Идентификатор отчета о работоспособности, который идентифицирует отчет о работоспособности и может использоваться для поиска более подробных сведений о конкретном событии работоспособности в aka.ms/sfhealthid
IsExpired
Тип: boolean
Обязательный: нет
Возвращает значение true, если истек срок действия события работоспособности, в противном случае — значение false.
SourceUtcTimestamp
Тип: строка (дата и время)
Обязательный: нет
Дата и время отправки отчета о работоспособности источником.
LastModifiedUtcTimestamp
Тип: строка (дата и время)
Обязательный: нет
Дата и время последнего изменения отчета о работоспособности хранилищем работоспособности.
LastOkTransitionAt
Тип: строка (дата и время)
Обязательный: нет
Если текущее состояние работоспособности — "Ok", это свойство возвращает время, когда отчет о работоспособности был впервые предоставлен с помощью "ОК".
Для периодической отчетности может быть создано множество отчетов с одинаковым состоянием.
Это свойство возвращает дату и время получения первого отчета о работоспособности ok.
Если текущее состояние работоспособности — "Ошибка" или "Предупреждение", возвращает дату и время последнего состояния работоспособности в "ОК", прежде чем переходить в другое состояние.
Если состояние работоспособности никогда не было "ОК", значение будет равно нулю даты и времени.
LastWarningTransitionAt
Тип: строка (дата и время)
Обязательный: нет
Если текущее состояние работоспособности — "Предупреждение", это свойство возвращает время, когда отчет о работоспособности был впервые создан с параметром "Warning". Для периодических отчетов может быть создано множество отчетов с одинаковым состоянием, однако это свойство возвращает только дату и время получения первого отчета о работоспособности "Предупреждение".
Если текущее состояние работоспособности — "ОК" или "Ошибка", возвращает дату и время последнего состояния работоспособности в "Предупреждение", прежде чем переходить в другое состояние.
Если состояние работоспособности никогда не было "Предупреждение", значение будет равно нулю даты и времени.
LastErrorTransitionAt
Тип: строка (дата и время)
Обязательный: нет
Если текущее состояние работоспособности — Error, это свойство возвращает время, когда отчет о работоспособности был впервые создан с ошибкой. Для периодических отчетов могут быть созданы многие отчеты с одинаковым состоянием, однако это свойство возвращает только дату и время получения первого отчета о работоспособности "Ошибка".
Если текущее состояние работоспособности — "ОК" или "Предупреждение", возвращает дату и время последнего состояния работоспособности в "Ошибка" перед переходом в другое состояние.
Если состояние работоспособности никогда не было "Ошибка", значение будет равно нулю даты и времени.