管理Kafka数据流

所需权限：数据流

此页面可帮助您设置和订阅Kafka数据流。 CXone Mpower以流的形式提供 IVR 交互式语音应答。 自动电话菜单联系人通过语音或按键输入来获取信息、路由呼入语音呼叫，或两者兼而有之。 日志，因此您必须设置一种在您控制的目标使用数据的方法。 完整设置包括CXone Mpower中的配置步骤，以及设置将订阅和使用流的服务或系统。

在 CXone Mpower 中配置流时，您可以选择使用以下架构格式的数据：

• 原始
• JSON
• 阿夫罗
• 带有换行符的 JSON
• 带换行符的 JSON AVRO

设置Kafka数据流

首先，计划如何使用Kafka流。 您必须具有技术资源才能创建可以订阅流的目标。 这要求您满足安全要求：

• 提供要用于访问Kafka主题的 IPv4 CIDR。 这可以确保CXone Mpower您的 IP 是合法且被允许的。 您可以一次添加两个 IP CIDR。

• 一种使用CXone Mpower用户名和密码凭据的身份验证方法。

在Kafka中创建CXone Mpower数据流

以下说明可帮助您创建数据流、生成一组凭证，并添加将用于订阅数据流的 IP CIDR。

1. 单击应用程序选择器 并选择Admin。
2. 转至帐户设置 > 事件数据流。

3. 单击新建数据流。

4. 输入数据流的名称和可选的描述。

5. 选择IVR日志作为事件类型。

6. 对于数据格式，选择您希望数据采用的架构格式。

7. 对于目标流类型，选择Kafka 外部。

8. 生成一组凭据。 这是可用于订阅Kafka流的用户名和密码。

   1. 单击新建数据流页面安全部分中的管理;将打开“安全管理器”窗口。

   2. 对于 别名，输入凭据集的唯一名称。 您必须输入至少六个字母数字字符。 唯一允许使用的特殊字符是短划线 （-） 或下划线 （_）。

      您一次只能为数据流创建两组凭证。 如有必要，您可以删除一组凭据然后创建一个新凭据。

   3. 单击创建并下载。 这会将用户名和密码下载为 CSV 文件。

9. 在同一安全管理器窗口中，向下滚动并输入要用于数据流的 IP CIDR：

   1. 向下滚动到允许的 IP CIDR 部分。

   2. 对于 IP CIDR，输入要通过其订阅的 IP 地址的完整 CIDR。 请务必包含完整 CIDR 地址的 IP 地址和子网掩码。 您可以一次输入多个 CIDR，用逗号分隔。

      • 一个数据流一次只能有两组 IP CIDR。 如有必要，您可以删除 IP CIDR。
      • Data Streams目前支持 IPv4。
      • 允许的最大范围介于 /24 到 /32 之间。

   3. 单击 Ok。

10. 单击创建。

创建数据流后，底部会显示流详细信息。 这包括代理详细信息、使用者组 ID 和主题名称。 您可以使用这些来设置将使用数据的服务或系统。

此外，数据流通常在创建后立即变为活动状态。 最多可能需要 15-30 分钟。

设置目的地以订阅Kafka流

在您自己的Kafka目标 中，您必须插入在上一节中生成的流中转站详细信息。 您的技术团队必须利用他们的专业知识来做到这一点。

删除Kafka凭据

出于安全考虑，你可能想要或需要替换一组凭据。 在CXone Mpower中，可以选择软删除或硬删除一组凭据。 软删除意味着凭据在两天内变为非活动状态，之后它们将被完全删除。 这使您有时间生成一组新凭据，并为您的Kafka订阅实施这些凭据。 硬删除是立即删除。

1. 单击应用程序选择器 并选择Admin。
2. 转至帐户设置 > 事件数据流。
3. 选择所需的数据流。
4. 在列出凭据别名的安全部分中，单击管理。
5. 单击要删除的凭据的“作”列中的删除图标。 此时将显示确认通知。
6. 选择是要软删除还是硬删除凭据：
   • 若要软删除，请确认删除。 状态图标将变为黄色。 两天后，凭据将被永久删除。
   • 要硬删除，请启用复选框以立即删除凭据，然后确认删除。

排查Kafka Data Streams问题

如果您的数据流订阅无法正常运行，请检查以下内容：

• 您在订阅流的系统中输入了正确的代理详细信息。 这些可以在数据流详细信息的流详细信息部分的CXone Mpower中找到。

• 数据流的详细信息，以确保您输入了正确的 IPv4 CIDR。 确保这些 IP 在界面中也显示为活动CXone Mpower。

• 使用数据流的系统中的凭据是否正确。