本示例使用 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 令牌。 ↩