跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

使用 GraphQL 查询 Cloudflare WAN IPsec/GRE 隧道运行状况检查结果

最后更新 查看 MarkdownAgent 设置

此示例使用 GraphQL Analytics API 查询 Cloudflare WAN 隧道健康检查结果。这些结果由 Cloudflare 服务器针对你在账户中配置的隧道执行的各项健康检查汇总而成。你可以查询过去三个月内任意日期最多一周的数据。

以下 API 调用请求特定 Cloudflare 数据中心在一天内针对特定账户执行的隧道健康检查,并输出请求的字段。请将 <CLOUDFLARE_ACCOUNT_TAG> 和 <API_TOKEN>1 替换为你的 API 凭据,并根据需要调整 datetimeStart 和 datetimeEnd 变量。

API 调用按 Cloudflare 数据中心返回隧道健康检查结果。Cloudflare 根据各个服务器执行的健康检查汇总每个数据中心的结果。tunnelState 字段表示隧道状态。Cloudflare WAN 使用这些状态进行路由。tunnelState 值为 0 表示隧道关闭,0.5 表示隧道性能下降,1 表示隧道运行正常。

API 调用

echo '{ "query":
  "query GetTunnelHealthCheckResults($accountTag: string, $datetimeStart: string, $datetimeEnd: string) {
    viewer {
      accounts(filter: {accountTag: $accountTag}) {
        magicTransitTunnelHealthChecksAdaptiveGroups(
          limit: 100,
          filter: {
            datetime_geq: $datetimeStart,
            datetime_lt:  $datetimeEnd,
          }
        ) {
          avg {
            tunnelState
          }
          dimensions {
            tunnelName
            edgeColoName
          }
        }
      }
    }
  }",
  "variables": {
    "accountTag": "<CLOUDFLARE_ACCOUNT_TAG>",
    "datetimeStart": "2022-08-04T00:00:00.000Z",
    "datetimeEnd": "2022-08-04T01:00:00.000Z"
  }
}' | tr -d '\n' | curl --silent \
https://api.cloudflare.com/client/v4/graphql \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data @-

结果按请求以 JSON 返回,因此将输出通过管道传递给 jq 可对其进行格式化,以便解析,如以下示例所示:

... | curl --silent \
https://api.cloudflare.com/client/v4/graphql \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data @- | jq .

## Example response:
#=> {
#=>   "data": {
#=>     "viewer": {
#=>       "accounts": [
#=>         {
#=>           "conduitEdgeTunnelHealthChecks": [
#=>             {
#=>               {
#=>                 "avg": {
#=>                   "tunnelState": 1
#=>                 },
#=>                 "dimensions": {
#=>                   "edgeColoName": "mel01",
#=>                   "tunnelName": "tunnel_01",
#=>                   "tunnelState": 0.5
#=>                 }
#=>               },
#=>               {
#=>                 "avg": {
#=>                   "tunnelState": 0.5
#=>                 },
#=>                 "count": 310,
#=>                 "dimensions": {
#=>                   "edgeColoName": "mel01",
#=>                   "tunnelName": "tunnel_02",
#=>                   "tunnelState": 0.5
#=>                 }
#=>               }
#=>           ]
#=>         }
#=>       ]
#=>     }
#=>   },
#=>   "errors": null
#=> }

Footnotes

  1. 有关详细信息,请参阅配置 Analytics API 令牌。 ↩

这篇文档对您有帮助吗?