消息路由故障排除

本文提供关于如何监视和解决 IoT 中心消息路由的常见问题的指导。

建议监视与消息路由和终结点相关的 IoT 中心指标，以便对发送的消息有个大致了解。 还可以创建一个诊断设置，以便将 IoT 中心资源日志中路由的操作发送到 Azure Monitor 日志、事件中心或 Azure 存储以进行自定义处理。 若要详细了解如何使用指标、资源日志和诊断设置，请参阅监视 IoT 中心。 有关教程，请参阅通过 IoT 中心设置和使用指标和资源日志。

如果要维护与任何路由上的查询不匹配的消息，建议同时启用回退路由。 可以按照配置的保留天数，在内置终结点中保留这些消息。

以下是观察到的最常见的消息路由问题。 若要开始排除故障，请选择问题，了解详细步骤。

• 设备上的消息未按预期方式路由
• 从内置事件中心终结点处获取消息的过程突然停止

若要排查此问题，请分析以下信息。

所有与路由相关的 IoT 中心指标都以“Routing”作为前缀。 你可以组合来自多项指标的信息来确定问题的根本原因。 例如，使用指标“路由传递数”来确定当消息与任何路由上的查询不匹配并且已禁用回退路由时传递到终结点或已删除的消息数。 检查“路由延迟”指标来观察消息传递的延迟是否稳定或增加。 延迟的增加可能表示特定终结点有问题，建议检查终结点的运行状况。 这些路由指标还具有维度，这些维度提供有关指标的详细信息，如终结点类型、特定终结点名称和消息未传递的原因。

观察“路由”诊断日志，获取有关路由和终结点操作的详细信息，或者确定错误和相关的错误代码以进一步了解问题。 例如，日志中的操作名称 RouteEvaluationError 表示由于消息格式问题而无法评估路由。 使用为特定的操作名称提供的提示来缓解此问题。 将事件记录为错误时，日志还提供有关评估失败原因的详细信息。 例如，如果操作名称是“EndpointUnhealthy”，则错误代码 403004 指示终结点空间不足。

使用 REST API 获取终结点运行状况，以获取终结点的运行状况状态。 此 API 还提供有关消息上一次成功发送到终结点的时间、上一个已知错误、上一次发生已知错误的时间以及上一次尝试对此终结点发送的时间的信息。 使用为特定的上一个已知错误提供的缓解措施。

若要排查此问题，请分析以下信息。

在创建一个路由后，数据将停止流向内置终结点，除非创建了到该终结点的路由。 若要确保在添加新路由后消息继续流向内置终结点，应配置一个指向事件终结点的路由。

回退路由将所有不满足任何现有路由上的任何查询条件的消息发送到与事件中心兼容的内置事件中心（消息/事件）。 如果已启用消息路由，则可以启用此回退路由功能。 如果没有到内置终结点的路由并且已启用回退路由，则仅与路由上的任何查询条件不匹配的消息将被发送到内置终结点。 此外，如果已删除所有现有路由，则必须启用回退路由，才能接收内置终结点处的所有数据。

可在 Azure 门户中使用 IoT 中心的“消息路由”边栏选项卡启用或禁用回退路由。 还可以将 Azure 资源管理器用于 FallbackRouteProperties，以将自定义终结点用于回退路由。

REST API 中的 Get Endpoint Health（获取终结点运行状况）提供终结点的运行状况以及上一个已知错误，以确定终结点不正常的原因。 下表列出了最常见的错误。

下面是路由资源日志中记录的操作名称和错误代码。

UndefinedRouteEvaluation 、RouteEvaluationError 和 OrphanedMessage 操作限制为每个 IoT 中心每分钟记录一次。

如果需要更多帮助，可以联系 Azure 支持上的 Azure 专家。 或者，你也可以提出 Azure 支持事件。 请转到 Azure 支持站点提交请求。