wxCC Data Connector-Splunk 将选定的 Webex 联络中心数据传输到 客户管理的 Splunk HTTP 事件收集器 (HEC) 终端以进行近乎实时的分析。 当连接 器处于活动状态时,它会流式传输以下记录类型:
| 记录类型 | 名称 |
| AAR | 座席活动记录 |
| ASR | 座席会话记录 |
| CAR | 联系人活动记录 |
| CSR | 联系人会话记录 |
当连接器处于活动状态时,将流式传输所有四种支持的记录类型。 Control Hub 不为该连接器提供每条记录的类型选择。
配置 Splunk 目的地
在你开始之前:
- 具有创建索引和 HTTP 事件收集器令牌权限的 Splunk Cloud 或 Splunk Enterprise 实例。
- 有权创建或使用目标索引并创建 HEC 令牌。
- 为 wxCC 数据创建目标索引。
- wxCC 生产出口子网已添加到 Splunk HEC 摄取 IP 允许列表中。
数据隐私和合规性
- CSR 全局变量在交付给 Splunk 之前会被删除,以支持 PCI 合规性。
客户数据保护责任
客户有责任确保其 Splunk 配置和 交付数据的处理符合适用的隐私和数据保护要求, 包括 GDPR。
配置 Splunk 的步骤
允许 wxCC HEC 摄取流量
- 使用 Webex 联络中心安全设置文章来
确定客户数据中心的 NAT 网关 IP 地址,并将每个
地址表示为
/32CIDR 子网,例如。203.0.113.10/32 - 在 Splunk 中,打开设置 > 服务器设置 > IP 允许 列表。
- 选择 HEC 访问权限进行提取,添加生成的
/32子网 记录,然后保存允许列表。 许可名单更改可能需要一段时间才能传播。
允许列出 wxCC 生产出口子网。如果未 在 HEC 访问权限下添加所需的子网以供摄取,则 wxCC 数据将无法到达配置的 Splunk 索引。
创建目标索引
- 在 Splunk 中,打开 “设置”。
- 转到数据 > 索引。
- 选择 “新建索引”。
- 输入索引名称并选择符合客户 要求的保留和存储设置。
-
保存索引。
拥有 100 个 代理的组织每秒生成大约 16 个事件,相当于每天大约 2.64 GiB 的有效负载,而每个事件的平均负载为 2 KiB。 根据代理 数量线性扩展估计的有效负载容量,然后为 Splunk 索引开销、保留 和使用模式留出额外的容量。
创建 HEC 代币
- 在 “设置” 中,搜索并打开 HTTP 事件收集器。
- 选择新令牌并提供描述性名称。
- 将 “启用索引器确认” 保持未选中状态。
- 将令牌与上一步中创建的索引相关联。
- 保存代币并安全地复制其值。 只有在 Control Hub 中 配置连接器时才需要令牌值。
保持 “启用索引器确认” 处于禁用状态。wxCC 数据连接器 — Splunk 不支持索引器确认。 启用它会阻止成功 交付连接器。
识别 HEC 网址
连接器将批处理的 JSON 有效载荷发送到 HEC 收集器端点:
https://http-inputs-<splunk-cloud-domain>/services/collector
对于名为的 Splunk Cloud 实例 cisco-wxcc-connector.splunkcloud.com,网址为:
https://http-inputs-cisco-wxcc-connector.splunkcloud.com/services/collector
使用正确的 HEC 端点
连接器发送成批的 JSON 有效负载。 输入以结尾的 HEC 网址。
/services/collector请勿使用
/services/collector/event,这是单一事件
端点。
在 Control Hub 中添加连接器
- 通过 https://admin.webex.com 登录客户组织。
- 导航到 “服务” > “联络中心” > “租户设置” > “集成” > “连接器”。
- 在 wxCC 数据连接器 — Splunk 卡上,选择添加连接器。
- 输入以下值:

字段 值 名称 连接器的可识别名称。 HTTP 事件收集器 (HEC) URL 以结尾的 HTTPS 批处理 HEC 网址。 /services/collectorHEC 代币 为目标索引创建的令牌。 输入 不带 Bearer前缀的令牌值。 - 选择保存。
- 确认连接器显示在 “活动连接器” 下方。
在 Splunk 中查看 wxCC 数据
- 在 Splunk 主页上,打开 “搜索和报告”。
- 搜索已配置的索引,例如:
index="<index-name>"
使用该sourcetype字段按记录类型进行筛选:
| 记录类型 | 来源类型 |
| AAR | wxcc:aar |
| ASR | wxcc:asr |
| CAR | wxcc:car |
| CSR | wxcc:csr |
ASR 和 CSR 记录可以有多个已交付的更新。 使用最大
processingTime值来识别最新更新。
编辑、停用、重新激活或删除连接器
要管理连接器,请打开 “服务” > “联络中心” > “租户设置” > “ 集成” > “连接器”,然后选择连接器名称。
- 在编辑连接器的凭据字段之前,必须先停用该连接器。
- 停用连接器会停止组织交付。 在 它处于非活动状态时生成的事件不会发送到 Splunk。
- 编辑后,选择 “重新激活” 以恢复交付。
- 要删除连接器,请先将其停用,然后选择删除。
- 更换连接器时,请在添加 替换接头之前停用并移除现有连接器。