Gnip 控制台

​

概览

企业控制台（console.gnip.com）面向已签订 Enterprise API 访问合同的企业数据客户开放。如果您目前不是企业数据客户但想了解更多信息，可在此处进一步了解enterprise data。

本文概述了 X 的 Enterprise 控制台仪表板。以下章节对应控制台中的各个区域，涵盖产品详情、使用情况以及通用账户管理。如您对自己的账户有任何疑问，请联系指定的客户经理，或查阅我们的Enterprise 产品技术文档。

在与客户经理进行 Enterprise 试用与入门流程期间，企业客户将获得 console.gnip.com 的登录信息。该站点提供用于查看和配置 Enterprise 产品访问权限的用户界面。控制台的初始管理员访问权限由 X 在 Enterprise 入门流程中设置，随后管理员可添加其他用户。Enterprise 控制台可帮助您管理并查看与 Enterprise 产品相关的更多详细信息。 

下方视频概述了 console.gnip.com 仪表板的各个部分。 

免责声明：请注意，视频中展示的某些功能（包括某些 stream 丰富化功能以及非 X 数据源产品）可能已不再提供。

​

产品选项卡

在 console.gnip.com 登录您的账户后，您将进入仪表板的“产品”选项卡。此页面提供您账户当前可用的 Enterprise 产品概览。

对于采用流式传输的产品（如 PowerTrack 或 Decahose），此页面会列出产品名称与 stream 标签、当前活跃连接数、（如适用）每个产品当前生效的规则数量，以及最近 24 小时内交付的活动（例如 Post）的原始计数。

对于采用 REST 交付的产品（如 Search API），此页面会列出产品名称、标签（也显示为“streams”）、通过这些 endpoint 返回的当前活动（例如 Post），以及每个 endpoint 的若干不同请求计数。

请注意，Usage API 会以编程方式提供其中的大部分 data。

点击名称或设置按钮可查看每个 stream 的具体详情。

​

概览

在主仪表板中点击任意 stream，将进入该 stream 的概览页面。

对于流式传输交付类产品，此页面包括：

1. 显示通过各个特定 stream 连接向你传送的活动数量的体量图

2. 当前在该 stream 上处于活动状态的连接详情（连接 id 和 IP 地址）

3. 你的 stream 的近期连接、断开连接和规则更新事件日志

请注意，可通过右上角的链接调整图表的刻度。你可以点击图表正下方图例中的相应项来切换单个连接和断开连接的可见性。

​

连接

“连接”页面提供你的 stream 上近期连接事件的详细信息，包括每次连接的开始和结束时间（UTC 24 小时制）、连接持续时间、发起连接的服务器 IP、用于参考的唯一连接 id，以及当前连接状态。状态与指定连接的最新事件相对应——例如“Client Connected”，或断开连接（并标明断开类型）。有关连接调试的更多信息，请参阅断开连接说明指南。

​

API 帮助

API 帮助页面提供与你的 stream 相关的 API endpoint URL，以及（如适用）该 stream 的 Rules API endpoint。除此之外，还包含示例 curl 命令、连接到 stream endpoint 的操作指南，以及如何通过编程方式在你的 stream 的 Rules API endpoint 中添加、delete 和列出现有规则的说明。

​

规则

“规则”选项卡适用于 PowerTrack stream，并通过在用户界面中手动输入纯文本规则，提供一种快速上手的方式。请注意，该界面采用此手动方式最多仅支持添加 1000 条规则，且仅应用于初始测试。我们建议在任何生产环境中通过 Rules API 以编程方式管理你的规则。

​

设置

“设置”选项卡可用于切换 stream 中 data 的输出格式，支持多种格式选项。要切换格式，只需使用对应不同选项的单选按钮。更改将在重新连接到 stream 时生效。请注意，更新此设置会在下一次请求或连接时立即应用，新的格式可能会导致你的解析器出现问题。

请注意：如需获取尽可能多的数据，推荐选择“保留 data 的原始格式”，该选项将以增强的本机格式返回 data，详见此处。Activity streams 格式说明见此处。

​

使用选项卡

“使用”选项卡可按不同时间范围展示你对各个 stream 的使用情况。若需以编程方式获取使用信息，请参阅Usage API。

​

每月

“Monthly Usage” 页面按产品细分显示你的 stream 使用情况。比如，针对某个数据源的覆盖类产品（例如 PowerTrack、Historical PowerTrack 和 PowerTrack Replay）会被归组，以分别提供各自的数据以及合并汇总计数。计数包括：本月截至当前的累计、预计月末值（基于本月迄今的使用情况和本月剩余时间）以及前两个月的计数。

需要注意的是，这些计数会在每个产品和 stream 维度进行去重。如果你通过与同一 PowerTrack stream 的多个连接接收到同一条 Post，则该 Post 在此处只会被计数一次。计数每 24 小时于 00:00 UTC 更新。

​

每日

“每日使用量”页面提供当月每天的去重统计，并按产品维度细分。统计会在每天的 UTC 00:00 更新一次。

​

规则

规则限制基于您签订的 PowerTrack 规则套餐，并适用于给定“type”的所有 stream。每当添加或删除一条新规则时，计数都会更新。

​

账户标签页

​

我的个人资料

在此查看您的个人资料详情并更改密码。此外，您还可以为自己的账户配置使用阈值通知。API 状态通知可在状态页面 https://api.twitterstat.us 获取。

​

账户设置

您可以添加、删除和编辑用户，并为单个用户及用量阈值警报配置电子邮件通知。

请注意，用户分为三种类型：Account Admin、User 和 Email Only。  

• Account admins 可创建/删除/编辑其他用户，并可使用用户名（电子邮箱）与密码进行基本身份验证以连接到 Enterprise API

• Users 无法创建或修改其他用户，但可使用用户名（电子邮箱）与密码进行基本身份验证以连接到 Enterprise API

• Email Only 用户无法访问控制台，无权连接到 Enterprise API；仅当在“Notifications”部分配置为接收时才会收到通知。

​

使用阈值

为你的产品配置用量阈值。对于在个人资料中启用了相关通知的用户，每个产品在达到警告阈值或关键阈值时都会触发电子邮件提醒。

请注意，这些阈值每天在 19:30（UTC）进行一次评估，不会实时评估。