此示例使用 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 表示隧道运行正常。
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
#=> }-
有关详细信息,请参阅配置 Analytics API 令牌。 ↩