阿里云首页 API 网关

通过日志服务查看API调用日志

API网关日志服务实现无缝集成,通过日志服务您可以进行实时日志查询、下载、多维度统计分析等,您也可以将日志投递到OSS或者MaxCompute

1 功能简介

1.1 日志在线查询

可根据日志中任意关键字进行快速的精确、模糊检索,可用于问题定位或者统计查询。

1.2 详细调用日志

您可以检索API调用的详细日志包含如下表所示字段。其中:requestQueryString,requestHeaders, requestBody, responseHeaders, responseBody 几个字段只有VPC专享实例支持,且需要在分组详情页面配置后支持。

日志项

描述

apiGroupUid

API的分组ID

apiGroupName

API分组名称

apiUid

API的ID

apiName

API名称

apiStageUid

API环境ID

apiStageName

API环境名称

httpMethod

调用的HTTP方法

path

请求的PATH

domain

调用的域名

statusCode

HttpStatusCode

errorMessage

错误信息

appId

调用者应用ID

appName

调用者应用名称

clientIp

调用者客户端IP

exception

后端返回的具体错信息

providerAliUid

API提供者帐户ID

region

区域,如:cn-hangzhou

requestHandleTime

请求时间,UTC

requestId

请求ID,全局唯一

requestSize

请求大小,单位:字节

responseSize

返回数据大小,单位:字节

serviceLatency

访问后端资源耗时总和,包括申请连接资源耗时,建立连接耗时,调用后端服务耗时,单位:毫秒

errorCode

错误码code,如:X500ER

requestProtocol

客户端请求协议:HTTP/HTTPS/WS

instanceId

API服务所在的网关实例ID

initialRequestId

API网关自调用时,例如API-1调用API-2 ,那么API-2的日志中会用initialRequestId来记录API-1的requestid。

clientNonce

客户端X-Ca-Nonce头

requestQueryString

客户端请求的queryString

requestHeaders

客户端请求的header内容

requestBody

客户端请求的body内容,最多1024个字节

responseHeaders

API响应的header内容

responseBody

API响应的response内容,最多1024个

consumerAppKey

API请求的appKey

totalLatency

API请求的总延迟,单位毫秒

customTraceId

全链路日志的traceId

2 使用日志服务查看API日志

2.1 配置日志服务

目前有2种配置方式:1)通过日志服务页面的“日志审计”进行API网关日志同步。这种方式所有region的日志都会集中到日志审计这个project下。API网关上不需要做额外的配置。2)通过sls页面做API网关数据接入的方式配置,这种方式每个region都需要做一次同步配置。下面将分别介绍这两种配置方法。

政务云和金融云的SLS日志同步,目前仅支持用第1种方法配置。

2.1.1 通过日志审计方式配置

1)打开sls日志审计服务配置页面,选择中心region,根据自己需要选择对应的region就行,后续所有的API网关日志都会投递到这个region。

然后选择以上2种方式之一做授权,根据文档提示操作。文示例选择“手动授权”,参考链接 手动授权日志采集与同步

授权完成后,根据本页面的中心project下的apigateway_log查看API网关的调用日志。

2.1.2 在API网关控制台配置

1)请确保您已经开通了日志服务,然后在SLS控制台选择对应的region,创建Project 和 Logstore。以华东1 region为例。

2)配置API网关数据接入,选择API网关产品

然后一直“下一步”,至成功为止。

2.2 查看日志

您可以登录日志服务控制台查看日志,根据日志服务的查询语法,在线检索调用日志。

2.3 查看预定义报表

API网关为了方便用户统计查询,在系统中预置了一些报表统计。包括:请求量大小、成功率、错误率、延时情况、调用API的APP数量,错误情况统计、TOP 分组、TOP API、Top 延迟等等。您可以进入配置后的SLS的logstore,点开logstore详情->可视化仪表盘 查看预定义报表 gateway_log_apigateway访问日志

2.4 自定义查询报表

您可以根据自身业务需要自定义查询报表,请参照定义方法:仪表盘

首页 API 网关 运维监控 通过日志服务查看API调用日志