故障排除

故障排除的目标是确定为什么某些事情无法正常工作,并解释如何解决问题。通过本故障排除指南,我们努力引入故障排除方法,帮助管理员确定 Citrix微应用 出现问题的原因。

故障排除过程包括了解、指定和完整描述问题。准确的问题描述可帮助您和 Citrix 支持人员知道从何处开始找到问题的原因。在进行故障排除的过程中,您通常会找到足够的信息来解决问题,尽管这可能并非在所有情况下都能解决问题。这些过程的结果至少可以很好地描述问题状态,这是开始解决问题的最佳方法。

以下是故障排除过程的概述:

  1. 建立故障状态: 是否可以重现问题?如果是这样,请重现问题并记录为重现问题而执行的确切步骤。如果没有,请记录密钥详细信息。最后,指定行为并确定问题的范围。

  2. 调查和收集证据: 将平台与环境问题隔离开来。查找线索并从微应用 生成器、事件日志、记录集成系统 (SoR) 和身份提供商收集数据。

  3. 向 Citrix 支持提供结果和上下文信息的摘要: 建立故障状态并收集证据后,如果您没有找到原因,请向 Citrix 支持提供测试结果和上下文信息。

现在,让我们更详细地了解故障排除过程中的每个步骤。

建立失败状态

如果您遇到可重现的问题,请记录您执行的确切步骤。尽可能详细。如果问题无法重现,请记录尽可能多的有关不需要的行为的详细信息是非常重要的。然后指定并确定行为的范围。

注意:

请记住,必须先运行增量同步,然后用户才能获得通知卡。等待计划的增量同步,或者手动运行它。

可重复性问题

对于可重现的问题,请记录您执行的确切步骤。尽可能详细。

让我们举一个例子来说明如何重现未显示在订阅者的 Workspace 活动源中的通知卡问题的过程:

问题陈述:

审批支出报告的 Workday 通知未显示在 User1 的 Workspace 活动上传数据中。

重现步骤(实际行为):

  1. AdminA 在微应用生成器中添加了 Workday 集成。
  2. 成功完全同步。
  3. 成功增量同步。
  4. 已配置的微应用审批支出报告。
  5. 配置的通知审批费用报表。
  6. 配置的数据源卡设置-包括截图。
  7. User1 订阅微应用。
  8. 将更改应用于触发特定用户的通知的 Workday。
  9. User2 是 User1 的直接报告申请的支出报告批准。
  10. User1 登录到 Workspace。
  11. User1 报告说,他们没有收到数据源卡。
  12. AdminA 在微应用生成器中运行通知。
  13. AdminA 在微应用生成器中检查了事件日志。
  14. AdminA 收到以下错误消息(插入错误文本或屏幕截图)。

无法重现

重现这个问题并不总是可能的。如果问题无法重现,请记录尽可能多的有关不需要的行为的详细信息是非常重要的。让我们采用与上面相同的例子,但是在问题不再发生的情况下:

问题陈述:

审批支出报告的 Workday 通知未显示在 User1 的 Workspace 活动上传数据中。

重现步骤(实际行为):

记录导致此问题的步骤,尽可能详细。

  1. User2 是 User1 的直接报告,User2 在星期五(包括日期)下午 2:30 使用 Workday 微应用从 Workspace 申请支出报告批准。
  2. User1 下午 3:30 登录到 Workspace Friday(包括日期)。
  3. User1 报告说,他们没有收到数据源卡。
  4. 数据源卡从未显示在 User1 的数据源中。

查看并记录不需要行为的当前状态。

  1. AdminA 在星期五下午 2:30 检查了微应用生成器的事件日志。
  2. 在下午 2:30:50 为 User1 成功生成了通知。
  3. AdminA 在 Workday 没有看到错误,但确实看到了来自 User2 的请求。
  4. 该请求仍未获批准。

指定行为

现在,让我们指定行为。为了缩小问题的范围并产生逻辑可能的原因,重要的是要更多地了解问题的行为和程度。首先回答以下问题:

  • 问题何时开始(尝试获取时间戳到第二个)?
  • 此操作以前有没有工作?
  • 如果之前有效,则进行了哪些更改?
  • 此错误发生的频率(获取后续发生的日期/时间)?
  • 它是间歇性还是偶尔发生(遵循模式/时间表与否?
  • 所有集成是否受到影响?
  • 是否所有的微应用都受到影响?
  • 是否所有用户都受到影响?
  • 是否影响所有身份验证类型?
  • 是否有正确的配置?

问题的程度

确定问题的范围。您可能没有上述所有问题的答案。可能有必要确定一些基本的测试计划,以确定问题的适当程度。这些测试因正在调查的问题类型而异。重要的是,确保任何测试都遵循适当的安全性、合规性和性能指南和注意事项。

对于通知问题,尝试以下一些测试来确定范围并进一步指定实际行为可能是有意义的:

  • 撤消问题发生之前所做的任何更改。
  • 让 User1 尝试不同的浏览器。
  • 让 User1 尝试隐身模式。
  • 尝试使用其他 Workspace 用户帐户(类似于 User1)。
  • 尝试使用其他 Workspace 用户帐户(类似于 User2)。
  • 尝试其他集成 (SoR) 用户帐户。
  • 尝试不同的集成 (SoR)。
  • 尝试不同的微应用程序。
  • 尝试另一个通知。
  • 使用不同但相似的通知设置。

调查和收集证据

还有一些额外的技术可用于收集更多证据以揭露或支持可能的原因。务必将 Citrix 平台问题与客户环境问题隔离开来。

检查 Citrix 平台问题

对于像微应用这样的 Citrix Cloud 服务,请确保没有影响性能的全局中断:

  • 导航到 https://status.cloud.com/ 查看是否存在任何已知中断。
  • 在 Citrix Cloud 控制台 (customer.cloud.com) 中检查任何影响云或特定 Citrix Cloud 客户的问题通知。 在 Workspace 中查找通知
  • 确保在 Workspace 配置下将微应用服务作为源启用:
    1. 登录 Citrix Cloud 后,从菜单中选择 Workspace 配置
    2. 选择服务集成
    3. 确保微应用标记为已启用。有关设置 Workspace 微应用的完整详细信息和屏幕截图的更多信息,请参阅入门

检查客户环境问题

验证集成是否正确同步。如果遇到同步错误,请验证帐户详细信息:

  1. 检查集成是否存在错误。登录到 Citrix Cloud 后,选择微应用磁贴上的管理以打开微应用管理控制台。
  2. 在微应用 管理控制台中,检查集成是否正确同步。看看旁边的集成。您可以在此屏幕截图中看到错误:

    同步失败

  3. 如果出现同步失败,请检查集成日志。选择要查看集成日志的集成旁边的菜单。
  4. 选择集成日志
  5. 拍摄屏幕截图或复制错误消息,包括时间戳。以下是一个示例错误消息:

    同步失败

    有关集成日志的详细信息,请参阅设置数据同步

  6. 现在我们需要再次运行集成同步。选择要为其设置同步的集成旁边的菜单,然后选择同步如何设置数据同步
  7. 运行增量同步。检查事件日志并记录任何错误。
  8. 运行完全同步。检查事件日志并记录任何错误。

    有关运行数据同步的详细信息,请参阅设置数据同步

如果在同步过程中遇到任何错误,请验证以下详细信息:

  1. 验证服务帐户在集成端 (SoR) 上是否具有适当的权限。如何做到这一点对于每个 SoR 都是唯一的。例如,对于 Workday,请参阅“管理安全组权限”。
  2. 验证服务帐户凭据在微应用控制台和 SoR 中是否有效。
  3. 验证客户端 ID 和密码是否正确(如有必要)。

    有关详细信息,请参阅设置服务身份验证

在微应用 生成器中检查通知

现在你需要检查受影响的微应用程序。我们将以我们一直在使用的 Workday 审批微应用程序为例。检查订阅和通知配置,然后再次运行事件以收集相关 UUID。

  1. 首先,让我们确保用户 1 已订阅通知。从受影响的微应用菜单中选择订阅检查用户订阅
  2. 接下来,打开受影响的通知。从受影响的微应用菜单中选择编辑,然后选择失败通知。
  3. 验证并通知 配置是否正确: 验证通知配置
  4. 预览微应用,以确保它显示如预期。以下屏幕截图显示了此选项和接下来两个选项的位置。 预览、运行和显示事件日志通知
  5. 选择运行事件
  6. 事件运行完毕后,选择显示事件日志,然后选择任何错误的下拉菜单。记录任何错误消息,记录任何相关的 UUID(通知 ID 或事务 ID),并将事件日志文本复制到 txt 文件。

有关详细信息,请参阅生成事件通知

检查您的集成 (SoR)

  1. 检查集成 SoR 事件日志,了解有关失败的任何详细信息。
  2. 记录要提供给 Citrix 支持部门的任何相关信息。

有关详细信息,请参阅设置集成

检查身份提供商

  1. 验证活动目录或其他标识提供程序是否正确设置。
  2. 验证身份验证配置是否正确。
  3. 查找丢失的数据、不正确或不兼容的配置和错误。

有关详细信息,请参阅入门

向 Citrix 支持部门提供结果摘要和上下文信息

包括前面几节的结果和以下上下文信息。请注意释放敏感数据。有关敏感数据的详细信息,请参阅微应用技术安全概述

  • 问题最后一次已知发生的确切时间。
  • 受影响的集成 (SoR) 名称,如微应用生成器和来自微应用控制台 URL 的集成 UUID 中所示。
  • 受影响的微应用程序名称,如微应用程序生成器和微应用程序 UUID 中所示。
  • 受影响的通知名称,如微应用 生成器和来自微应用 控制台 URL 的 UUID 中所示。
  • 受影响的用户名 (Workspace)、电子邮件和 OID。
  • 受影响的用户名(集成 SoR)。
  • 来自微应用 事件日志的以下详细信息:
    • 问题最后一次已知发生的确切时间。
    • 受影响的卡 UUID。
    • 受影响的交易 ID。
    • 错误/异常详细信息。复制和录制如上所示。