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

HealthEvent

项目
07/19/2023

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

属性

名称	类型	必须
`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`

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

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

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

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

通过