你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

HealthEvent

表示在运行状况实体(如群集、应用程序或节点)上报告的运行状况信息,以及运行状况管理器添加的其他元数据。

属性

名称 类型 必须
SourceId string
Property 字符串
HealthState string (枚举)
TimeToLiveInMilliSeconds string (duration)
Description 字符串
SequenceNumber 字符串
RemoveWhenExpired boolean
HealthReportId 字符串
IsExpired boolean
SourceUtcTimestamp 字符串(日期时间)
LastModifiedUtcTimestamp 字符串(日期时间)
LastOkTransitionAt 字符串(日期时间)
LastWarningTransitionAt 字符串(日期时间)
LastErrorTransitionAt 字符串(日期时间)

SourceId

类型:字符串
必需:是

标识已生成运行状况信息的客户端/监视程序/系统组件的源名称。


Property

类型:字符串
必需:是

运行状况信息的属性。 一个实体可以有不同属性的运行状况报告。 该属性是一个字符串,不是固定的枚举,因此可使报告器灵活地对触发报告的状态条件进行分类。 例如,SourceId 为“LocalWatchdog”的报告器可以监视节点上的可用磁盘的状态,因此它可以报告该节点的“AvailableDisk”属性。 同一报告器可以监视节点连接,因此它可以报告同一节点的“Connectivity”属性。 在运行状况存储中,这些报告均被视为指定节点的单独运行状况事件。

与 SourceId 一起,该属性唯一地标识运行状况信息。


HealthState

类型:字符串 (枚举)
必需:是

Service Fabric 实体(例如群集、节点、应用程序、服务、分区、副本等)的运行状况。

可能的值包括:

  • Invalid - 指示运行状况无效。 所有 Service Fabric 枚举的类型都无效。 值为 0。
  • Ok - 指示运行状况正常。 值为 1。
  • Warning - 指示运行状况处于警告级别。 值为 2。
  • Error - 指示运行状况处于错误级别。 应调查错误运行状况状态,因为它们可能会影响群集的正确功能。 值为 3。
  • Unknown - 指示未知的运行状况。 值为 65535。

TimeToLiveInMilliSeconds

类型:字符串 (持续时间)
必需:否

此运行状况报告保持有效的持续时间。 此字段将 ISO8601 格式用于指定该持续时间。 当客户端定期报告时,它们应以高于生存时间的频率发送报告。 如果客户端以非定期的方式报告,它们可以将生存时间设置为无限。 生存时间过期时,包含运行状况信息的运行状况事件将从运行状况存储中删除(如果 RemoveWhenExpired 为 true),或者将会评估为处于错误状态(如果 RemoveWhenExpired 为 false)。

如果未指定,生存时间将默认为无限值。


Description

类型:字符串
必需:否

运行状况信息的说明。 它表示用于添加有关该报告的用户可读信息的自定义文本。 该说明的最大字符串长度为 4096 个字符。 如果所提供字符串的长度大于该值,它将被自动截断。 截断时,该说明的末尾字符包含一个标记“[Truncated]”,并且总字符串大小为 4096 个字符。 该标记的存在向用户指示截断已发生。 请注意,当截断时,该说明包含来自原始字符串的 4096 个以内的字符。


SequenceNumber

类型:字符串
必需:否

此运行状况报告的序列号(采用数字字符串形式)。 报告序列号由运行状况存储用来检测过时的报告。 如果未指定,序列号将在报告被添加时由运行状况客户端自动生成。


RemoveWhenExpired

类型:布尔值
必需:否

该值指示是否在报告过期时从运行状况存储删除该报告。 如果设置为 true,报告在过期后将从运行状况存储中删除。 如果设置为 false,报告在过期时将被视为错误。 此属性的值在默认情况下为 false。 当客户端定期报告时,它们应将 RemoveWhenExpired 设置为 false(默认值)。 这样,如果报告器遇到 (问题(例如死锁) 且无法报告),则会在运行状况报告过期时对实体进行错误评估。 这会将该实体标记为处于“Error”运行状况状态。


HealthReportId

类型:字符串
必需:否

用于标识运行状况报告的运行状况报告 ID,可用于在 aka.ms/sfhealthid 查找有关特定运行状况事件的更多详细信息


IsExpired

类型:布尔值
必需:否

如果运行状况事件已过期,则返回 true,否则返回 false。


SourceUtcTimestamp

类型:字符串 (日期时间)
必需:否

源发送运行状况报告的日期和时间。


LastModifiedUtcTimestamp

类型:字符串 (日期时间)
必需:否

运行状况存储上次修改运行状况报告的日期和时间。


LastOkTransitionAt

类型:字符串 (日期时间)
必需:否

如果当前运行状况状态为“确定”,则此属性返回首次使用“确定”报告运行状况报告的时间。 对于定期报告,可能已生成许多具有相同状态的报告。 此属性返回收到第一个“正常”运行状况报告的日期和时间。

如果当前运行状况状态为“错误”或“警告”,则返回在转换为其他状态之前,运行状况状态最后处于“确定”的日期和时间。

如果运行状况状态从不为“正常”,则值为零日期时间。


LastWarningTransitionAt

类型:字符串 (日期时间)
必需:否

如果当前运行状况状态为“警告”,则此属性返回首次报告运行状况报告并显示“警告”的时间。 对于定期报告,可能已生成许多具有相同状态的报告,但是,此属性仅返回收到第一个“警告”运行状况报告时的日期和时间。

如果当前运行状况状态为“正常”或“错误”,则返回在转换为其他状态之前,运行状况状态在“警告”中最后一次的日期和时间。

如果运行状况状态从未为“警告”,则值为零日期时间。


LastErrorTransitionAt

类型:字符串 (日期时间)
必需:否

如果当前运行状况状态为“错误”,则此属性返回首次报告运行状况报告并显示“错误”的时间。 对于定期报告,可能已生成许多具有相同状态的报告,但是,此属性仅返回收到的第一次“错误”运行状况报告时的日期和时间。

如果当前运行状况状态为“正常”或“警告”,则返回在转换为其他状态之前,运行状况状态在“错误”中最后一次的日期和时间。

如果运行状况状态从不为“错误”,则值为零日期时间。