网络体验监视
概述
Network Experience Monitoring (NEM) 服务（以前称为 Netscope）使服务提供商、企业、ISP 和第三方服务提供商能够以汇总的可操作数据的形式访问详细的 Radar 测量日志和标准报告。NEM 提供了几个标准的日志和报告，客户可以使用这些日志和报告来衡量他们的服务质量。
该解决方案包括“原始”Radar 测量交付和对 ITM Data API 的访问。NEM 同时提供粒度数据（作为原始测量数据或数据聚合数据）和数据阈值警报。这些服务有助于发现、隔离平台可用性以及平台对等方和底层 ISP 的性能问题。
Radar“原始”测量：Radar 测量提供每天批处理的每个事件的粒度信息。Radar 测量包括标签收集的公共社区和私有测量数据。包括可用性、响应时间、HTTP 和 HTTPS 测量的吞吐量等数据。提供了以下数据字段：
- 提供程序 ID、解析器 IP、模糊处理 (/28) 客户端 IP
- 混淆反向链接标头、用户代理、最终用户 ASN
- 解析器和客户端字段的地理数据
“原始”测量中提供的 Radar 指标包括：
- 可用性、响应时间和吞吐量（测量时）
- DNS 查找时间（可选）、TCP 连接时间（可选）和安全连接时间（可选）
- 延迟（可选）
- 下载时间（可选）
Radar 测量允许客户对收集的数据进行自己的分析。数据集包括有关一系列通信协议的提供程序性能和可用性（错误）的信息。
日志文件数据可从 AWS S3 或 Google 云存储存储桶获取 7 天。客户可以使用标准存储桶访问方法检索社区和私有数据的日志文件。
实时 Radar“原始”测量（可选）：原始 Radar 测量实时交付到 AWS S3 存储桶。这些日志通常在收集后的 5 分钟内可用。它们提供的粒度与上述 Radar 原始测量结果一样多。
数据 API：ITM Radar 数据 API 提供 Radar 公共社区和专用测量数据的汇总。数据会持续更新，大约每 60 秒批处理一次，以供 API 检索。提供数据 API 是为了让客户将 Radar 数据集成到自己的报告和控制板中。
日志共享和交付
- Radar 日志可以实时和每天发送。
- 报告每天都会运行。
- 结果将保存到 AWS S3 (S3) 或 Google Cloud Storage (GCS)。
- 日志和报告都有 7 天的保留期，并且会在创建一周后自动删除。
- 根据报告的类型，报告通常采用 TSV（制表符分隔值）或 JSON 格式。
客户将获得访问 S3 和 GCS 存储桶的登录信息。可以使用 s3cmd、适用于 S3 的 AWS CLI 或适用于 GCS 的 gsutil 之类的命令行工具来登录。S3cmd 配置文件可识别通过门户 UI 接收的访问密钥，并帮助用户连接到 S3 存储桶。
AWS CLI 需要安装在客户的计算机上才能连接到 S3 并访问日志。对于 GCS，客户通过门户界面下载接收访问密钥文件，该用户界面可与 gsutil 工具一起使用。有关详细信息，请参阅常见问题解答。
当报告可用时，客户会收到电子邮件通知。
平台设置
您必须配置您的平台以支持和生成 Netscope NEM 所需的数据。在开始之前，请确保您的平台已启用以下设置：
- 有关资源计时详细信息，请在 高级 Radar 设置 中启用 包含时间戳。
导航
从主菜单中选择 Netscope NEM。此时将打开“网络体验监视 配置”页面。
平台
选择所需的平台以启动配置过程。
注意：
只有在至少选择了一个平台或网络时，才能配置和生成日志和报告。
客户收到的汇总数据包括选定平台（所有关联网络）的 Radar 测量结果。
选择平台
对于内容服务提供商或企业，请选择CDN、云、数据中心或其他端点等平台。选择需要测量的平台。
Radar 日志
- Radar 日志可用于平台。
- 它们包括原始日志中可用字段的子集，其中包括一些匿名数据：客户端 IP /28、哈希 Referer MD5。
- 无论生成测量的页面如何，都会提供公共平台的每个测量值。
注意：
NEM 永远不会公开完整的客户端 IP。相反，它公开了 /28。例如，IP 255.255.255.255 在报告中显示为 255.255.255.240/28。
日志频率
Radar 日志可以每天（每 24 小时）生成，即一天结束时间，UTC 时间。也可以实时（每分钟）生成日志。
文件格式
选择 TSV 或 JSON 以这两种格式接收日志和报告。
测量类型
您可以为以下测量类型配置日志：可用性、响应时间和吞吐量。在报告中，1：可用性，0：HTTP 响应时间，14：HTTP 吞吐量。
资源计时详情
您可以通过单击“是”或“否”按钮选择也包括资源计时详细信息。资源计时详细信息包括：
- DNS 查找时间
- TCP 连接时间
- 安全连接时间
- 下载时间
有关日志说明，请参阅面向服务提供商和企业的 Radar 日志说明和报告。
导航计时日志
日志频率
导航计时日志可以每天（每 24 小时）生成，也就是说，一天结束时，UTC 时间。也可以实时（每分钟）生成日志。
文件格式
选择 TSV 或 JSON 以接收以上任一格式的导航计时日志。有关日志说明，请参阅导航计时日志说明。
Openmix 日志
日志频率
Openmix 日志是实时生成的（即每分钟）。这些日志为 Openmix 客户提供了实时测量结果。
文件格式
选择 TSV 或 JSON 以这两种格式接收任一格式的 Openmix 和 HTTP Openmix 日志。但是，JSON 是推荐的格式。
有关日志说明，请参阅 Openmix 日志说明。
云服务交付
此选项允许您选择交货方式。您可以选择在 AWS S3 存储桶或 Google 云存储 (GCS) 存储桶中接收日志和报告。 您可以使用提供的登录信息访问 S3 和 GCS 存储桶，并使用 s3cmd 或适用于 S3 的 AWS CLI 和适用于 GCS 的 gsutil 命令行。
AWS S3
对于要传输到 AWS S3 存储桶的日志和报告，请选择 AWS S3。
位置
位置表示 AWS S3 中保存日志和报告的存储桶。
IAM 密钥
如果您选择 AWS S3 下的生成密钥按钮，则会生成 AWS IAM 密钥（访问密钥和私有密钥）并显示在 IAM 密钥下。请务必记录密钥，因为它们不会存储在任何地方供以后查看。
注意：
访问密钥和私有密钥对是私钥的唯一副本。客户必须安全地存放它们。重新生成新密钥会使现有密钥失效。 S3cmd 配置文件可识别访问密钥（通过门户界面接收），并帮助客户连接到 S3 存储桶。需要在客户的计算机上安装 AWS CLI 才能连接到 S3。
有关如何使用带有 s3cmd 的访问密钥和私有密钥从 S3 存储桶下载报告的信息，请参阅常见问题解答。
Google Cloud 存储
对于要发送到 GCS 的日志和报告，请选择 Google Cloud 存储。
位置
位置表示 Google Cloud 存储中用于保存日志和报告的存储分区。
IAM 密钥
当您选择“生成密钥文件”按钮时，Google 服务帐户密钥文件将下载到您的计算机上。
注意：
此密钥文件是私钥的唯一副本。记下您的服务帐户的电子邮件地址，并安全地存储服务帐户的私钥文件。重新生成新的密钥文件会使现有文件失效。
此密钥文件可与 gsutil 工具一起使用，从 GCS 存储桶下载日志和报告。有关如何使用密钥文件下载日志文件的详细信息，请参阅常见问题解答。
面向服务提供商和企业的 Radar 日志描述和报告
提供商的 Radar 日志
- 这些日志为基准测试合作伙伴提供 Radar 测量结果。
- 它们提供针对公共平台进行的所有测量，无论生成测量的页面如何。
- Radar 日志包括原始日志中可用字段的子集，其中包括一些匿名数据：客户端 IP /28、哈希 Referer MD5。
- 下面是 TSV 文件格式的平台 Radar 日志共享示例。
注意：
- NEM 永远不会公开完整的客户端 IP。相反，它公开了 /28。例如，IP 255.255.255.255 在报告中显示为 255.255.255.240/28。
- 客户的 GEO 信息是根据客户端的 IPv4 提取的，该信息更为详细。
日志说明
下面是 Radar 日志的列标题和说明。这些字段在输出文件中按以下顺序显示：
| 日志 | 说明 |
|---|---|
| 时间戳 | 这是请求的 UTC 时间，采用 YYYY-MM-DDTHH:MI:SSZ 格式。日志表中的实际值（向下到秒）分别四舍五入到小时/日表中最接近的小时 (2018-03-30T23:00:00Z) 或日 (2018-03-30T00:00:00Z)。在所有数据集中，时间戳始终采用 UTC 格式。 |
| 唯一节点 ID | 也称为缓存节点 ID。它是一个任意的值。通常是CDN边缘服务器返回的IP，以帮助CDN内部识别哪个服务器处理了特定请求。（空字符串）：来自不支持 UNI 检测的 Radar 客户端。0：用户代理不支持 UNI 检测所需的功能。1：客户端在 UNI 检测期间遇到错误，例如 HTTP 404 或其他不成功的响应。2：尝试了 UNI 检测，但导致错误。 |
| 提供商 ID | 正在测量的平台的内部 ID。 |
| 探测类型 | 所测量的探测类型（例如：1：HTTP 连接时间；0：HTTP 响应时间；14：HTTP 吞吐量等）。要表明该服务可用，请使用在允许的时间内成功返回的信息。 |
| 响应代码 | 测量结果。例如：0：成功，1：超时，4：错误。对于可用性计算，响应为 0（成功）的测量值与测量总数（总数，不管响应如何）的百分比。对于其他探测类型（RTT 和吞吐量），在计算 RTT 的统计数据时，过滤器只能考虑成功码为 0 的 RTT 数据点。吞吐量相同。 |
| 测量值 | 记录的测量值，其含义因探头类型而异。它以毫秒为单位表示可用性 (1) /响应时间 (0) 测量值，以 kbps 为单位表示吞吐量 (14)。 |
| 解析器市场 | 处理请求的 DNS 解析器的市场。通常是 DNS 解析器所在的大陆，其中 0：未知 (XX)，1：北美 (NA) 5：非洲 (AF)，3：欧洲 (EU)，4：亚洲 (AS)，2：大洋洲 (OC)，6：南美洲 (SA)。 |
| 解析器国家/地区 | 处理 request.IDs 的 DNS 解析器所在的国家/地区可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/countries.json.gz |
| 解析器区域 | 处理 request.IDs 的 DNS 解析器所在的区域可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/regions.json.gz 注意： 并非世界上所有国家/地区都定义了区域。 |
| 解析器状态 | 处理 request.IDs 的 DNS 解析器的状态可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/states.json.gz 注意：并非世界上所有国家/地区都定义了状态。 |
| 解析器城市 | 处理 request.Resolver 城市的 DNS 解析器所在的城市是通过查找解析器 IP 地址来添加的。ID 可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/cities.json.gz |
| 解析器 ASN | 处理请求的 DNS 解析器的自治系统编号 (ASN)。通常情况下，具有 DNS 解析器 ID 的 ASN 可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/asns.json.gz |
| 解析器 IP | 我们的基础结构从中接收 DNS 请求的 DNS 解析器的 IP 地址。 |
| 客户市场 | 生成此度量的最终用户市场。通常是客户端 IP 所在的大陆；其中，0：未知 (XX)，1：北美 (NA) 5：非洲 (AF)，3：欧洲 (EU)，4：亚洲 (AS)，2：大洋洲 (OC)，6：南美洲 (SA)。 |
| 客户国家/地区 | 生成此 measurement.IDs 的最终用户所在的国家/地区可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/countries.json.gz |
| 客户区域 | 生成此测量的最终用户区域。通常为客户端 IP 所在的地理区域。可以将 ID 映射到以下位置下的名称：https://community-radar.citrix.com/ref/regions.json.gz 注意：并非世界上所有国家/地区都定义了区域。 |
| 客户状态 | 生成此测量的最终用户的状态。通常为客户端 IP 所在的省/自治区/直辖市。可以将 ID 映射到以下位置下的名称：https://community-radar.citrix.com/ref/states.json.gz 注意：并非世界上所有国家/地区都定义了状态。 |
| 客户城市 | 生成此测量的最终用户所在的城市。通常为客户端 IP 所在的城市。可以将 ID 映射到以下位置下的名称：https://community-radar.citrix.com/ref/cities.json.gz |
| 客户端 ASN | 生成此测量值的最终用户的自治系统编号 (ASN)。通常为包含客户端 IP 的 ASN。可以将 ID 映射到以下位置下的名称：https://community-radar.citrix.com/ref/asns.json.gz |
| 客户端 IP | 生成此测量的最终用户的 IP。 |
| Referer 主机 MD5 | Referer 信息（协议、主机和路径）来自 Radar HTTP 请求的 Referer 标头。Referer 主机 MD5 经过哈希处理。 |
| 用户代理 | 这是托管标签的浏览器页面中的用户代理字符串。例如，如果您使用 Chrome 浏览带有 Radar 标签的网页，则后台的 测Radar 量值会记录您的 Chrome 浏览器中的用户代理。这些衡量标准包括 Chrome 浏览器、Chrome 版本、有关运行 Chrome 的操作系统的信息等。 |
| DNS 查找时间（可选） | 使用资源计时 API，计算域名查找结束和域名查找开始之间的差异。它计算两个值均不为 null 且结束时间大于开始时间的情况。它的计算方式为 domainLookupEnd - domainLookupStart。 |
| TCP 连接时间（可选） | 使用资源计时 API，计算连接端和连接启动之间的差异。它计算两个值均不为 null 且结束时间大于开始时间的情况。它的计算方式为 connectEnd - connectStart。 |
| 安全连接时间（可选） | 使用资源计时 API，计算连接端和安全连接启动之间的差异。它计算两个值均不为 null 且结束时间大于开始时间的情况。它的计算方式为 connectEnd - secureConnectionStart。 |
| 延迟（可选） | 使用资源计时 API，可以计算响应开始和请求启动之间的差异。它计算两个值均不为 null 且响应开始时间大于请求开始时间的情况。它的计算方式为 responseStart - requestStart |
| 下载时间（可选） | 使用资源计时 API，计算响应结束和响应开始之间的差异。它计算两个值均不为 null 且结束时间大于开始时间的情况。它的计算方式为 responseEnd - responseStart。 |
| 客户配置文件 | 此字段有助于识别数据是来自移动应用程序还是浏览器。它还允许我们区分 iOS、Android 应用程序和浏览器。数字用于标识每个客户配置文件。此字段的值为：null、0、1、2、3、4。其中，null：通常表示不支持发送 client_profile 值的较旧的 Radar 客户端。0：浏览器；1：iOS-用 Swift 编写的 iOS 版 Radar runner 应用程序；2：Android；3：移动版网站上的浏览器；4：iOS-用 Objective-C 编写的 iOS 版 Radar Runner 应用程序。 |
| 客户配置文件版本 | 客户端配置文件版本告诉我们在移动应用程序中使用了哪个版本的 Radar Runner 代码（适用于 iOS）或 AndroidRadar SDK（适用于 Android）。此字段仅供内部使用。 |
| 设备类别 | 所有设备都分为以下其中一种：智能手机、平板电脑、PC、智能电视及其他。如果解析器无法确定任何字段的值，则使用“其他”作为默认值。 |
| 设备 | 用户使用的设备类型，例如 Apple iPhone。用户代理字符串从托管 Radar 标签的页面上运行的浏览器中检测到它。 |
| 浏览器 | 用户正在使用的浏览器类型，例如移动浏览器 UI/WKWebView 0.0.0。用户代理字符串从托管 Radar 标签的页面上运行的浏览器中检测到它。 |
| 操作系统 | 使用的操作系统。例如，iOS 11.0.3。用户代理字符串从托管 Radar 标签的页面上运行的浏览器中检测到它。 |
| 举报客户端 IP | 此 IP 是进行测量的用户的屏蔽 /48 公有 IP。它可以是 IPv4 或 IPv6 (如果支持)。 |
导航计时日志说明
导航计时数据
导航计时数据提供了对网页页面加载过程各个部分的见解。
这些数据因最终用户的位置、网络问题、提供商所做的更改等原因而有所不同。客户可以使用导航计时数据来优化最终用户在加载受监视网页时的体验。
可以对每个 Radar 会话进行测量（如果启用）。每个会话都附有一个 ID 号，有助于跟踪会话中的所有测量。这些测量结果通过 NEM 作为导航定时日志与客户共享。
下面是 TSV 文件格式的导航计时数据示例。
下面是导航计时日志的列标题和说明。这些字段在输出文件中按以下顺序显示：
| 日志 | 说明 |
|---|---|
| 时间戳 | 现在是 YYYY-MM-DDTHH:MI:SSZ 格式的请求的 UTC 时间。日志表中的实际值（向下到秒）分别四舍五入到小时/日表中最接近的小时 (2018-03-30T23:00:00Z) 或日 (2018-03-30T00:00:00Z)。在所有数据集中，它始终采用 UTC 格式。 |
| 响应代码 | 测量结果。例如：0：成功，1：超时，4：错误。对于可用性计算，响应为 0（成功）的测量值与测量总数（总计）的百分比。对于其他探测类型（RTT 和吞吐量），在计算 RTT 的统计数据时，过滤器仅考虑成功码为 0 的 RTT 数据点。吞吐量相同。 |
| 解析器市场 | 处理请求的 DNS 解析器的市场。通常是 DNS 解析器所在的大陆，其中 0：未知 (XX)，1：北美 (NA) 5：非洲 (AF)，3：欧洲 (EU)，4：亚洲 (AS)，2：大洋洲 (OC)，6：南美洲 (SA)。 |
| 解析器国家/地区 | 处理 request.IDs 的 DNS 解析器所在的国家/地区可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/countries.json.gz |
| 解析器区域 | 处理 request.IDs 的 DNS 解析器所在的区域可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/regions.json.gz。并非世界上所有国家/地区都定义了区域。 |
| 解析器状态 | 处理 request.IDs 的 DNS 解析器的状态可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/states.json.gz。并非世界上所有国家/地区都定义了州。 |
| 解析器 ASN | 处理请求的 DNS 解析器的自治系统编号 (ASN)。通常是具有 DNS 解析器的 ASN。可以将 ID 映射到以下位置下的名称：https://community-radar.citrix.com/ref/asns.json.gz |
| 解析器 IP | 我们的基础结构从中接收 DNS 请求的 DNS 解析器的 IP 地址。 |
| 客户市场 | 生成此度量的最终用户市场。通常是客户端 IP 所在的大陆；其中，0：未知 (XX)，1：北美 (NA) 5：非洲 (AF)，3：欧洲 (EU)，4：亚洲 (AS)，2：大洋洲 (OC)，6：南美洲 (SA)。 |
| 客户国家/地区 | 生成此 measurement.IDs 的最终用户所在的国家/地区可以映射到以下位置下的名称：https://community-radar.citrix.com/ref/countries.json.gz |
| 客户区域 | 生成此测量的最终用户区域。通常是客户端 IP 所在的地理区域。可以将 ID 映射到以下位置下的名称：https://community-radar.citrix.com/ref/regions.json.gz。并非世界上所有国家/地区都定义了区域。 |
| 客户状态 | 生成此测量的最终用户的状态。通常是客户端 IP 所在的状态。可以将 ID 映射到以下位置下的名称：https://community-radar.citrix.com/ref/states.json.gz。并非世界上所有国家/地区都定义了州。 |
| 客户端 ASN | 生成此测量值的最终用户的自治系统编号 (ASN)。通常是具有客户端 IP 的 ASN。可以将 ID 映射到以下位置下的名称：https://community-radar.citrix.com/ref/asns.json.gz |
| 客户端 IP | 生成测量的最终用户的 IP。 |
| Referer 主机 | Referer 信息（协议、主机和路径）来自 Radar HTTP 请求的 Referer 标头。 |
| Referer 协议 | Referer 信息（协议、主机和路径）来自 Radar HTTP 请求的 Referer 标头。 |
| Referer 路径 | Referer 信息（协议、主机和路径）来自 Radar HTTP 请求的 Referer 标头。 |
| 设备类别 | 所有设备都分为以下其中一种：智能手机、平板电脑、PC、智能电视及其他。如果解析器无法确定任何字段的值，则使用“其他”作为默认值。 |
| 设备 | 用户使用的设备类型，例如 Apple iPhone。用户代理字符串从托管 Radar 标签的页面上运行的浏览器中检测到它。 |
| 浏览器 | 用户正在使用的浏览器类型，例如移动浏览器 UI/WKWebView 0.0.0。用户代理字符串从托管 Radar 标签的页面上运行的浏览器中检测到它。 |
| 操作系统 | 正在使用的操作系统，例如 iOS 11.0.3。用户代理字符串从托管 Radar 标签的页面上运行的浏览器中检测到它。 |
| DNS 查找时间 | 使用资源计时 API，计算域名查找结束和域名查找开始之间的差异。它计算两个值均不为 null 且结束时间大于开始时间的情况。它的计算方式为 domainLookupEnd - domainLookupStart。 |
| TCP 连接时间 | 使用资源计时 API，计算连接端和连接启动之间的差异。它计算两个值均不为 null 且结束时间大于开始时间的情况。它的计算方式为 connectEnd - connectStart。 |
| 安全连接时间 | 使用资源计时 API，计算连接端和安全连接启动之间的差异。它计算两个值均不为 null 且结束时间大于开始时间的情况。它的计算方式为 connectEnd - secureConnectionStart。 |
| 加载事件 | 这是从加载事件的开始到结束所花费的持续时间或时间。当两个值都不为空且结束时间大于开始时间时，它的计算方式为 LoadEventEnd - LoadEventStart。 |
| 重定向 | 这是从“导航开始”到“开始获取”所花费的持续时间或时间。当两个值都不为空且结束时间大于开始时间时，它的计算方式为 FetchStart - NavigationStart。 |
| 页面总加载量 | 这是从导航开始到页面加载事件结束所花费的持续时间或时间。当两个值均不为空且结束时间大于开始时间时，其计算方式为 - Load Event End - Navigation Start。 |
| DOM | 从 DOM 加载到 DOM 完成所需的持续时间或时间。当两个值都不为空且结束时间大于开始时间时，其计算方式为 DomComplete - DomLoading。 |
| 延迟 | 使用资源计时 API，可以计算响应开始和请求启动之间的差异。它计算两个值均不为 null 且响应开始时间大于请求开始时间的情况。它的计算方式为 responseStart - requestStart |
| 下载时间 | 使用资源计时 API，计算响应结束和响应开始之间的差异。它计算两个值均不为 null 且结束时间大于开始时间的情况。它的计算方式为 responseEnd - responseStart。 |
| 交互式 DOM | 从导航开始到 DOM 交互式所需的持续时间或时间。当两个值都不为空且结束时间大于开始时间时，它被计算为 DomInteractive - NavigationStart。 |
| 开始渲染 | 从导航开始到开始渲染所需的持续时间或时间。当两个值都不为空且结束时间大于开始时间时，它将计算为 startRender - NavigationStart。 |
Openmix和 HTTP Openmix日志
Openmix 和 HTTP Openmix 日志允许客户使用实时测量来监视其 Openmix 应用程序的行为。他们可以使用这些数据来查找需要改进的领域或验证其应用程序的预期性能。
- 这些日志为 Openmix 客户提供了实时测量结果。
- 这些日志的推荐文件格式为 JSON，但也有 TSV 格式。
- 下面是 TSV 文件格式的 Openmix 和 HTTP Openmix 日志共享数据的示例。
Openmix 日志说明
| 日志 | 说明 |
|---|---|
| 时间戳 | 现在是 YYYY-MM-DDTHH:MI:SSZ 格式的请求的 UTC 时间。日志表中的实际值（向下到秒）分别四舍五入到小时/日表中最接近的小时 (2018-03-30T23:00:00Z) 或日 (2018-03-30T00:00:00Z)。在所有数据集中，时间戳始终采用 UTC 格式。 |
| 应用程序所有者区域 ID | 为请求提供服务的应用程序所有者的区域 ID。此值始终等于 1。 |
| 应用程序所有者客户 ID | 为请求提供服务的应用程序所有者的客户 ID。对于 HTTP 请求，请在请求路径中编码此 ID，然后使用它来查找要运行的应用程序。 |
| 应用程序 ID | 客户帐户中为请求提供服务的应用程序 ID。此 ID 也编码在 HTTP 请求路径中。应用程序 ID 从 1 开始，并且仅对客户是唯一的。您必须通过在 appOwnerCustomerId 上进行查询来完全限定特定应用程序 ID 的查询。 |
| 应用程序版本 | 为帐户提供服务的应用程序的版本。每次通过门户或 API 更新应用程序时，版本都会递增。记录请求时正在运行的版本。随着应用程序的更新，此信息可用于分隔一段时间的版本化逻辑。网络中的主机通常会在相似的时间范围内收到更新，但几乎不会在同一时刻收到更新。在更新过程中，时间上的重叠决策可能会使用不同版本的应用程序。 |
| 应用程序名称 | 为帐户提供服务的应用程序的名称。 |
| 市场 | 生成此度量的最终用户市场。 |
| 国家/地区 | 生成此度量的最终用户所在的国家/地区。 |
| 地理区域 | 生成此测量的最终用户区域。 |
| 状态 | 生成此测量的最终用户的状态。 |
| ASN ID | 生成此测量值的最终用户的自治系统编号 (ASN)。通常是具有客户端 IP 的自治系统编号。 |
| ASN 名称 | 生成测量的最终用户的 ASN 的名称。 |
| 有效的 IP | 有效 IP 是用于处理请求的 IP。它是查询字符串指定的 IP 覆盖请求的 IP（相对 DNS 流的解析器/ECS/EDNS ID）。这是系统在处理信息时将其视为目标的地址。此 IP 可以是请求解析器的 IP，或者是客户端的 ECS IP 地址（如果支持 EDNS ECS）。因此，传递给应用程序逻辑的所有探测性能数据、地理信息等都基于此 IP。 |
| 解析器市场 | 处理请求的 DNS 解析器的市场。 |
| 解析器国家/地区 | 处理请求的 DNS 解析器所在的国家/地区。 |
| 解析器区域 | 处理请求的 DNS 解析器所在的区域。 |
| 解析器状态 | 处理请求的 DNS 解析器的状态。 |
| 解析器 ASN ID | 处理请求的 DNS 解析器的自治系统编号 (ASN)。通常是具有 DNS 解析器的自治系统编号。 |
| 解析器 ASN 名称 | 处理请求的解析器的 ASN 名称。 |
| 解析器 IP | 我们的基础结构从中接收 DNS 请求的 DNS 解析器的 IP 地址。 |
| 决策提供商名称 | 应用程序选择的平台的别名。 |
| 原因代码 | 在应用程序中设置的原因代码，说明决策背后的原因。 |
| 原因日志 | 此日志是来自 Openmix 应用程序的客户定义输出。这是一个可选的字符串字段，使客户能够记录有关其 Openmix 应用程序决策的信息。 |
| 回退模式 | 此模式指示应用程序在处理请求时是否处于回退模式。在准备执行请求过程中出现故障时，会发生回退。 |
| 使用的 EDNS | 如果应用程序使用 EDNS 客户端子网扩展，则为 true。 |
| TTL | 交还的 TTL（生存时间）。 |
| 回应 | 请求返回的 CNAME。 |
| 结果 | 此字段中的值始终为 1。 |
| 上下文 | 这是 Openmix 在处理请求时可用 Radar 数据的摘要。Openmix 会根据每个请求的有效值解析 Radar 数据，因此同时发出请求的两个客户端可以具有不同的上下文字符串。 |
开放式 HTTP API 日志说明
| 日志 | 说明 |
|---|---|
| 时间戳 | 现在是 YYYY-MM-DDTHH:MI:SSZ 格式的请求的 UTC 时间。日志表中的实际值（向下到秒）分别四舍五入到小时/日表中最接近的小时 (2018-03-30T23:00:00Z) 或日 (2018-03-30T00:00:00Z)。在所有数据集中，时间戳始终采用 UTC 格式。 |
| 应用程序所有者区域 ID | 为请求提供服务的应用程序所有者的区域 ID。此值始终等于 1。 |
| 应用程序所有者客户 ID | 为请求提供服务的应用程序所有者的客户 ID。对于 HTTP 请求，请在请求路径中编码此 ID，用于查找要运行的应用程序。 |
| 应用程序 ID | 客户帐户中为请求提供服务的应用程序 ID。此 ID 也编码在 HTTP 请求路径中。应用程序 ID 从 1 开始，并且仅对客户是唯一的。您必须通过在 appOwnerCustomerId 上进行查询来完全限定特定应用程序 ID 的查询。 |
| 应用程序版本 | 为帐户提供服务的应用程序的版本。每次通过门户或 API 更新应用程序时，版本都会递增。记录请求时正在运行的版本。随着应用程序的更新，此信息可用于分隔一段时间的版本化逻辑。网络中的主机通常会在相似的时间范围内收到更新，但几乎不会在同一时刻收到更新。在更新过程中，时间上的重叠决策可能会使用不同版本的应用程序。 |
| 应用程序名称 | 为帐户提供服务的应用程序的名称。 |
| 市场 | 生成此度量的最终用户市场。 |
| 国家/地区 | 生成此度量的最终用户所在的国家/地区。 |
| 地理区域 | 生成此测量的最终用户区域。 |
| 状态 | 生成此测量的最终用户的状态。 |
| ASN ID | 生成此测量结果的最终用户的自治系统编号 (ASN) 的 ID，即与 ASN 名称关联的网络 ID 号 |
| ASN 名称 | 生成测量的最终用户的 ASN 的名称。 |
| 有效的 IP | 有效 IP 是用于处理请求的 IP。它是查询字符串指定的 IP 覆盖请求的 IP（相对 DNS 流的解析器/ECS/EDNS ID）。这是系统在处理信息时将其视为目标的地址。此 IP 可以是请求解析器的 IP，或者是客户端的 ECS IP 地址（如果支持 EDNS ECS）。传递给应用程序逻辑的所有探测性能数据、地理信息等都基于此 IP。 |
| 决策提供商名称 | 应用程序选择的平台的别名。 |
| 原因代码 | 在应用程序中设置的原因代码，说明决策背后的原因。 |
| 原因日志 | 此日志是来自 Openmix 应用程序的客户定义输出。这是一个可选的字符串字段，使客户能够记录有关其 Openmix 应用程序决策的信息。 |
| 回退模式 | 此模式指示应用程序在处理请求时是否处于回退模式。在准备执行请求过程中出现故障时，会发生回退。 |
| 响应代码 | 测量结果。例如：0：成功，1：超时，4：错误。对于可用性计算，响应为 0（成功）的测量值与测量总数（总数，不管响应如何）的百分比。对于其他探测类型（RTT 和吞吐量），在计算 RTT 的统计数据时，过滤器只能考虑成功码为 0 的 RTT 数据点。吞吐量相同。 |
| HTTP 方法 | HTTP 方法（GET/POST/OPTIONS/等）与客户服务向 HTTP Openmix 服务器发出的请求有关。这些方法共同构成了入站 URL 和出站 HTTP 响应的一部分。 |
| URI | 这是请求路径。如果客户没有得到他们想要的行为，那可能是因为请求结构不当。日志显示了我们的服务器正在接收的内容（协议、主机和路径）。Referer 信息（协议、主机和路径）来自 Radar HTTP 请求的 Referer 标头。对于 HTTP OPX，整个 Referer（协议、主机和路径）包含在一个标有 Referer 的字符串中。 |
| 用户代理 | 这是托管标签的浏览器页面中的用户代理字符串。例如，如果您使用 Chrome 浏览带有 Radar 标签的网页，则后台的 测Radar 量值会记录您的 Chrome 浏览器中的用户代理。这些衡量标准包括 Chrome 浏览器、Chrome 版本、有关运行 Chrome 的操作系统的信息等。 |
| 上下文 | 这是 Openmix 在处理请求时可用 Radar 数据的摘要。Openmix 会根据每个请求的有效值解析 Radar 数据，因此同时发出请求的两个客户端可以具有不同的上下文字符串。 |
针对第三方组织的自定义报告
客户可以与 NetScaler 合作，根据 NetScaler 收集的 Radar 数据获取自定义报告。NetScaler 可以生成按计划运行的报告。报告以数据文件的形式提供，通常采用 TSV 格式。
常见问题解答
Radar
文件推送到 S3 和 GCS 的频率有多高
Radar 的文件存放频率为每分钟一次，报告的存档频率为每天。
报告存储在哪里
S3 旧版（位置 1）：
s3://public-radar/[customer name]/
S3（位置 2）：
s3://cedexis-netscope/[customer id]/
GCS（地点 3）：
gs://cedexis-netscope-[customer id]/
如果您还没有S3访问凭据，如何获得它们
该门户提供“访问”和“秘密”密钥。使用带有“s3cmd”、“awscli”或其他工具的密钥来访问 S3。对于 Google 存储，门户网站会下载一个带有访问凭据的文件，以便与“gsutil”工具配合使用。
如何将访问密钥和私有密钥与 s3cmd 一起使用来从 S3 存储桶下载日志和报告
首先，您需要从 https://s3tools.org/download 中下载并安装 s3cmd，有关用法 、选项和命令，请参阅 https://s3tools.org/usage。然后运行以下命令：
s3cmd --access_key=[access key] --secret_key=[secret key] ls s3://cedexis-netscope/<customer id>/radar/
<!--NeedCopy-->
要下载文件，请运行以下命令：
s3cmd --access_key=[access_key] --secret_key=[secret_key] get s3://cedexis-netscope/<customer id>/radar/[the_filename_to_download] [the_name_of_the_local_file]
<!--NeedCopy-->
如何使用 s3cmd 配置列出 S3 存储桶中的文件
第一步是安装 s3cmd。可以从 http://s3tools.org/download 进行安装
要配置 s3cmd，请运行以下命令
s3cmd ls s3://cedexis-netscope/[customer id]/
<!--NeedCopy-->
如果您已经使用了另s3cmd 一组访问密钥和私有密钥，请按照下列步骤操作：
如果您已经在使用 s3cmd，则在 ~/.s3cfg 下创建默认配置的副本。例如，制作一个副本并将其命名为 ~/.s3cfg_netscope。将 ~/.s3cfg_netscope 中的访问和私钥条目替换为我们提供的条目。
使用新配置，而不是默认配置（贵公司的）通过以下命令访问 S3 存储桶：
s3cmd -c ~/.s3cfg_netscope ls s3://cedexis-netscope/[customer id]/
<!--NeedCopy-->
主要区别在于您必须通过 NetScaler 提供的访问权限和密钥将其放置在 -c 中以及配置文件所在的位置。
如果要在多组密钥之间切换，请将它们嵌入到文件中。请参阅带有 -c 选项的文件以指定您正在使用的密钥对。
注意：
-c参数指示包含访问密钥和私有密钥的配置文件的位置。
如何将密钥文件与 gsutil 或 gcloud 一起使用来下载日志文件
下载谷歌服务帐户JSON密钥文件后，您可以使用它来验证您的Google帐户凭据，查看或下载日志文件。例如，以下是使用 Google gcloud 和 gsutil 命令行实用程序来实现此目标的一种方法：
步骤 1：激活密钥文件
验证命令 gcloud auth activate- 或 gsutil config -e 是验证运行 gcloud 或 gsutil 命令的密钥文件所必需的。
对于 gcloud：
使用下载的密钥文件运行以下命令：
gcloud auth activate-service-account --key-file [downloaded config file]
<!--NeedCopy-->
或
gcloud auth activate-service-account --key-file=[path and file name of key file]
<!--NeedCopy-->
对于 gsutil：
使用下载的配置文件运行以下命令：
gsutil config -e
<!--NeedCopy-->
步骤 2：列出 GCS（Google 云存储）存储桶中的文件
按前面步骤所述激活服务帐户密钥文件后，使用以下命令列出 GCS 存储桶中的文件：
gsutil ls gs://cedexis-netscope-<customer id>
<!--NeedCopy-->
步骤 3（如有必要）：还原原始凭据（或在帐户之间来回切换）
您可以通过执行以下操作在 NetScaler ITM 帐户与您已通过身份验证的其他 Google Cloud 凭据之间切换。
首先，运行以下命令列出所有帐户：
gcloud auth list
<!--NeedCopy-->
然后使用以下命令切换到另一个帐户：
gcloud config set account [email of the account to switch to as shown in gcloud auth list]
<!--NeedCopy-->
您可以使用相同的命令在帐户之间来回切换，方法是将电子邮件替换为要切换到的帐户邮箱。
文件名是什么样子
传统日报：
Radar 每日日志 ShareFile 名称具有以下结构：
<prefix><date: YYYY-MM-DD>.<customer_id>.part<uniq_id>.kr.txt.gz
例如Cedexis_Daily-2017-11-07.21222.part-cc901e1dd55eal4e.kr.txt.gz （非标准示例）
传统实时：
Radar 实时日志 ShareFile 名称具有以下结构：
<prefix><customer_id>-YYYY-MM-DDTHH:MM<uniq_id>.txt.gz
例如 Cedexis_3-32291-2017-11-08T20:56-cc907e8fd71eaf4e.txt.gz
Netscope NEM 格式：
用于每日和实时日志共享文件的 Netscope NEM 格式具有以下结构：
<freq><log_type><prefix><id_type><id><iso_dt><uniq_id>.<line_format>.gz
其中，
-
freq:"daily" | "rt" | "hr" -
log_type:"radar" | "opx" | "hopx" -
prefix:log_share.prefix -
id_type:"customer" | "provider" | "asn" -
id:log_share.match_id -
iso_dt:iso 8601 Date_time "YYYYMMDDTHHMMSSZ" -
uniq_id:hash(UUID) -
line_format:"tsv" | "json"
例如 rt-radar-TestRadar1-provider-20363-20171209183034Z-cc907e8fd71eaf4e.tsv.gz
输出文件的格式是什么
对于 Radar，输出文件格式为 TSV（制表符分隔值），采用压缩格式。
开放混合和 Openmix HTTP API
文件推送到 S3 的频率有多高
文件存放的频率是 Openmix 和 HTTP Openmix 每分钟的存放次数。
如果您看不到配置 Openmix 和 Openmix HTTP API 实时日志共享的选项，该怎么办
您的客户经理可以启用所需的角色来配置和启用 Openmix 和 Openmix HTTP API 实时日志共享。
您如何开启 Openmix 和 Openmix HTTP API 实时日志共享和访问文件
在您的帐户上启用该角色后，您会看到“管理日志”图标。单击以打开“日志”对话框，您可以在其中访问 Openmix 日志配置设置。这些设置基本上就是开启 Openmix 和 HTTP Openmix 实时日志共享和访问文件所需的全部设置。
什么是后端流程
启用 Openmix 日志共享也可以启用 Openmix HTTP API 日志共享。Openmix 和 Openmix HTTP API 日志共享服务必须在 10 分钟内开始为客户输出日志。
Openmix 和 HTTP Openmix 报告存储在哪里
S3 旧版（位置 1）：
s3://logshare/[zone ID]/[customer ID]/logs/openmix/json/[YYYY]/[MM]/[DD]/[HH]/.
S3（位置 2）：
s3://cedexis-netscope/[customer id]/
GCS（地点 3）：
gs://cedexis-netscope-[customer id]/
文件名是什么样子
Openmix 和 HTTP Openmix 的文件名结构通常如下所示：
传统实时：
[zone ID, 1][customerID]-openmix-json[YYYY][MM][DD][HH][mm][ss]Z-m1-w9-c0.gz
Netscope NEM 格式：
用于每日和实时日志共享文件的 Netscope NEM 格式具有以下结构：
<freq><log_type><prefix><id_type><id><iso_dt><uniq_id>.<line_format>.gz
其中，
-
freq:"daily" | "rt" | "hr" -
log_type:"radar" | "opx" | "hopx" -
prefix:log_share.prefix -
id_type:"customer" | "provider" | "asn" -
idv:log_share.match_id -
iso_dt:iso 8601 Date_time "YYYYMMDDTHHMMSSZ" -
uniq_id:hash(UUID) -
line_format:"tsv" | "json"
例如 hr-opx-TestOpenmix1-provider-20363-20171209183034Z-cc907e8fd71eaf4e.tsv.gz
什么是输出文件格式
Openmix 和 Openmix HTTP API 的文件格式为 JSON（gzipped）。